# Inkwell: first game

Complete CLI-only path:

1. Create an Inkwell account and choose a username. Request creator access from the account menu; Jungle is notified and approves the request. Check https://inkwell.ing/creator-access.
2. Install and authenticate:

```sh
npm install --global @silicon-jungle/inkwell-cli
inkwell login
inkwell whoami
inkwell doctor
```

3. Build a static browser game into `dist/`. It must contain `index.html`. Vite must use `base: './'`; runtime assets should use relative URLs.
4. Create the game and page media:

```sh
inkwell games create --game my-game --title "My Game" \
  --summary "A short public summary." --description-file GAME_PAGE.md \
  --tags action,multiplayer --visibility unlisted \
  --cover cover.png --screenshot screenshot.png
```

5. Configure and upload a draft:

```sh
inkwell init --game my-game --directory dist --engine web
npm run build
inkwell deploy
```

New configs use a readiness handshake. Load the SDK and call `Inkwell.ready()` when playable, or set `startup.mode` to `compatible` for an export without SDK integration.

6. Open the printed private preview URL. Then publish:

```sh
inkwell publish BUILD_ID
# Future release after preview: inkwell deploy --publish
# Optional public discovery:
inkwell games update --game my-game --visibility public
```

Private = owner/testers. Unlisted = playable by link, absent from discovery. Public = eligible for discovery after publication. Slugs cannot be changed.