Initialize a PropelKit SaaS project with AI PM
npm install create-propelkitInitialize a PropelKit SaaS project with AI PM.
``bash`
npx create-propelkitor
npm init propelkitor
npx propelkit init
1. Detects installed CLIs - Checks for Claude Code (required), Supabase CLI, and GitHub CLI
2. Asks about GitHub integration - If GitHub CLI is installed, asks whether to enable auto-push
3. Asks your scenario - Starting fresh or configuring an existing clone
4. Clones PropelKit - If starting fresh, clones the boilerplate
5. Launches Claude Code - Opens Claude Code in your project directory
- Node.js 18+ - Required for running the CLI
- Claude Code - Required for the AI PM conversation
These are optional but enhance the experience:
- Supabase CLI - Enables automatic database migrations
- Without it: SQL is shown inline for manual execution
- Install: https://supabase.com/docs/guides/local-development/cli/getting-started
- GitHub CLI - Enables automatic repo creation and commits
- Without it: Local commits only, you push manually
- Install: https://cli.github.com/
When Claude Code opens, type:
``
/propelkit:new-project
This starts the AI PM conversation to build your project.
The AI PM conversation will create:
- .planning/PROJECT.md - Project context.planning/config.json
- - Workflow preferences + CLI availability + GitHub preference.planning/research/
- - Domain research (optional).planning/REQUIREMENTS.md
- - Scoped requirements.planning/ROADMAP.md
- - Phase structure.planning/STATE.md
- - Project memory
PropelKit builds SaaS apps with:
- Next.js 15 (App Router)
- TypeScript (strict mode)
- Supabase (PostgreSQL + Auth + RLS)
- Razorpay (payments, INR)
- Resend (emails)
- Inngest (background jobs)
- shadcn/ui + Tailwind CSS
PropelKit is built for Indian developers:
- Razorpay payments (not Stripe)
- INR currency formatting
- GST calculation and invoicing
- Indian phone number validation
`bash`
cd packages/create-propelkit
npm install
node bin/cli.js
Releases are automated via GitHub Actions when a version tag is pushed.
Configure these repository secrets in GitHub:
1. GH_PAT: Personal Access Token with repo scoperepo
- Go to: https://github.com/settings/tokens
- Generate new token (classic)
- Scopes: (full control)
- Add as repository secret: Settings > Secrets > Actions > New
2. NPM_TOKEN: npm access token
- Go to: https://www.npmjs.com/settings/~/tokens
- Generate new token: Automation
- Add as repository secret
1. Update version in packages/create-propelkit/package.jsongit commit -am "chore: bump version to X.Y.Z"
2. Commit: git tag vX.Y.Z
3. Tag: git push origin main --tags
4. Push:
The workflow will:
- Sync code to getpropelkit/pro repository
- Publish to npm as create-propelkit
- Create a GitHub release
After release, verify:
`bash``
npx create-propelkit@latest --version
npm info create-propelkit
MIT