create-pilotprojects-app 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,116 @@
+# create-pilotprojects-app
+
+Scaffold a production-ready monorepo in under a minute — Next.js 15 web app, Expo mobile app, or both, wired together with tRPC, Supabase, Drizzle ORM, and a shared design system.
+
+## Usage
+
+```bash
+# npm
+npm create pilotprojects-app@latest
+
+# pnpm
+pnpm create pilotprojects-app
+
+# yarn
+yarn create pilotprojects-app
+
+# With project name pre-filled
+pnpm create pilotprojects-app my-project
+```
+
+The CLI is interactive — it asks a few questions then scaffolds, installs dependencies, and runs `git init` automatically.
+
+---
+
+## What's included
+
+### Core (always scaffolded)
+
+| Package               | Purpose                                                |
+| --------------------- | ------------------------------------------------------ |
+| `@<scope>/api`        | tRPC v11 routers with a feature-based service layer    |
+| `@<scope>/db`         | Drizzle ORM + Supabase Postgres — migrations included  |
+| `@<scope>/auth`       | Supabase Auth helpers for web (SSR cookies) and mobile |
+| `@<scope>/validators` | Shared Zod schemas                                     |
+| `@<scope>/config`     | Shared ESLint and TypeScript configs                   |
+
+### Apps (your choice)
+
+| App           | Stack                                                                         |
+| ------------- | ----------------------------------------------------------------------------- |
+| `apps/web`    | Next.js 15 App Router · Tailwind CSS · shadcn/ui · tRPC client (RSC + client) |
+| `apps/mobile` | Expo SDK 52 · React Native · NativeWind · tRPC HTTP client                    |
+
+### Optional add-ons
+
+| Feature              | What it adds                                                                                 |
+| -------------------- | -------------------------------------------------------------------------------------------- |
+| **Design System**    | `@<scope>/ui` — Tailwind preset, shadcn/ui components (web), react-native-reusables (mobile) |
+| **Email**            | `@<scope>/email` — Resend SDK + React Email templates                                        |
+| **Sentry**           | Error monitoring configured for web and/or mobile                                            |
+| **PostHog**          | Product analytics + feature flags                                                            |
+| **Google Analytics** | `@next/third-parties` GA4 script in the web layout                                           |
+
+---
+
+## Interactive prompts
+
+| Prompt                         | Options             | Default           |
+| ------------------------------ | ------------------- | ----------------- |
+| Project name                   | Any lowercase slug  | —                 |
+| Package scope                  | `@<name>`           | `@<project-name>` |
+| Apps to scaffold               | Web / Mobile / Both | Both              |
+| Environments                   | development / uat / production *(local always included)* | production |
+| Include design system?         | Yes / No            | Yes               |
+| Include Sentry?                | Yes / No            | Yes               |
+| Include Resend (email)?        | Yes / No            | Yes               |
+| Include PostHog?               | Yes / No            | No                |
+| Google Analytics? _(web only)_ | Yes / No            | No                |
+| Package manager                | pnpm / npm / yarn   | pnpm              |
+
+---
+
+## After scaffolding
+
+```bash
+cd my-project
+
+# Copy and fill in environment files
+cp apps/web/.env.development.example apps/web/.env.development
+# Add: SUPABASE_URL, SUPABASE_ANON_KEY, SUPABASE_SERVICE_ROLE_KEY,
+#       DATABASE_URL, RESEND_API_KEY, SENTRY_DSN
+
+# Start local Supabase (requires Supabase CLI)
+supabase start
+
+# Apply database migrations
+pnpm --filter @repo/db db:migrate
+
+# Start dev servers (web + mobile in parallel)
+pnpm dev
+# → web:    http://localhost:3000
+# → mobile: Expo DevTools
+```
+
+---
+
+## Tech stack
+
+| Layer       | Choice                              |
+| ----------- | ----------------------------------- |
+| Monorepo    | Turborepo + pnpm workspaces         |
+| Web         | Next.js 15 (App Router)             |
+| Mobile      | Expo SDK 52 / React Native 0.76     |
+| API         | tRPC v11 + React Query              |
+| Database    | Drizzle ORM + Supabase Postgres     |
+| Auth        | Supabase Auth                       |
+| UI (web)    | Tailwind CSS + shadcn/ui            |
+| UI (mobile) | NativeWind + react-native-reusables |
+| Email       | Resend + React Email                |
+| Validation  | Zod                                 |
+
+---
+
+## License
+
+MIT

package/dist/prompts.js

@@ -34,6 +34,16 @@ export async function runPrompts(projectNameArg) {
             initialValues: ["web", "mobile"],
             required: true,
         }),
+        environments: () => p.multiselect({
+            message: "Which environments? (local is always included)",
+            options: [
+                { value: "development", label: "Development", hint: "dev branch" },
+                { value: "uat", label: "UAT", hint: "staging / QA" },
+                { value: "production", label: "Production", hint: "live users" },
+            ],
+            initialValues: ["production"],
+            required: true,
+        }),
         designSystem: () => p.confirm({
             message: "Include the default design system? (Tailwind + ShadCN web / NativeWind mobile)",
             initialValue: true,

package/dist/scaffold.js

@@ -36,6 +36,7 @@ export async function scaffold(config, destDir) {
     if (config.apps.includes("web")) {
         spin.start("Scaffolding Next.js web app…");
         await copyTemplate(path.join(TEMPLATES_DIR, "apps", "web"), path.join(destDir, "apps", "web"), vars);
+        await generateWebEnvFiles(path.join(destDir, "apps", "web"), config);
         if (!config.sentry) {
             await removeDeps(path.join(destDir, "apps", "web"), ["@sentry/nextjs"]);
             await fs.remove(path.join(destDir, "apps", "web", "sentry.client.config.ts"));
@@ -54,6 +55,9 @@ export async function scaffold(config, destDir) {
     if (config.apps.includes("mobile")) {
         spin.start("Scaffolding Expo mobile app…");
         await copyTemplate(path.join(TEMPLATES_DIR, "apps", "mobile"), path.join(destDir, "apps", "mobile"), vars);
+        await generateMobileEnvFiles(path.join(destDir, "apps", "mobile"), config);
+        await generateEasJson(path.join(destDir, "apps", "mobile"), config.environments);
+        await generateMobileAppConfig(path.join(destDir, "apps", "mobile"), config);
         if (!config.sentry) {
             await removeDeps(path.join(destDir, "apps", "mobile"), ["@sentry/react-native"]);
         }
@@ -82,3 +86,186 @@ async function updateWorkspace(destDir, config) {
     lines.push('  - "packages/*"');
     await fs.outputFile(workspacePath, lines.join("\n") + "\n", "utf-8");
 }
+// ── Environment file generators ──────────────────────────────────────────────
+const WEB_ENV_BASE = `# Supabase
+DATABASE_URL=
+SUPABASE_URL=
+SUPABASE_ANON_KEY=
+SUPABASE_SERVICE_ROLE_KEY=
+NEXT_PUBLIC_SUPABASE_URL=
+NEXT_PUBLIC_SUPABASE_ANON_KEY=
+
+# Sentry (optional — leave empty to disable)
+SENTRY_DSN=
+SENTRY_AUTH_TOKEN=
+NEXT_PUBLIC_SENTRY_DSN=
+
+# PostHog (optional)
+NEXT_PUBLIC_POSTHOG_KEY=
+POSTHOG_KEY=
+
+# Google Analytics (optional)
+NEXT_PUBLIC_GA_MEASUREMENT_ID=
+
+# App
+APP_URL=`;
+const MOBILE_ENV_BASE = `# Supabase
+EXPO_PUBLIC_SUPABASE_URL=
+EXPO_PUBLIC_SUPABASE_ANON_KEY=
+
+# API (apps/web URL)
+EXPO_PUBLIC_API_URL=
+
+# Sentry (optional)
+EXPO_PUBLIC_SENTRY_DSN=
+
+# PostHog (optional)
+EXPO_PUBLIC_POSTHOG_KEY=
+`;
+const WEB_APP_URL = {
+    development: "https://dev.yourapp.com",
+    uat: "https://uat.yourapp.com",
+    production: "https://yourapp.com",
+};
+const MOBILE_API_URL = {
+    development: "https://dev.yourapp.com",
+    uat: "https://uat.yourapp.com",
+    production: "https://yourapp.com",
+};
+async function generateWebEnvFiles(webDir, config) {
+    // .env.local.example is already copied from template (localhost values)
+    // generate one .env.{env}.example per selected non-local environment
+    for (const env of config.environments) {
+        const content = `${WEB_ENV_BASE}${WEB_APP_URL[env]}\n`;
+        await fs.outputFile(path.join(webDir, `.env.${env}.example`), content, "utf-8");
+    }
+}
+async function generateMobileEnvFiles(mobileDir, config) {
+    // .env.local.example is already copied from template (localhost values)
+    // generate one .env.{env}.example per selected non-local environment
+    for (const env of config.environments) {
+        const content = `APP_ENV=${env}\n\n${MOBILE_ENV_BASE}`;
+        const withUrl = content.replace("EXPO_PUBLIC_API_URL=", `EXPO_PUBLIC_API_URL=${MOBILE_API_URL[env]}`);
+        await fs.outputFile(path.join(mobileDir, `.env.${env}.example`), withUrl, "utf-8");
+    }
+}
+async function generateEasJson(mobileDir, environments) {
+    const build = {};
+    if (environments.includes("development")) {
+        build.development = {
+            developmentClient: true,
+            distribution: "internal",
+            channel: "development",
+            ios: { simulator: true },
+        };
+    }
+    if (environments.includes("uat")) {
+        build.uat = {
+            distribution: "internal",
+            channel: "uat",
+            ios: { buildConfiguration: "Release", credentialsSource: "remote" },
+            android: { buildType: "apk", credentialsSource: "remote" },
+        };
+    }
+    if (environments.includes("production")) {
+        build.production = {
+            distribution: "store",
+            channel: "production",
+            ios: { buildConfiguration: "Release", credentialsSource: "remote" },
+            android: { buildType: "app-bundle", credentialsSource: "remote" },
+        };
+    }
+    const submit = environments.includes("production")
+        ? {
+            production: {
+                ios: { appleId: "", ascAppId: "", appleTeamId: "" },
+                android: { serviceAccountKeyPath: "./google-service-account.json", track: "internal" },
+            },
+        }
+        : {};
+    await fs.outputJSON(path.join(mobileDir, "eas.json"), { cli: { version: ">= 12.0.0" }, build, submit }, { spaces: 2 });
+}
+async function generateMobileAppConfig(mobileDir, config) {
+    const { projectName, packageScope, environments, sentry } = config;
+    const scopeSafe = packageScope.replace("@", "").replace("/", "-");
+    const allEnvs = ["local", ...environments];
+    const appEnvType = allEnvs.map((e) => `"${e}"`).join(" | ");
+    const defaultEnv = "local";
+    const envMeta = {
+        local: { label: " (Local)", bundleSuffix: ".local", apiUrl: "http://localhost:3000" },
+        development: { label: " (Dev)", bundleSuffix: ".dev", apiUrl: "https://dev.yourapp.com" },
+        uat: { label: " (UAT)", bundleSuffix: ".uat", apiUrl: "https://uat.yourapp.com" },
+        production: { label: "", bundleSuffix: "", apiUrl: "https://yourapp.com" },
+    };
+    const configEntries = allEnvs
+        .map((env) => {
+        const { label, bundleSuffix, apiUrl } = envMeta[env];
+        return `  ${env}: {
+    name:     "${projectName}${label}",
+    bundleId: "com.yourcompany.${scopeSafe}${bundleSuffix}",
+    apiUrl:   "${apiUrl}",
+  },`;
+    })
+        .join("\n");
+    const sentryPlugin = sentry ? `\n    "@sentry/react-native/expo",` : "";
+    const content = `import type { ExpoConfig, ConfigContext } from "expo/config";
+
+type AppEnv = ${appEnvType};
+
+const ENV = (process.env.APP_ENV ?? "${defaultEnv}") as AppEnv;
+
+const config: Record<AppEnv, { name: string; bundleId: string; apiUrl: string }> = {
+${configEntries}
+};
+
+const { name, bundleId, apiUrl } = config[ENV];
+
+export default ({ config: base }: ConfigContext): ExpoConfig => ({
+  ...base,
+  name,
+  slug: "${scopeSafe}",
+  version: "1.0.0",
+  orientation: "portrait",
+  scheme: "${scopeSafe}",
+  userInterfaceStyle: "automatic",
+  icon: "./assets/icon.png",
+  splash: {
+    image: "./assets/splash-icon.png",
+    resizeMode: "contain",
+    backgroundColor: "#ffffff",
+  },
+  ios: {
+    bundleIdentifier: bundleId,
+    supportsTablet: true,
+  },
+  android: {
+    package: bundleId,
+    adaptiveIcon: {
+      foregroundImage: "./assets/adaptive-icon.png",
+      backgroundColor: "#ffffff",
+    },
+  },
+  web: {
+    bundler: "metro",
+    output: "static",
+    favicon: "./assets/favicon.png",
+  },
+  plugins: [
+    "expo-router",${sentryPlugin}
+  ],
+  newArchEnabled: true,
+  experiments: {
+    typedRoutes: true,
+  },
+  extra: {
+    apiUrl,
+    eas: { projectId: "YOUR_EAS_PROJECT_ID" },
+  },
+  updates: {
+    url: "https://u.expo.dev/YOUR_EAS_PROJECT_ID",
+  },
+  runtimeVersion: { policy: "sdkVersion" },
+});
+`;
+    await fs.outputFile(path.join(mobileDir, "app.config.ts"), content, "utf-8");
+}

package/package.json

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

package/templates/apps/mobile/{.env.example → .env.local.example}

@@ -1,5 +1,4 @@
-# Set APP_ENV to: development | uat | production
-APP_ENV=development
+APP_ENV=local
 
 # Supabase
 EXPO_PUBLIC_SUPABASE_URL=http://localhost:54321