@masterpack/cli

Set up MasterPack in your app — one command. MasterPack is a marketplace where subscribers pay one monthly fee and makers get paid from real usage of their app.

npx -y @masterpack/cli init \
  --name "My App" \
  --url "https://myapp.example" \
  --tagline "One line that sells it." \
  --description "At least 40 characters describing what the app does." \
  --category Productivity

The CLI prints what it's about to do, registers your app, gives you a claim link to open in your browser, waits until you've claimed it, then writes credentials into .env.local and makes sure that file is gitignored.

Your API key is never printed. It goes straight into the env file, and the terminal shows only a masked prefix. Pass --print if you'd rather see the credentials and have no files written.

Commands

| Command | What it does | |---------|--------------| | init | register the app, wait for the browser claim, write credentials | | config --redirect-uri <url> | register your OAuth callback URL(s) | | submit | run the automated listing checks and go live | | status | show the app's current listing state |

Useful flags: --print, --env-file <path>, --no-gitignore, --yes, --base <url> (self-hosted or staging), --help, --version.

What gets written

# --- MasterPack ---
MASTERPACK_APP_ID=…
MASTERPACK_API_KEY=…          # secret — never commit
MASTERPACK_TEST_CLIENT_ID=…   # sandbox: no subscription, no payouts
MASTERPACK_LIVE_CLIENT_ID=…   # production
# --- end MasterPack ---

Next.js and Vite projects also get a browser-visible copy (NEXT_PUBLIC_… / VITE_…), starting on the sandbox id.

Then integrate @masterpack/sdk: full guide at https://masterpack.app/docs/integrate.md

License

MIT