@vibegameengine/shipit

Publish playable web games from the terminal.

Install

npm install -g @vibegameengine/shipit

Or run it with npx:

npx @vibegameengine/shipit --help

Flow

shipit login
shipit init
shipit version 1.0.1
shipit publish

Commands

shipit login

Stores your publish token locally.

Flags are optional for scripting or custom API hosts:

shipit --api-url https://your-api.example.com login --email [email protected] --password your-password

shipit init --id asteroids --title "Asteroids"

Creates .shipit/ in the current game project.

shipit version 1.0.1

Creates a version description template and marks it as the next version to publish.

shipit publish

Publishes the next version.

shipit publish 1.0.1

Publishes a specific version.

Project Files

Shipit expects a built game and a .shipit directory:

dist/
  index.html
.shipit/
  shipit.json
  media/
    tiles/
      16x9.png
      1x1.png
      9x16.png
  versions/
    1.0.1/
      description/
        en.md

description/*.md files are feed posts for the release. Each one can be up to 500 characters.

Validate

shipit validate

Checks the project before publishing.