create-pilotprojects-app 0.3.2 → 0.3.3

package/README.md

@@ -59,7 +59,7 @@ The CLI is interactive — it asks a few questions then scaffolds, installs depe
 | ------------------------------ | -------------------------------------------------------- | ----------------- |
 | Project name                   | Any lowercase slug                                       | —                 |
 | Package scope                  | `@<name>`                                                | `@<project-name>` |
-| Apps to scaffold               | Web only / Mobile only / Both                                      | Web only          |
+| Apps to scaffold               | Web only / Mobile only / Both                            | Web only          |
 | Environments                   | development / uat / production _(local always included)_ | production        |
 | Include design system?         | Yes / No                                                 | Yes               |
 | Include Sentry?                | Yes / No                                                 | Yes               |

package/dist/index.js

@@ -40,13 +40,15 @@ program
         pc.green("✔ Project created successfully!\n"),
         pc.bold("Next steps:"),
         `  cd ${pc.cyan(config.projectName)}`,
-        `  cp apps/web/.env.development.example apps/web/.env.development`,
+        config.apps.includes("web")
+            ? `  cp apps/web/.env.local.example apps/web/.env.local`
+            : "",
         config.apps.includes("mobile")
-            ? `  cp apps/mobile/.env.example apps/mobile/.env`
+            ? `  cp apps/mobile/.env.local.example apps/mobile/.env.local`
             : "",
         `  ${config.packageManager} run dev`,
         "",
-        pc.dim("See docs/ for full setup instructions."),
+        pc.dim("See README.md for full setup instructions."),
     ]
         .filter(Boolean)
         .join("\n"));

package/dist/prompts.js

@@ -28,9 +28,21 @@ export async function runPrompts(projectNameArg) {
         apps: () => p.select({
             message: "Which apps do you want to scaffold?",
             options: [
-                { value: ["web"], label: "Web only", hint: "Next.js 15 + tRPC + Drizzle" },
-                { value: ["mobile"], label: "Mobile only", hint: "Expo SDK 52 + React Native" },
-                { value: ["web", "mobile"], label: "Web + Mobile", hint: "Both apps" },
+                {
+                    value: ["web"],
+                    label: "Web only",
+                    hint: "Next.js 15 + tRPC + Drizzle",
+                },
+                {
+                    value: ["mobile"],
+                    label: "Mobile only",
+                    hint: "Expo SDK 52 + React Native",
+                },
+                {
+                    value: ["web", "mobile"],
+                    label: "Web + Mobile",
+                    hint: "Both apps",
+                },
             ],
             initialValue: ["web"],
         }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pilotprojects-app",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "CLI to scaffold the Pilotprojects monorepo boilerplate",
   "keywords": [
     "create",

package/templates/base/README.md

@@ -0,0 +1,120 @@
+# {{PROJECT_NAME}}
+
+A full-stack monorepo with Next.js web app and Expo mobile app, built on tRPC, Supabase, and Drizzle ORM.
+
+## Quick Start
+
+### 1. Set up environment variables
+
+```bash
+# Web
+cp apps/web/.env.local.example apps/web/.env.local
+
+# Mobile (if applicable)
+cp apps/mobile/.env.local.example apps/mobile/.env.local
+```
+
+Open `.env.local` and fill in your values:
+
+| Variable | Where to get it |
+| --- | --- |
+| `DATABASE_URL` | Supabase → Project Settings → Database → Connection string (Transaction pooler) |
+| `SUPABASE_URL` | Supabase → Project Settings → API → Project URL |
+| `SUPABASE_ANON_KEY` | Supabase → Project Settings → API → anon public |
+| `SUPABASE_SERVICE_ROLE_KEY` | Supabase → Project Settings → API → service_role (keep secret) |
+| `NEXT_PUBLIC_SUPABASE_URL` | Same as `SUPABASE_URL` |
+| `NEXT_PUBLIC_SUPABASE_ANON_KEY` | Same as `SUPABASE_ANON_KEY` |
+
+### 2. Start local Supabase
+
+Requires the [Supabase CLI](https://supabase.com/docs/guides/cli).
+
+```bash
+supabase start
+```
+
+This starts a local Postgres database on port `54322` and the Supabase API on `54321`. The local credentials are already pre-filled in `.env.local.example`.
+
+### 3. Run database migrations
+
+```bash
+pnpm --filter {{PACKAGE_SCOPE}}/db db:migrate
+```
+
+### 4. Start dev servers
+
+```bash
+pnpm dev
+# → web:    http://localhost:3000
+# → mobile: Expo DevTools (if mobile app is included)
+```
+
+---
+
+## Environment Strategy
+
+`local` is always present. Additional environments (development, uat, production) each have their own env file:
+
+```
+apps/web/.env.local        ← local Supabase (localhost)
+apps/web/.env.development  ← dev Supabase project
+apps/web/.env.uat          ← UAT Supabase project
+apps/web/.env.production   ← production Supabase project
+```
+
+Copy the matching `.example` file for each environment you need and fill in the remote values.
+
+---
+
+## Common Commands
+
+```bash
+# Install dependencies
+pnpm install
+
+# Lint all packages
+pnpm lint
+
+# Type-check all packages
+pnpm type-check
+
+# Generate a database migration after schema changes
+pnpm --filter {{PACKAGE_SCOPE}}/db db:generate
+
+# Apply migrations
+pnpm --filter {{PACKAGE_SCOPE}}/db db:migrate
+
+# Open Drizzle Studio (visual DB browser)
+pnpm --filter {{PACKAGE_SCOPE}}/db db:studio
+```
+
+---
+
+## Project Structure
+
+```
+apps/
+  web/        Next.js 15 (App Router)
+  mobile/     Expo SDK 52 / React Native
+
+packages/
+  api/        tRPC routers — shared by web and mobile
+  auth/       Supabase Auth helpers
+  db/         Drizzle ORM schema + database client
+  ui/         Design system (web + native components)
+  validators/ Shared Zod schemas
+  email/      Resend + React Email templates
+  config/     Shared ESLint and TypeScript configs
+```
+
+## Adding API Features
+
+Create a new feature folder in `packages/api/src/features/<name>/` with three files:
+
+```
+<name>.schema.ts   → Zod input/output types
+<name>.service.ts  → Business logic (pure async functions)
+<name>.router.ts   → tRPC router (validate → auth → call service)
+```
+
+Register the router in `packages/api/src/root.ts`.