create-pilotprojects-app 0.1.0

package/dist/helpers/copy.js

@@ -0,0 +1,32 @@
+import fs from "fs-extra";
+import path from "path";
+function interpolate(content, vars) {
+    return content
+        .replaceAll("{{PROJECT_NAME}}", vars.PROJECT_NAME)
+        .replaceAll("{{PACKAGE_SCOPE}}", vars.PACKAGE_SCOPE)
+        .replaceAll("{{PACKAGE_SCOPE_SAFE}}", vars.PACKAGE_SCOPE_SAFE);
+}
+export async function copyTemplate(templateDir, destDir, vars) {
+    await fs.ensureDir(destDir);
+    const entries = await fs.readdir(templateDir, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(templateDir, entry.name);
+        // Rename _gitignore → .gitignore (npm strips .gitignore from published packages)
+        const destName = entry.name === "_gitignore" ? ".gitignore" : entry.name;
+        const destPath = path.join(destDir, destName);
+        if (entry.isDirectory()) {
+            await copyTemplate(srcPath, destPath, vars);
+        }
+        else {
+            const raw = await fs.readFile(srcPath, "utf-8");
+            await fs.outputFile(destPath, interpolate(raw, vars), "utf-8");
+        }
+    }
+}
+export function makeVars(projectName, packageScope) {
+    return {
+        PROJECT_NAME: projectName,
+        PACKAGE_SCOPE: packageScope,
+        PACKAGE_SCOPE_SAFE: packageScope.replace("@", "").replace("/", "-"),
+    };
+}

package/dist/helpers/install.js

@@ -0,0 +1,18 @@
+import { execa } from "execa";
+const INSTALL_CMD = {
+    pnpm: ["pnpm", ["install"]],
+    npm: ["npm", ["install"]],
+    yarn: ["yarn", ["install", "--frozen-lockfile"]],
+};
+export async function installDeps(cwd, pm) {
+    const [cmd, args] = [
+        pm,
+        pm === "pnpm" ? ["install"] : pm === "yarn" ? ["install"] : ["install"],
+    ];
+    await execa(cmd, args, { cwd, stdio: "inherit" });
+}
+export async function gitInit(cwd) {
+    await execa("git", ["init"], { cwd });
+    await execa("git", ["add", "-A"], { cwd });
+    await execa("git", ["commit", "-m", "chore: initial scaffold"], { cwd });
+}

package/dist/helpers/package-json.js

@@ -0,0 +1,25 @@
+import fs from "fs-extra";
+import path from "path";
+export async function readPkg(dir) {
+    return fs.readJson(path.join(dir, "package.json"));
+}
+export async function writePkg(dir, pkg) {
+    await fs.writeJson(path.join(dir, "package.json"), pkg, { spaces: 2 });
+}
+export async function mergePkg(dir, patch) {
+    const existing = await readPkg(dir);
+    await writePkg(dir, { ...existing, ...patch });
+}
+/** Remove a list of dependency keys from dependencies + devDependencies */
+export async function removeDeps(dir, keys) {
+    const pkg = await readPkg(dir);
+    const deps = (pkg.dependencies ?? {});
+    const devDeps = (pkg.devDependencies ?? {});
+    for (const key of keys) {
+        delete deps[key];
+        delete devDeps[key];
+    }
+    pkg.dependencies = deps;
+    pkg.devDependencies = devDeps;
+    await writePkg(dir, pkg);
+}

package/dist/index.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+import path from "path";
+import fs from "fs-extra";
+import { Command } from "commander";
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+import { runPrompts } from "./prompts.js";
+import { scaffold } from "./scaffold.js";
+const program = new Command();
+program
+    .name("create-pilotprojects-app")
+    .description("Scaffold a Pilotprojects monorepo boilerplate")
+    .version("0.1.0")
+    .argument("[project-name]", "Name of the project to create")
+    .action(async (projectNameArg) => {
+    console.log();
+    const config = await runPrompts(projectNameArg);
+    const destDir = path.resolve(process.cwd(), config.projectName);
+    if (await fs.pathExists(destDir)) {
+        const overwrite = await p.confirm({
+            message: `Directory ${pc.yellow(config.projectName)} already exists. Overwrite?`,
+            initialValue: false,
+        });
+        if (p.isCancel(overwrite) || !overwrite) {
+            p.cancel("Scaffolding cancelled.");
+            process.exit(0);
+        }
+        await fs.remove(destDir);
+    }
+    await fs.ensureDir(destDir);
+    try {
+        await scaffold(config, destDir);
+    }
+    catch (err) {
+        p.cancel(`Scaffolding failed: ${err.message}`);
+        await fs.remove(destDir);
+        process.exit(1);
+    }
+    p.outro([
+        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("mobile")
+            ? `  cp apps/mobile/.env.example apps/mobile/.env`
+            : "",
+        `  ${config.packageManager} run dev`,
+        "",
+        pc.dim("See docs/ for full setup instructions."),
+    ]
+        .filter(Boolean)
+        .join("\n"));
+});
+program.parse();

package/dist/prompts.js

@@ -0,0 +1,75 @@
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+export async function runPrompts(projectNameArg) {
+    p.intro(pc.bgCyan(pc.black(" create-pilotprojects-app ")));
+    const answers = await p.group({
+        projectName: () => p.text({
+            message: "What is your project name?",
+            placeholder: "my-app",
+            initialValue: projectNameArg ?? "",
+            validate: (v) => {
+                if (!v)
+                    return "Project name is required";
+                if (!/^[a-z0-9-]+$/.test(v))
+                    return "Use lowercase letters, numbers, and hyphens only";
+            },
+        }),
+        packageScope: ({ results }) => p.text({
+            message: "Package scope for internal packages?",
+            placeholder: `@${results.projectName}`,
+            initialValue: `@${results.projectName}`,
+            validate: (v) => {
+                if (!v)
+                    return "Scope is required";
+                if (!v.startsWith("@"))
+                    return "Scope must start with @";
+            },
+        }),
+        apps: () => p.multiselect({
+            message: "Which apps do you want to scaffold?",
+            options: [
+                { value: "web", label: "Web", hint: "Next.js 15 + tRPC + Drizzle" },
+                { value: "mobile", label: "Mobile", hint: "Expo SDK 52 + React Native" },
+            ],
+            initialValues: ["web", "mobile"],
+            required: true,
+        }),
+        designSystem: () => p.confirm({
+            message: "Include the default design system? (Tailwind + ShadCN web / NativeWind mobile)",
+            initialValue: true,
+        }),
+        sentry: () => p.confirm({
+            message: "Include Sentry for error monitoring?",
+            initialValue: true,
+        }),
+        resend: () => p.confirm({
+            message: "Include Resend for transactional email? (@repo/email + React Email templates)",
+            initialValue: true,
+        }),
+        posthog: () => p.confirm({
+            message: "Include PostHog for product analytics + feature flags?",
+            initialValue: false,
+        }),
+        googleAnalytics: ({ results }) => results.apps?.includes("web")
+            ? p.confirm({
+                message: "Include Google Analytics (GA4) on the web app?",
+                initialValue: false,
+            })
+            : Promise.resolve(false),
+        packageManager: () => p.select({
+            message: "Which package manager?",
+            options: [
+                { value: "pnpm", label: "pnpm", hint: "recommended" },
+                { value: "npm", label: "npm" },
+                { value: "yarn", label: "yarn" },
+            ],
+            initialValue: "pnpm",
+        }),
+    }, {
+        onCancel: () => {
+            p.cancel("Scaffolding cancelled.");
+            process.exit(0);
+        },
+    });
+    return answers;
+}

package/dist/scaffold.js

@@ -0,0 +1,84 @@
+import path from "path";
+import { fileURLToPath } from "url";
+import fs from "fs-extra";
+import * as p from "@clack/prompts";
+import { copyTemplate, makeVars } from "./helpers/copy.js";
+import { removeDeps } from "./helpers/package-json.js";
+import { installDeps, gitInit } from "./helpers/install.js";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const TEMPLATES_DIR = path.resolve(__dirname, "../templates");
+export async function scaffold(config, destDir) {
+    const vars = makeVars(config.projectName, config.packageScope);
+    const spin = p.spinner();
+    // ── 1. Base files (turbo.json, pnpm-workspace.yaml, root package.json, .gitignore) ──
+    spin.start("Copying base files…");
+    await copyTemplate(path.join(TEMPLATES_DIR, "base"), destDir, vars);
+    spin.stop("Base files copied");
+    // ── 2. Always-on shared packages ──
+    spin.start("Scaffolding shared packages…");
+    for (const pkg of ["api", "db", "auth", "validators", "config"]) {
+        await copyTemplate(path.join(TEMPLATES_DIR, "packages", pkg), path.join(destDir, "packages", pkg), vars);
+    }
+    spin.stop("Shared packages scaffolded");
+    // ── 3. Design system ──
+    if (config.designSystem) {
+        spin.start("Adding design system (@repo/ui)…");
+        await copyTemplate(path.join(TEMPLATES_DIR, "packages", "ui"), path.join(destDir, "packages", "ui"), vars);
+        spin.stop("Design system added");
+    }
+    // ── 4. Email ──
+    if (config.resend) {
+        spin.start("Adding Resend email package (@repo/email)…");
+        await copyTemplate(path.join(TEMPLATES_DIR, "packages", "email"), path.join(destDir, "packages", "email"), vars);
+        spin.stop("Email package added");
+    }
+    // ── 5. Web app ──
+    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);
+        if (!config.sentry) {
+            await removeDeps(path.join(destDir, "apps", "web"), ["@sentry/nextjs"]);
+            await fs.remove(path.join(destDir, "apps", "web", "sentry.client.config.ts"));
+            await fs.remove(path.join(destDir, "apps", "web", "sentry.server.config.ts"));
+            await fs.remove(path.join(destDir, "apps", "web", "sentry.edge.config.ts"));
+        }
+        if (!config.posthog) {
+            await removeDeps(path.join(destDir, "apps", "web"), ["posthog-js", "posthog-node"]);
+        }
+        if (!config.googleAnalytics) {
+            await removeDeps(path.join(destDir, "apps", "web"), ["@next/third-parties"]);
+        }
+        spin.stop("Web app scaffolded");
+    }
+    // ── 6. Mobile app ──
+    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);
+        if (!config.sentry) {
+            await removeDeps(path.join(destDir, "apps", "mobile"), ["@sentry/react-native"]);
+        }
+        if (!config.posthog) {
+            await removeDeps(path.join(destDir, "apps", "mobile"), ["posthog-react-native"]);
+        }
+        spin.stop("Mobile app scaffolded");
+    }
+    // ── 7. Update pnpm-workspace.yaml based on selected apps ──
+    await updateWorkspace(destDir, config);
+    // ── 8. Install dependencies ──
+    spin.start(`Installing dependencies with ${config.packageManager}…`);
+    await installDeps(destDir, config.packageManager);
+    spin.stop("Dependencies installed");
+    // ── 9. Git init ──
+    spin.start("Initialising git repository…");
+    await gitInit(destDir);
+    spin.stop("Git repository initialised");
+}
+async function updateWorkspace(destDir, config) {
+    const workspacePath = path.join(destDir, "pnpm-workspace.yaml");
+    const lines = ["packages:"];
+    if (config.apps.includes("web") || config.apps.includes("mobile")) {
+        lines.push('  - "apps/*"');
+    }
+    lines.push('  - "packages/*"');
+    await fs.outputFile(workspacePath, lines.join("\n") + "\n", "utf-8");
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "create-pilotprojects-app",
+  "version": "0.1.0",
+  "description": "CLI to scaffold the Pilotprojects monorepo boilerplate",
+  "keywords": [
+    "create",
+    "monorepo",
+    "nextjs",
+    "expo",
+    "trpc",
+    "supabase"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "create-pilotprojects-app": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "dependencies": {
+    "@clack/prompts": "^0.9.1",
+    "commander": "^12.1.0",
+    "execa": "^9.3.0",
+    "fs-extra": "^11.2.0",
+    "picocolors": "^1.1.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.5.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js"
+  }
+}

package/templates/apps/mobile/.env.example

@@ -0,0 +1,15 @@
+# Set APP_ENV to: development | uat | production
+APP_ENV=development
+
+# Supabase
+EXPO_PUBLIC_SUPABASE_URL=http://localhost:54321
+EXPO_PUBLIC_SUPABASE_ANON_KEY=
+
+# API (apps/web URL)
+EXPO_PUBLIC_API_URL=http://localhost:3000
+
+# Sentry (optional)
+EXPO_PUBLIC_SENTRY_DSN=
+
+# PostHog (optional)
+EXPO_PUBLIC_POSTHOG_KEY=

package/templates/apps/mobile/app/(auth)/login.tsx

@@ -0,0 +1,86 @@
+import { useState } from "react";
+import { View, Text, KeyboardAvoidingView, Platform, ScrollView, TouchableOpacity } from "react-native";
+
+import { supabase } from "@/lib/supabase";
+import { Button } from "{{PACKAGE_SCOPE}}/ui/native/button";
+import { Input } from "{{PACKAGE_SCOPE}}/ui/native/input";
+
+export default function LoginScreen() {
+  const [email, setEmail] = useState("");
+  const [password, setPassword] = useState("");
+  const [error, setError] = useState<string | null>(null);
+  const [loading, setLoading] = useState(false);
+
+  async function handleLogin() {
+    setLoading(true);
+    setError(null);
+
+    const { error } = await supabase.auth.signInWithPassword({ email, password });
+
+    if (error) setError(error.message);
+    setLoading(false);
+  }
+
+  return (
+    <KeyboardAvoidingView
+      behavior={Platform.OS === "ios" ? "padding" : "height"}
+      className="flex-1 bg-background"
+    >
+      <ScrollView
+        contentContainerStyle={{ flexGrow: 1 }}
+        keyboardShouldPersistTaps="handled"
+      >
+        <View className="flex-1 items-center justify-center px-6 py-16">
+          <View className="mb-10 items-center gap-2">
+            <View className="h-16 w-16 items-center justify-center rounded-2xl bg-primary">
+              <Text className="text-2xl font-bold text-primary-foreground">A</Text>
+            </View>
+            <Text className="text-2xl font-bold text-foreground">{{PROJECT_NAME}}</Text>
+            <Text className="text-sm text-muted-foreground">Sign in to continue</Text>
+          </View>
+
+          <View className="w-full gap-5">
+            <View className="gap-1.5">
+              <Text className="text-sm font-medium text-foreground">Email</Text>
+              <Input
+                placeholder="you@example.com"
+                value={email}
+                onChangeText={setEmail}
+                keyboardType="email-address"
+                autoCapitalize="none"
+              />
+            </View>
+
+            <View className="gap-1.5">
+              <View className="flex-row items-center justify-between">
+                <Text className="text-sm font-medium text-foreground">Password</Text>
+                <TouchableOpacity>
+                  <Text className="text-xs text-primary">Forgot password?</Text>
+                </TouchableOpacity>
+              </View>
+              <Input
+                placeholder="••••••••"
+                value={password}
+                onChangeText={setPassword}
+                secureTextEntry
+              />
+            </View>
+
+            {error && <Text className="text-sm text-destructive">{error}</Text>}
+
+            <Button onPress={handleLogin} disabled={loading} size="lg">
+              {loading ? "Signing in…" : "Sign in"}
+            </Button>
+          </View>
+
+          <View className="mt-8 flex-row items-center gap-1">
+            <Text className="text-sm text-muted-foreground">Don't have an account?</Text>
+            <TouchableOpacity>
+              <Text className="text-sm font-medium text-primary">Sign up</Text>
+            </TouchableOpacity>
+          </View>
+        </View>
+      </ScrollView>
+    </KeyboardAvoidingView>
+  );
+}

package/templates/apps/mobile/app/(tabs)/_layout.tsx

@@ -0,0 +1,10 @@
+import { Tabs } from "expo-router";
+
+export default function TabsLayout() {
+  return (
+    <Tabs screenOptions={{ tabBarActiveTintColor: "#3b82f6" }}>
+      <Tabs.Screen name="index"   options={{ title: "Home" }} />
+      <Tabs.Screen name="profile" options={{ title: "Profile" }} />
+    </Tabs>
+  );
+}

package/templates/apps/mobile/app/(tabs)/index.tsx

@@ -0,0 +1,30 @@
+import { View, Text, ScrollView } from "react-native";
+
+import { trpc } from "@/lib/trpc/client";
+import { Card, CardHeader, CardTitle, CardContent } from "{{PACKAGE_SCOPE}}/ui/native/card";
+
+export default function HomeScreen() {
+  const { data: user, isLoading } = trpc.user.me.useQuery();
+
+  return (
+    <ScrollView className="flex-1 bg-background">
+      <View className="p-6">
+        <Text className="mb-4 text-2xl font-bold text-foreground">Home</Text>
+        {isLoading ? (
+          <Text className="text-muted-foreground">Loading…</Text>
+        ) : (
+          <Card>
+            <CardHeader>
+              <CardTitle>Welcome back</CardTitle>
+            </CardHeader>
+            <CardContent>
+              <Text className="text-muted-foreground">
+                {user?.displayName ?? user?.email}
+              </Text>
+            </CardContent>
+          </Card>
+        )}
+      </View>
+    </ScrollView>
+  );
+}

package/templates/apps/mobile/app/_layout.tsx

@@ -0,0 +1,58 @@
+import "../global.css";
+
+import { useEffect, useState } from "react";
+import { Stack, useRouter, useSegments } from "expo-router";
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import * as Sentry from "@sentry/react-native";
+
+import { supabase } from "@/lib/supabase";
+import { trpc, makeTRPCClient } from "@/lib/trpc/client";
+
+if (process.env.EXPO_PUBLIC_SENTRY_DSN) {
+  Sentry.init({
+    dsn: process.env.EXPO_PUBLIC_SENTRY_DSN,
+    environment: process.env.APP_ENV ?? "development",
+    tracesSampleRate: 1.0,
+  });
+}
+
+const queryClient = new QueryClient({
+  defaultOptions: { queries: { staleTime: 60_000 } },
+});
+
+function AuthGate({ children }: { children: React.ReactNode }) {
+  const router = useRouter();
+  const segments = useSegments();
+
+  useEffect(() => {
+    const { data: { subscription } } = supabase.auth.onAuthStateChange((_event, session) => {
+      const inAuthGroup = segments[0] === "(auth)";
+
+      if (!session && !inAuthGroup) {
+        router.replace("/(auth)/login");
+      } else if (session && inAuthGroup) {
+        router.replace("/(tabs)");
+      }
+    });
+
+    return () => subscription.unsubscribe();
+  }, [segments]);
+
+  return <>{children}</>;
+}
+
+function RootLayout() {
+  const [trpcClient] = useState(() => makeTRPCClient());
+
+  return (
+    <trpc.Provider client={trpcClient} queryClient={queryClient}>
+      <QueryClientProvider client={queryClient}>
+        <AuthGate>
+          <Stack screenOptions={{ headerShown: false }} />
+        </AuthGate>
+      </QueryClientProvider>
+    </trpc.Provider>
+  );
+}
+
+export default Sentry.wrap(RootLayout);

package/templates/apps/mobile/app.config.ts

@@ -0,0 +1,73 @@
+import type { ExpoConfig, ConfigContext } from "expo/config";
+
+type AppEnv = "development" | "uat" | "production";
+
+const ENV = (process.env.APP_ENV ?? "development") as AppEnv;
+
+const config: Record<AppEnv, { name: string; bundleId: string; apiUrl: string }> = {
+  development: {
+    name:     "{{PROJECT_NAME}} (Dev)",
+    bundleId: "com.yourcompany.{{PACKAGE_SCOPE_SAFE}}.dev",
+    apiUrl:   "http://localhost:3000",
+  },
+  uat: {
+    name:     "{{PROJECT_NAME}} (UAT)",
+    bundleId: "com.yourcompany.{{PACKAGE_SCOPE_SAFE}}.uat",
+    apiUrl:   "https://uat.yourapp.com",
+  },
+  production: {
+    name:     "{{PROJECT_NAME}}",
+    bundleId: "com.yourcompany.{{PACKAGE_SCOPE_SAFE}}",
+    apiUrl:   "https://yourapp.com",
+  },
+};
+
+const { name, bundleId, apiUrl } = config[ENV];
+
+export default ({ config: base }: ConfigContext): ExpoConfig => ({
+  ...base,
+  name,
+  slug: "{{PACKAGE_SCOPE_SAFE}}",
+  version: "1.0.0",
+  orientation: "portrait",
+  scheme: "{{PACKAGE_SCOPE_SAFE}}",
+  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",
+    "@sentry/react-native/expo",
+  ],
+  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" },
+});

package/templates/apps/mobile/babel.config.js

@@ -0,0 +1,9 @@
+module.exports = function (api) {
+  api.cache(true);
+  return {
+    presets: [
+      ["babel-preset-expo", { jsxImportSource: "nativewind" }],
+      "nativewind/babel",
+    ],
+  };
+};

package/templates/apps/mobile/eas.json

@@ -0,0 +1,48 @@
+{
+  "cli": { "version": ">= 12.0.0" },
+  "build": {
+    "development": {
+      "developmentClient": true,
+      "distribution": "internal",
+      "channel": "development",
+      "ios": { "simulator": true }
+    },
+    "uat": {
+      "distribution": "internal",
+      "channel": "uat",
+      "ios": {
+        "buildConfiguration": "Release",
+        "credentialsSource": "remote"
+      },
+      "android": {
+        "buildType": "apk",
+        "credentialsSource": "remote"
+      }
+    },
+    "production": {
+      "distribution": "store",
+      "channel": "production",
+      "ios": {
+        "buildConfiguration": "Release",
+        "credentialsSource": "remote"
+      },
+      "android": {
+        "buildType": "app-bundle",
+        "credentialsSource": "remote"
+      }
+    }
+  },
+  "submit": {
+    "production": {
+      "ios": {
+        "appleId": "",
+        "ascAppId": "",
+        "appleTeamId": ""
+      },
+      "android": {
+        "serviceAccountKeyPath": "./google-service-account.json",
+        "track": "internal"
+      }
+    }
+  }
+}