@onesub/cli

Scaffolds a ready-to-run onesub server project.

npx @onesub/cli init my-onesub-server
cd my-onesub-server
cp .env.example .env
npm install
npm run dev

Or full stack (Postgres + server) in one command:

docker compose up

For local integration and lifecycle testing without Apple/Google credentials, start the fully mocked development server:

npx @onesub/cli dev --port 4100

It listens on port 4100 by default, enables Apple and Google mock providers, and prints the mock receipt scenarios, webhook URLs, and development admin secret at startup. Never use this mode for a production deployment.

What it generates

| File | Purpose | |------|---------| | server.ts | Express app with createOneSubMiddleware() wired up | | .env.example | Apple / Google / Postgres / admin placeholders | | docker-compose.yml | Postgres + server, schema auto-initialized from @onesub/server/sql/schema.sql | | package.json, tsconfig.json, .gitignore, README.md | Standard project shell |

That's it. No prompts, no interactive questionnaire — same scaffold every time, tweak it yourself afterward.

Commands

onesub init [directory]   Scaffold into <directory> (default: .)
onesub dev [--port N]     Start a fully mocked local server (default port: 4100)
onesub --help             Show help

MIT.