Your first app in five minutes

You need a forge address (the link you were given) and a terminal with git and curl. No account is needed to start; you claim the app afterwards.

1. Start

Replace YOUR-FORGE with the forge's address and run:

curl -sX POST https://YOUR-FORGE/api/v1/start -d '{"name":"my-app"}'

The answer is a small JSON document. Four parts matter:

2. Get the code

Take git.url from the answer and put USER:TOKEN@ right after https://, where USER is user.username and TOKEN is token. Then clone it:

git clone https://USER:TOKEN@YOUR-FORGE/OWNER/my-app

(OWNER/my-app is the rest of git.url: copy it as it is.)

3. Change something and push

cd my-app
echo "hello" > NOTES.md
git add . && git commit -m "first change"
git push origin HEAD:main

The forge builds the app on every push to main. A few seconds later app.url shows it. Open it.

4. Make it yours

Open claim.url and choose a user name and password. The app and its token move to your account. An app nobody claims sleeps after 7 days and is archived after 30.

5. Tell the crew

With the forge's forge command installed and signed in, ask for a change in plain words:

forge tell "make the page say hello in big letters"

Or open /talk and type it. What happens next is in Tell the crew.

If something does not work, see When something is wrong. The reference for the command is CLI.md.

Every feature note, by topic: the reference notes.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs