r9stack 0.4.1

package/LICENSE

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2025 Ryan Packer
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,217 @@
+<p align="center">
+  <img src="assets/logo/r9stack-logo-clear.png" alt="r9stack" width="200" />
+</p>
+
+<p align="center">
+  A CLI that scaffolds opinionated SaaS projects with a fully functional walking skeleton—a complete frontend, backend, and database stack with auth pre-integrated.
+</p>
+
+## Status
+
+🚀 **Available on npm** - Install with `npx r9stack@dev`
+
+| Feature | Status |
+|---------|--------|
+| TanStack Start + React 19 | ✅ Working |
+| Starter-based architecture | ✅ Working |
+| shadcn/ui + Tailwind CSS | ✅ Working |
+| Convex backend | ✅ Working |
+| WorkOS auth | ✅ Working |
+| Flight Rules docs | ✅ Working |
+| GitHub repo creation | ✅ Working |
+| Vercel deployment | 📋 Planned |
+| Stripe payments | 📋 Post-V1 |
+
+## Why r9stack?
+
+Agentic coding has dramatically accelerated feature development, but initial project setup—configuring the frontend framework, wiring up the backend and database, integrating auth providers—remains tedious and error-prone.
+
+r9stack eliminates this friction. Run a single command and have a scaffolded full-stack project in minutes.
+
+## Architecture
+
+r9stack uses TanStack Start's [starter system](docs/tanstack-start-starter-system.md) to create projects:
+
+1. **CLI invokes TanStack Start** with a `--starter` flag pointing to a hosted `starter.json`
+2. **TanStack Start creates the project** and applies r9stack customizations
+3. **CLI guides post-creation setup** for Convex, WorkOS, and optional GitHub/Vercel integration
+
+## Tech Stack
+
+| Layer | Technology | Description |
+|-------|------------|-------------|
+| Framework | TanStack Start | Full-stack React framework with SSR and server functions |
+| UI Library | React 19 | Declarative UI with the latest React features |
+| Language | TypeScript | Type-safe JavaScript for reliable code |
+| Styling | Tailwind CSS 4 | Utility-first CSS framework |
+| Build | Vite | Lightning-fast build tool and dev server |
+| Backend | Convex | Real-time backend with automatic sync |
+| Auth | WorkOS AuthKit | Enterprise-ready SSO and MFA |
+| Sessions | iron-session | Encrypted cookie-based sessions |
+| Components | shadcn/ui | Beautiful, accessible Radix-based components |
+
+## Getting Started
+
+```bash
+# Create a new project
+npx r9stack@dev init my-project
+```
+
+### Local Development
+
+```bash
+# Clone the repository
+git clone https://github.com/ryanpacker/r9stack.git
+cd r9stack
+
+# Install dependencies and build
+npm install
+npm run build
+
+# Link globally for testing
+npm link
+
+# Create a new project
+r9stack init my-project
+```
+
+## Usage
+
+```bash
+# Interactive mode - prompts for project name and options
+npx r9stack@dev init
+
+# Provide project name directly
+npx r9stack@dev init my-awesome-app
+
+# Non-interactive with defaults (installs Flight Rules, skips GitHub)
+npx r9stack@dev init my-awesome-app --yes
+
+# Create with GitHub repo
+npx r9stack@dev init my-awesome-app --yes --github
+
+# Create public GitHub repo
+npx r9stack@dev init my-awesome-app --github --public
+
+# Skip Flight Rules installation
+npx r9stack@dev init my-awesome-app --no-flight-rules
+
+# Use a specific starter
+npx r9stack@dev init my-awesome-app --starter standard
+
+# List available starters
+npx r9stack@dev --starter-list
+
+# View help
+npx r9stack@dev init --help
+```
+
+### CLI Options
+
+| Flag | Description |
+|------|-------------|
+| `-y, --yes` | Skip confirmation prompts |
+| `-s, --starter <id>` | Use a specific starter (e.g., 'standard') |
+| `--no-flight-rules` | Skip Flight Rules installation |
+| `--github` | Create GitHub repository |
+| `--no-github` | Skip GitHub repository creation |
+| `--private` | Make GitHub repository private (default) |
+| `--public` | Make GitHub repository public |
+
+The CLI will:
+1. Fetch the latest starter template from GitHub
+2. Create your project using TanStack Start
+3. Replace project name placeholders in generated files
+4. Install [Flight Rules](https://github.com/ryanpacker/flight-rules) documentation framework
+5. Optionally create a GitHub repository and push initial commit
+6. Guide you through post-creation setup (Convex, WorkOS)
+
+## What Gets Generated (V1 Target)
+
+Running `npx r9stack@dev init` will create a project with:
+
+```
+my-project/
+├── .flight-rules/          # Flight Rules documentation framework
+│   ├── AGENTS.md           # Agent guidelines
+│   ├── commands/           # Coding session workflows
+│   └── doc-templates/      # Documentation templates
+├── convex/
+│   ├── _generated/         # Auto-generated by Convex
+│   ├── schema.ts           # Database schema
+│   └── messages.ts         # Demo Convex functions
+├── public/
+│   └── images/             # App logos and assets
+├── src/
+│   ├── components/
+│   │   ├── ui/             # shadcn components
+│   │   ├── AppShell.tsx    # Application shell
+│   │   ├── Sidebar.tsx     # Collapsible sidebar
+│   │   ├── NavGroup.tsx    # Navigation group
+│   │   ├── NavItem.tsx     # Navigation item
+│   │   └── UserMenu.tsx    # Auth-aware user menu
+│   ├── lib/
+│   │   ├── auth.ts         # Auth types
+│   │   ├── auth-client.ts  # Client-side auth context
+│   │   ├── auth-server.ts  # Server-side auth (iron-session)
+│   │   └── utils.ts        # Utilities (cn helper)
+│   ├── routes/
+│   │   ├── __root.tsx      # Root layout with providers
+│   │   ├── index.tsx       # Public landing page
+│   │   ├── auth/           # Auth flow routes
+│   │   │   ├── sign-in.tsx
+│   │   │   ├── callback.tsx
+│   │   │   └── sign-out.tsx
+│   │   └── app/            # Protected routes
+│   │       ├── route.tsx   # Auth guard + AppShell
+│   │       ├── index.tsx   # Authenticated home
+│   │       └── demo/       # Demo pages
+│   └── styles.css          # Tailwind + shadcn styles
+├── .env.example
+├── components.json         # shadcn configuration
+├── package.json
+├── tsconfig.json
+└── vite.config.ts
+```
+
+### Route Structure
+
+- `/` — Public landing page
+- `/auth/*` — Authentication flow (sign-in, callback, sign-out)
+- `/app/*` — Protected routes (requires authentication)
+
+## Manual Setup Required
+
+After scaffolding, you'll need to:
+
+1. **Set up WorkOS** — Create account at https://workos.com, configure redirect URI
+2. **Set up Convex** — Run `npx convex dev` to create project and authenticate
+3. **Add environment variables** — Copy `.env.example` to `.env.local` and fill in credentials
+
+## Project Structure
+
+```
+r9stack/
+├── src/                    # CLI source code
+├── starters/
+│   └── standard/           # r9-starter-standard source
+├── tests/
+│   ├── e2e/               # End-to-end tests
+│   └── output/            # Test output (gitignored)
+├── docs/
+│   ├── prd.md             # Product requirements
+│   ├── implementation/    # Implementation specs
+│   └── ...
+└── dist/                  # Compiled CLI
+```
+
+## Documentation
+
+- [Product Requirements](docs/prd.md)
+- [TanStack Starter System](docs/tanstack-start-starter-system.md)
+- [Starter Development Guide](docs/starter-development.md)
+- [Tech Stack](docs/tech-stack.md)
+
+## License
+
+Apache 2.0 - See [LICENSE](LICENSE) for details.

package/dist/commands/init.d.ts

@@ -0,0 +1,10 @@
+export interface InitOptions {
+    starter?: string;
+    yes?: boolean;
+    flightRules?: boolean;
+    github?: boolean;
+    private?: boolean;
+    public?: boolean;
+}
+export declare function initCommand(projectName: string | undefined, options: InitOptions): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAkQf"}

package/dist/commands/init.js

@@ -0,0 +1,239 @@
+import { input, confirm, select } from "@inquirer/prompts";
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import pc from "picocolors";
+import { createTanStackProject } from "../utils/exec.js";
+import { logger } from "../utils/logger.js";
+import { getDefaultStarter, getStarterById, fetchStarters, } from "../utils/starters.js";
+import { replaceProjectNamePlaceholder } from "../utils/templates.js";
+import { installFlightRules } from "../utils/flight-rules.js";
+import { isGhCliInstalled, isGhCliAuthenticated, initGitRepo, createGitHubRepo, } from "../utils/github.js";
+export async function initCommand(projectName, options) {
+    logger.banner("r9stack - Scaffold your SaaS");
+    // Fetch the starter
+    let starter;
+    try {
+        logger.info("Fetching available starters...");
+        if (options.starter) {
+            // User specified a starter by ID
+            const found = await getStarterById(options.starter);
+            if (!found) {
+                logger.error(`Starter "${options.starter}" not found.`);
+                logger.blank();
+                logger.info("Available starters:");
+                const starters = await fetchStarters();
+                for (const s of starters) {
+                    const shortId = s.id.replace("r9-starter-", "");
+                    console.log(`  ${pc.cyan(shortId)} - ${s.name}`);
+                }
+                logger.blank();
+                process.exit(1);
+            }
+            starter = found;
+        }
+        else {
+            // Use default starter
+            starter = await getDefaultStarter();
+        }
+        logger.blank();
+    }
+    catch {
+        logger.error("Could not fetch starters. Please check your internet connection.");
+        process.exit(1);
+    }
+    // Show starter info
+    logger.info(`Using starter: ${pc.cyan(starter.name)} v${starter.version}`);
+    logger.info(pc.dim(starter.description));
+    logger.blank();
+    // Prompt for project name if not provided
+    const name = projectName ||
+        (await input({
+            message: "What is your project name?",
+            default: "my-r9-project",
+            validate: (value) => {
+                if (!value.trim()) {
+                    return "Project name is required";
+                }
+                if (!/^[a-z0-9-]+$/.test(value)) {
+                    return "Project name must be lowercase alphanumeric with hyphens only";
+                }
+                return true;
+            },
+        }));
+    const targetPath = resolve(process.cwd(), name);
+    // Check if directory exists
+    if (existsSync(targetPath)) {
+        if (options.yes) {
+            logger.warn(`Directory ${pc.yellow(name)} already exists. Continuing...`);
+        }
+        else {
+            const proceed = await confirm({
+                message: `Directory ${pc.yellow(name)} already exists. Continue anyway?`,
+                default: false,
+            });
+            if (!proceed) {
+                logger.info("Aborted.");
+                return;
+            }
+        }
+    }
+    // Confirm before proceeding
+    logger.blank();
+    logger.info(`Project: ${pc.cyan(name)}`);
+    logger.info(`Location: ${pc.cyan(targetPath)}`);
+    logger.blank();
+    if (!options.yes) {
+        const confirmed = await confirm({
+            message: "Create project with these settings?",
+            default: true,
+        });
+        if (!confirmed) {
+            logger.info("Aborted.");
+            return;
+        }
+    }
+    logger.blank();
+    // Create the TanStack Start project with starter
+    const success = await createTanStackProject(name, starter.url);
+    if (!success) {
+        process.exit(1);
+    }
+    // Replace project name placeholder in generated files
+    replaceProjectNamePlaceholder(targetPath, name);
+    logger.blank();
+    logger.success("Project created successfully!");
+    logger.blank();
+    // Track what was installed for next steps
+    let flightRulesInstalled = false;
+    let gitHubRepoCreated = false;
+    let repoVisibility = "private";
+    // === Flight Rules Installation ===
+    // Default: install unless --no-flight-rules was specified
+    const shouldInstallFlightRules = options.flightRules !== false;
+    if (shouldInstallFlightRules) {
+        let doInstall = options.yes; // With --yes, auto-install
+        if (!options.yes) {
+            doInstall = await confirm({
+                message: "Install Flight Rules documentation framework?",
+                default: true,
+            });
+        }
+        if (doInstall) {
+            flightRulesInstalled = await installFlightRules(targetPath);
+            if (flightRulesInstalled) {
+                logger.success("Flight Rules installed!");
+            }
+            logger.blank();
+        }
+    }
+    // === GitHub Repository Creation ===
+    // Default: skip with --yes (unless --github is specified)
+    // Interactive: prompt the user
+    const githubExplicitlyEnabled = options.github === true;
+    const githubExplicitlyDisabled = options.github === false;
+    let shouldCreateGitHub = false;
+    if (githubExplicitlyDisabled) {
+        shouldCreateGitHub = false;
+    }
+    else if (githubExplicitlyEnabled) {
+        shouldCreateGitHub = true;
+    }
+    else if (options.yes) {
+        // With --yes but no explicit flag, skip GitHub
+        shouldCreateGitHub = false;
+    }
+    else {
+        // Interactive mode: ask the user
+        shouldCreateGitHub = await confirm({
+            message: "Create a GitHub repository for this project?",
+            default: false,
+        });
+    }
+    if (shouldCreateGitHub) {
+        // Check if gh CLI is installed
+        const ghInstalled = await isGhCliInstalled();
+        if (!ghInstalled) {
+            logger.warn("GitHub CLI (gh) is not installed.");
+            logger.info("Install it from: https://cli.github.com/");
+            logger.info("Then run: gh auth login");
+            logger.blank();
+        }
+        else {
+            // Check if authenticated
+            const ghAuthenticated = await isGhCliAuthenticated();
+            if (!ghAuthenticated) {
+                logger.warn("GitHub CLI is not authenticated.");
+                logger.info("Run: gh auth login");
+                logger.blank();
+            }
+            else {
+                // Determine visibility
+                if (options.public) {
+                    repoVisibility = "public";
+                }
+                else if (options.private) {
+                    repoVisibility = "private";
+                }
+                else if (!options.yes) {
+                    // Prompt for visibility
+                    repoVisibility = await select({
+                        message: "Repository visibility:",
+                        choices: [
+                            { name: "Private", value: "private" },
+                            { name: "Public", value: "public" },
+                        ],
+                        default: "private",
+                    });
+                }
+                // Initialize git repo
+                logger.info("Initializing git repository...");
+                const gitInitialized = await initGitRepo(targetPath);
+                if (gitInitialized) {
+                    logger.info(`Creating ${repoVisibility} GitHub repository...`);
+                    gitHubRepoCreated = await createGitHubRepo(targetPath, name, repoVisibility === "private");
+                    if (gitHubRepoCreated) {
+                        logger.success(`GitHub repository created and pushed!`);
+                    }
+                }
+                logger.blank();
+            }
+        }
+    }
+    // Next steps (adjusted based on what was installed)
+    logger.info("Next steps:");
+    logger.blank();
+    let stepNumber = 1;
+    // Only show cd step if we're not already in the project
+    console.log(`  ${pc.cyan(`${stepNumber}.`)} Navigate to your project:`);
+    console.log(`     ${pc.dim("$")} ${pc.cyan("cd")} ${name}`);
+    logger.blank();
+    stepNumber++;
+    console.log(`  ${pc.cyan(`${stepNumber}.`)} Set up Convex (real-time database):`);
+    console.log(`     ${pc.dim("$")} ${pc.cyan("npx convex dev")}`);
+    console.log(`     ${pc.dim("This will create your Convex project and generate types.")}`);
+    logger.blank();
+    stepNumber++;
+    console.log(`  ${pc.cyan(`${stepNumber}.`)} Configure WorkOS authentication:`);
+    console.log(`     ${pc.dim("•")} Go to ${pc.underline("https://dashboard.workos.com")}`);
+    console.log(`     ${pc.dim("•")} Create a project and copy your API keys`);
+    console.log(`     ${pc.dim("•")} Add them to your ${pc.cyan(".env")} file`);
+    logger.blank();
+    stepNumber++;
+    console.log(`  ${pc.cyan(`${stepNumber}.`)} Start the development server:`);
+    console.log(`     ${pc.dim("$")} ${pc.cyan("npm run dev")}`);
+    logger.blank();
+    // Show summary of what was set up
+    if (flightRulesInstalled || gitHubRepoCreated) {
+        logger.info("Additional setup completed:");
+        if (flightRulesInstalled) {
+            console.log(`  ${pc.green("✓")} Flight Rules documentation framework`);
+        }
+        if (gitHubRepoCreated) {
+            console.log(`  ${pc.green("✓")} GitHub repository (${repoVisibility})`);
+        }
+        logger.blank();
+    }
+    logger.info(`${pc.dim("For more info, see the README.md in your project.")}`);
+    logger.blank();
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}