@kickstartmvp/deploy

Deploy the current directory to KickStartMVP with one command.

KMV_TOKEN=<your token> npx @kickstartmvp/deploy

Get your token (inside a ready-made prompt for Claude Code or Codex) from your KickStartMVP dashboard.

What it does

• Packs the current directory (skipping node_modules, .git, etc.) and uploads it
• KickStartMVP builds it — static site, Node app, or Dockerfile — and runs it in its own container
• Prints your live URL when it's up
• Re-running updates the same app in place (it remembers via .kickstartmvp.json)

For AI agents

Add --json to get a single line of machine-readable output:

{ "status": "live", "url": "...", "errorType": null, "error": null, "hint": null, "logs": "..." }

Exits 0 only when the app is live. On failure, read error, hint, and logs, fix the code, and run the command again.

Environment variables

| Variable | Meaning | | --- | --- | | KMV_TOKEN | Your personal deploy token (required) | | KMV_APP_NAME | Name for a new app (optional) | | KMV_URL | API base, defaults to https://kickstartmvp.com |