create-propelkit 1.0.0

package/README.md

@@ -0,0 +1,131 @@
+# create-propelkit
+
+Initialize a PropelKit SaaS project with AI PM.
+
+## Usage
+
+```bash
+npx create-propelkit
+# or
+npm init propelkit
+# or
+npx propelkit init
+```
+
+## What It Does
+
+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
+
+## Requirements
+
+- **Node.js 18+** - Required for running the CLI
+- **Claude Code** - Required for the AI PM conversation
+
+### Optional CLIs
+
+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/
+
+## After Launch
+
+When Claude Code opens, type:
+
+```
+/propelkit:new-project
+```
+
+This starts the AI PM conversation to build your project.
+
+## What Gets Created
+
+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
+
+## Tech Stack
+
+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
+
+## India-First
+
+PropelKit is built for Indian developers:
+
+- Razorpay payments (not Stripe)
+- INR currency formatting
+- GST calculation and invoicing
+- Indian phone number validation
+
+## Development
+
+```bash
+cd packages/create-propelkit
+npm install
+node bin/cli.js
+```
+
+## Release Process
+
+Releases are automated via GitHub Actions when a version tag is pushed.
+
+### Prerequisites
+
+Configure these repository secrets in GitHub:
+
+1. **GH_PAT**: Personal Access Token with `repo` scope
+   - Go to: https://github.com/settings/tokens
+   - Generate new token (classic)
+   - Scopes: `repo` (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
+
+### Creating a Release
+
+1. Update version in `packages/create-propelkit/package.json`
+2. Commit: `git commit -am "chore: bump version to X.Y.Z"`
+3. Tag: `git tag vX.Y.Z`
+4. Push: `git push origin main --tags`
+
+The workflow will:
+- Sync code to getpropelkit/pro repository
+- Publish to npm as `create-propelkit`
+- Create a GitHub release
+
+### Manual Verification
+
+After release, verify:
+```bash
+npx create-propelkit@latest --version
+npm info create-propelkit
+```
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+const { main } = require('../src/index.js');
+main().catch((err) => {
+  console.error('Error:', err.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "create-propelkit",
+  "version": "1.0.0",
+  "description": "Initialize a PropelKit SaaS project with AI PM",
+  "bin": "./bin/cli.js",
+  "main": "./src/index.js",
+  "type": "commonjs",
+  "files": [
+    "bin",
+    "src"
+  ],
+  "keywords": [
+    "propelkit",
+    "saas",
+    "boilerplate",
+    "india",
+    "razorpay",
+    "supabase"
+  ],
+  "author": "PropelKit",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "command-exists": "^1.2.9",
+    "inquirer": "^8.2.6",
+    "zod": "^4.3.6"
+  }
+}

package/src/cli-detector.js

@@ -0,0 +1,104 @@
+const commandExists = require('command-exists');
+const inquirer = require('inquirer');
+
+const CLI_DEFINITIONS = [
+  {
+    name: 'claude',
+    label: 'Claude Code',
+    installUrl: 'https://claude.ai/download',
+    required: true,
+    benefit: 'Required to run PropelKit AI PM'
+  },
+  {
+    name: 'supabase',
+    label: 'Supabase CLI',
+    installUrl: 'https://supabase.com/docs/guides/local-development/cli/getting-started',
+    required: false,
+    benefit: 'Enables automatic database migrations'
+  },
+  {
+    name: 'gh',
+    label: 'GitHub CLI',
+    installUrl: 'https://cli.github.com/',
+    required: false,
+    benefit: 'Enables automatic repo creation and commits'
+  }
+];
+
+async function detectCLIs() {
+  const results = await Promise.all(
+    CLI_DEFINITIONS.map(async (cli) => ({
+      ...cli,
+      installed: await commandExists(cli.name).then(() => true).catch(() => false)
+    }))
+  );
+  return results;
+}
+
+function displayCLIStatus(clis, chalk) {
+  console.log('');
+  console.log(chalk.cyan.bold('CLI Detection'));
+  console.log(chalk.dim('-'.repeat(50)));
+
+  for (const cli of clis) {
+    const status = cli.installed
+      ? chalk.green('Found')
+      : chalk.yellow('Not found');
+    const required = cli.required ? chalk.red(' (required)') : '';
+
+    console.log(`  ${cli.label}: ${status}${required}`);
+
+    if (!cli.installed) {
+      console.log(chalk.dim(`    ${cli.benefit}`));
+      console.log(chalk.dim(`    Install: ${cli.installUrl}`));
+    }
+  }
+  console.log('');
+}
+
+/**
+ * Ask user about GitHub CLI connection (CLI-03 requirement)
+ * Only asks if gh CLI is detected as installed
+ * @param {object} ghCli - GitHub CLI detection result
+ * @param {object} chalk - Chalk instance for styling
+ * @returns {Promise<boolean>} - Whether user wants GitHub integration
+ */
+async function askGitHubConnection(ghCli, chalk) {
+  if (!ghCli.installed) {
+    // gh not installed - skip question, return false
+    return false;
+  }
+
+  console.log('');
+  console.log(chalk.cyan.bold('GitHub Integration'));
+  console.log(chalk.dim('-'.repeat(50)));
+  console.log('');
+  console.log('GitHub CLI is installed. PropelKit can:');
+  console.log(chalk.dim('  - Create a GitHub repository for your project'));
+  console.log(chalk.dim('  - Automatically push commits after each phase'));
+  console.log(chalk.dim('  - Manage branches for feature development'));
+  console.log('');
+
+  const { useGitHub } = await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'useGitHub',
+      message: 'Enable GitHub integration?',
+      default: true
+    }
+  ]);
+
+  return useGitHub;
+}
+
+function getCLIByName(clis, name) {
+  return clis.find(cli => cli.name === name);
+}
+
+module.exports = {
+  detectCLIs,
+  displayCLIStatus,
+  askGitHubConnection,
+  getCLIByName,
+  CLI_DEFINITIONS
+};

package/src/config.js

@@ -0,0 +1,25 @@
+// Distribution configuration
+const REPOS = {
+  starter: 'https://github.com/getpropelkit/starter.git',
+  pro: 'https://github.com/getpropelkit/pro.git'
+};
+
+const API_ENDPOINTS = {
+  licenseValidation: 'https://www.propelkit.dev/api/license/validate'
+};
+
+const LICENSE_PATTERNS = {
+  // PK-STARTER-2026-XXXXXX or PK-PRO-2026-XXXXXX
+  format: /^PK-(STARTER|PRO|AGENCY)-\d{4}-[A-Z0-9]{6}$/
+};
+
+const TIMEOUTS = {
+  licenseValidation: 5000  // 5 seconds
+};
+
+module.exports = {
+  REPOS,
+  API_ENDPOINTS,
+  LICENSE_PATTERNS,
+  TIMEOUTS
+};