# 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:

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

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

- `git.url`: where the code lives.
- `token`: your password for it. Keep it private.
- `app.url`: where the app is live.
- `claim.url`: open this in a browser to make the app yours with a real account.

## 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:

```sh
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

```sh
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:

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

Or open `/talk` and type it. What happens next is in [Tell the crew](guide-tell-the-crew.md).

If something does not work, see [When something is wrong](guide-when-wrong.md). The reference for the command is [CLI.md](CLI.md).

Every feature note, by topic: [the reference notes](features/README.md).
