create-m5kdev 0.32.8 → 0.34.0

package/templates/minimal-app/README.md.tpl

@@ -4,9 +4,10 @@
 
 ## Workspace
 
-- `apps/shared` contains shared contracts and constants for the app.
+- `apps/shared` contains shared contracts, constants, and the product Deploy home (Dockerfile, `fly.toml`).
 - `apps/server` contains the Express, Better Auth, Drizzle, and tRPC backend.
 - `apps/webapp` contains the Vite, React Router, HeroUI, and `nuqs` frontend.
+- `apps/landing` contains the public marketing site (one page) and its Fly adapter.
 - `apps/email` contains the email templates and local delivery registry used by the starter.
 
 ## Getting Started
@@ -26,26 +27,56 @@ Database tables are registered by hand in `apps/server/src/schema.ts`; after cha
 - Email: `admin@{{APP_SLUG}}.local`
 - Password: `password1234`
 
-## Typical Commands
+## Typical Commands
 
 ```sh
 pnpm dev
 pnpm build
 pnpm check-types
-pnpm lint
-```
-
-## Managed framework updates
-
-This app records its generated baseline in `.m5kdev.json`. The updater is run
-explicitly from the package registry and is not installed as an app dependency:
-
-```sh
-pnpm dlx create-m5kdev@<version> doctor
-pnpm dlx create-m5kdev@<version> update --dry-run
-pnpm dlx create-m5kdev@<version> update
-```
-
-Use an exact target version in CI and when coordinating an upgrade. Existing
-projects without `.m5kdev.json` can enroll at their current compatible baseline
-with `pnpm dlx create-m5kdev@<version> init`.
+pnpm lint
+```
+
+## Managed framework updates
+
+This app records its generated baseline in `.m5kdev.json`. The updater is run
+explicitly from the package registry and is not installed as an app dependency:
+
+```sh
+pnpm dlx create-m5kdev@<version> doctor
+pnpm dlx create-m5kdev@<version> update --dry-run
+pnpm dlx create-m5kdev@<version> update
+```
+
+Use an exact target version in CI and when coordinating an upgrade. Existing
+projects without `.m5kdev.json` can enroll at their current compatible baseline
+with `pnpm dlx create-m5kdev@<version> init`.
+
+## Deploy (Fly.io)
+
+The Dockerfile is the portable image. Fly is the adapter this starter ships —
+`fly.toml` is ignored by `create-m5kdev update` so your app name and region stay
+yours.
+
+`.env*` files are excluded from the image. Copy the examples, then pass values
+as Fly **build secrets** (baked into the SPA at image build) and **runtime
+secrets** (`REDIS_URL`, `DATABASE_URL`, auth).
+
+```sh
+cp apps/shared/.env.production.example apps/shared/.env.production
+cp apps/landing/.env.production.example apps/landing/.env.production
+# fill in URLs, BETTER_AUTH_SECRET, REDIS_URL, …
+
+fly apps create {{APP_SLUG}}-app
+fly apps create {{APP_SLUG}}-landing
+fly volumes create libsql_data --app {{APP_SLUG}}-app --region iad --size 1
+pnpm app:secrets
+pnpm landing:secrets
+pnpm app:deploy
+pnpm landing:deploy
+```
+
+`app:deploy` / `landing:deploy` read that app’s `.env.production` and forward
+every key as `fly deploy --build-secret`. A missing env file errors with a
+copy-the-example message. Product data lives on the `libsql_data` volume at
+`/app/data` (`DATABASE_URL=file:/app/data/local.db`). Redis is a runtime secret,
+not an image layer.

package/templates/minimal-app/apps/e2e/package.json.tpl

@@ -1,23 +1,23 @@
-{
-  "name": "{{PACKAGE_SCOPE}}/e2e",
-  "version": "0.0.0",
-  "private": true,
-  "scripts": {
-    "build": "tsc --noEmit",
-    "lint": "biome check .",
-    "lint:fix": "biome check . --write",
-    "check-types": "tsc --noEmit",
-    "test:e2e": "playwright test",
-    "test:e2e:expo": "playwright test --config playwright.expo.config.ts --headed"
-  },
-  "devDependencies": {
-    "@m5kdev/backend": "catalog:",
-    "@m5kdev/commons": "catalog:",
-    "@m5kdev/config": "catalog:",
-    "@playwright/test": "catalog:",
-    "{{PACKAGE_SCOPE}}/shared": "workspace:*",
-    "@trpc/client": "catalog:",
-    "@types/node": "catalog:",
-    "typescript": "catalog:"
-  }
-}
+{
+  "name": "{{PACKAGE_SCOPE}}/e2e",
+  "version": "0.0.0",
+  "private": true,
+  "scripts": {
+    "build": "tsc --noEmit",
+    "lint": "biome check .",
+    "lint:fix": "biome check . --write",
+    "check-types": "tsc --noEmit",
+    "test:e2e": "playwright test",
+    "test:e2e:expo": "playwright test --config playwright.expo.config.ts --headed"
+  },
+  "devDependencies": {
+    "@m5kdev/backend": "catalog:m5kdev",
+    "@m5kdev/commons": "catalog:m5kdev",
+    "@m5kdev/config": "catalog:m5kdev",
+    "@playwright/test": "catalog:m5kdev",
+    "{{PACKAGE_SCOPE}}/shared": "workspace:*",
+    "@trpc/client": "catalog:m5kdev",
+    "@types/node": "catalog:m5kdev",
+    "typescript": "catalog:m5kdev"
+  }
+}

package/templates/minimal-app/apps/e2e/playwright.config.ts.tpl

@@ -1,39 +1,51 @@
-import { defineConfig, devices } from "@playwright/test";
-import { BASE_URLS, serverWebServer, webappWebServer } from "./servers";
-
-export default defineConfig({
-  testDir: "./tests",
-  fullyParallel: false,
-  workers: 1,
-  forbidOnly: Boolean(process.env.CI),
-  retries: process.env.CI ? 2 : 0,
-  reporter: [["list"], ["html", { open: "never" }]],
-  use: {
-    trace: "on-first-retry",
-  },
-  webServer: [
-    serverWebServer("standard"),
-    webappWebServer("standard"),
-    serverWebServer("waitlist"),
-    webappWebServer("waitlist"),
-  ],
-  projects: [
-    {
-      name: "standard",
-      // exact filenames — a broad regex would also match the expo-*.spec files
-      testMatch: ["standard.spec.ts", "email.spec.ts"],
-      use: {
-        ...devices["Desktop Chrome"],
-        baseURL: BASE_URLS.standard,
-      },
-    },
-    {
-      name: "waitlist",
-      testMatch: ["waitlist.spec.ts", "email.spec.ts"],
-      use: {
-        ...devices["Desktop Chrome"],
-        baseURL: BASE_URLS.waitlist,
-      },
-    },
-  ],
-});
+import { defineConfig, devices } from "@playwright/test";
+import { BASE_URLS, serverWebServer, webappWebServer } from "./servers";
+
+export default defineConfig({
+  testDir: "./tests",
+  fullyParallel: false,
+  workers: 1,
+  forbidOnly: Boolean(process.env.CI),
+  retries: process.env.CI ? 2 : 0,
+  reporter: [["list"], ["html", { open: "never" }]],
+  use: {
+    trace: "on-first-retry",
+  },
+  webServer: [
+    serverWebServer("standard"),
+    webappWebServer("standard"),
+    serverWebServer("waitlist"),
+    webappWebServer("waitlist"),
+  ],
+  projects: [
+    {
+      name: "standard",
+      // exact filenames — a broad regex would also match the expo-*.spec files
+      testMatch: [
+        "standard.spec.ts",
+        "email.spec.ts",
+        // m5k:ai:start
+        "conversation.spec.ts",
+        // m5k:ai:end
+        // m5k:files:start
+        "files.spec.ts",
+        // m5k:files:end
+        // m5k:workflows:start
+        "workflow.spec.ts",
+        // m5k:workflows:end
+      ],
+      use: {
+        ...devices["Desktop Chrome"],
+        baseURL: BASE_URLS.standard,
+      },
+    },
+    {
+      name: "waitlist",
+      testMatch: ["waitlist.spec.ts", "email.spec.ts"],
+      use: {
+        ...devices["Desktop Chrome"],
+        baseURL: BASE_URLS.waitlist,
+      },
+    },
+  ],
+});

package/templates/minimal-app/apps/e2e/playwright.expo.config.ts.tpl

@@ -1,38 +1,38 @@
-import { defineConfig, devices } from "@playwright/test";
-import { EXPO_BASE_URLS, expoWebServer, serverWebServer } from "./servers";
-
-export default defineConfig({
-  testDir: "./tests",
-  fullyParallel: false,
-  workers: 1,
-  forbidOnly: Boolean(process.env.CI),
-  retries: process.env.CI ? 2 : 0,
-  reporter: [["list"], ["html", { open: "never" }]],
-  use: {
-    trace: "on-first-retry",
-  },
-  webServer: [
-    serverWebServer("standard", { expo: true }),
-    expoWebServer("standard"),
-    serverWebServer("waitlist", { expo: true }),
-    expoWebServer("waitlist"),
-  ],
-  projects: [
-    {
-      name: "expo-standard",
-      testMatch: /.*expo-standard\.spec\.ts/,
-      use: {
-        ...devices["Desktop Chrome"],
-        baseURL: EXPO_BASE_URLS.standard,
-      },
-    },
-    {
-      name: "expo-waitlist",
-      testMatch: /.*expo-waitlist\.spec\.ts/,
-      use: {
-        ...devices["Desktop Chrome"],
-        baseURL: EXPO_BASE_URLS.waitlist,
-      },
-    },
-  ],
-});
+import { defineConfig, devices } from "@playwright/test";
+import { EXPO_BASE_URLS, expoWebServer, serverWebServer } from "./servers";
+
+export default defineConfig({
+  testDir: "./tests",
+  fullyParallel: false,
+  workers: 1,
+  forbidOnly: Boolean(process.env.CI),
+  retries: process.env.CI ? 2 : 0,
+  reporter: [["list"], ["html", { open: "never" }]],
+  use: {
+    trace: "on-first-retry",
+  },
+  webServer: [
+    serverWebServer("standard", { expo: true }),
+    expoWebServer("standard"),
+    serverWebServer("waitlist", { expo: true }),
+    expoWebServer("waitlist"),
+  ],
+  projects: [
+    {
+      name: "expo-standard",
+      testMatch: /.*expo-standard\.spec\.ts/,
+      use: {
+        ...devices["Desktop Chrome"],
+        baseURL: EXPO_BASE_URLS.standard,
+      },
+    },
+    {
+      name: "expo-waitlist",
+      testMatch: /.*expo-waitlist\.spec\.ts/,
+      use: {
+        ...devices["Desktop Chrome"],
+        baseURL: EXPO_BASE_URLS.waitlist,
+      },
+    },
+  ],
+});

package/templates/minimal-app/apps/e2e/servers.ts.tpl

@@ -1,112 +1,136 @@
-/**
- * Shared webServer definitions for the Playwright configs. Each profile runs
- * an isolated stack: own port pair, own SQLite file, own email output dir, and
- * own Redis DB index (queue names are identical across profiles — sharing a
- * Redis DB would let one profile's workers consume the other's jobs).
- */
-
-export type E2EProfile = "standard" | "waitlist";
-
-const SERVER_FILTER = "pnpm --filter {{PACKAGE_SCOPE}}/server exec";
-const WEBAPP_FILTER = "pnpm --filter {{PACKAGE_SCOPE}}/webapp exec";
-
-const SIGNOZ_OTLP_ENDPOINT =
-  process.env.OTEL_EXPORTER_OTLP_ENDPOINT ??
-  "https://signoz-ingester-production-9090.up.railway.app";
-
-const PORTS: Record<E2EProfile, { web: number; server: number; expoWeb: number; expoServer: number; redisDb: number; expoRedisDb: number }> = {
-  standard: { web: 15173, server: 18180, expoWeb: 15183, expoServer: 18182, redisDb: 1, expoRedisDb: 3 },
-  waitlist: { web: 15174, server: 18181, expoWeb: 15184, expoServer: 18183, redisDb: 2, expoRedisDb: 4 },
-};
-
-function serverEnv(profile: E2EProfile, expo: boolean): Record<string, string> {
-  const ports = PORTS[profile];
-  const serverPort = expo ? ports.expoServer : ports.server;
-  const webPort = expo ? ports.expoWeb : ports.web;
-  const suffix = expo ? `${profile}-expo` : profile;
-  return {
-    PORT: String(serverPort),
-    VITE_SERVER_URL: `http://127.0.0.1:${serverPort}`,
-    VITE_APP_URL: `http://127.0.0.1:${webPort}`,
-    DATABASE_URL: `file:./.e2e/${suffix}.db`,
-    EMAIL_OUTPUT_DIRECTORY: `.e2e/emails-${suffix}`,
-    PROVISIONED_EMAIL_DOMAIN: "provisioned.auth-e2e.local",
-    REDIS_URL: `redis://127.0.0.1:6379/${expo ? PORTS[profile].expoRedisDb : PORTS[profile].redisDb}`,
-    VITE_ENABLE_WAITLIST: profile === "waitlist" ? "true" : "false",
-    AUTH_E2E_PROFILE: profile,
-    BETTER_AUTH_SECRET: "auth-e2e-local-secret-auth-e2e-local-secret",
-    SYSTEM_NOTIFICATION_EMAIL: "ops@auth-e2e.local",
-    NODE_ENV: "development",
-    // hermetic: a real key in the invoking shell would flip email mode to
-    // "send" and the stored-email assertions would find nothing
-    RESEND_API_KEY: "",
-    ...(process.env.OTEL_SDK_DISABLED === "true"
-      ? {}
-      : {
-          OTEL_EXPORTER_OTLP_ENDPOINT: SIGNOZ_OTLP_ENDPOINT,
-          OTEL_EXPORTER_OTLP_PROTOCOL: "http/protobuf",
-          OTEL_SERVICE_NAME: `starter-server-e2e-${suffix}`,
-          OTEL_RESOURCE_ATTRIBUTES: `deployment.environment=e2e,e2e.profile=${profile},e2e.platform=${expo ? "expo" : "web"}`,
-        }),
-  };
-}
-
-export function serverWebServer(profile: E2EProfile, { expo = false } = {}) {
-  const env = serverEnv(profile, expo);
-  return {
-    command: [
-      `${SERVER_FILTER} tsx drizzle/reset.ts`,
-      `${SERVER_FILTER} drizzle-kit migrate`,
-      `${SERVER_FILTER} tsx drizzle/seed.e2e.ts`,
-      `${SERVER_FILTER} tsx src/index.ts`,
-    ].join(" && "),
-    url: `${env.VITE_SERVER_URL}/__emails`,
-    reuseExistingServer: !process.env.CI,
-    timeout: 120_000,
-    env,
-  };
-}
-
-export function webappWebServer(profile: E2EProfile) {
-  const ports = PORTS[profile];
-  const env = serverEnv(profile, false);
-  return {
-    command: `${WEBAPP_FILTER} vite --host 127.0.0.1 --port ${ports.web}`,
-    url: `http://127.0.0.1:${ports.web}`,
-    reuseExistingServer: !process.env.CI,
-    timeout: 120_000,
-    env: {
-      VITE_SERVER_URL: env.VITE_SERVER_URL,
-      VITE_APP_URL: env.VITE_APP_URL,
-      VITE_ENABLE_WAITLIST: env.VITE_ENABLE_WAITLIST,
-    },
-  };
-}
-
-export function expoWebServer(profile: E2EProfile) {
-  const ports = PORTS[profile];
-  const env = serverEnv(profile, true);
-  return {
-    command: `pnpm --filter {{PACKAGE_SCOPE}}/expo exec expo start --web --port ${ports.expoWeb} --host localhost`,
-    url: `http://127.0.0.1:${ports.expoWeb}`,
-    reuseExistingServer: !process.env.CI,
-    timeout: 180_000,
-    env: {
-      EXPO_PUBLIC_SERVER_URL: env.VITE_SERVER_URL,
-      EXPO_PUBLIC_APP_URL: `http://127.0.0.1:${ports.expoWeb}`,
-      EXPO_PUBLIC_ENABLE_WAITLIST: env.VITE_ENABLE_WAITLIST,
-      EXPO_NO_TELEMETRY: "1",
-      BROWSER: "none",
-    },
-  };
-}
-
-export const BASE_URLS: Record<E2EProfile, string> = {
-  standard: `http://127.0.0.1:${PORTS.standard.web}`,
-  waitlist: `http://127.0.0.1:${PORTS.waitlist.web}`,
-};
-
-export const EXPO_BASE_URLS: Record<E2EProfile, string> = {
-  standard: `http://127.0.0.1:${PORTS.standard.expoWeb}`,
-  waitlist: `http://127.0.0.1:${PORTS.waitlist.expoWeb}`,
-};
+/**
+ * Shared webServer definitions for the Playwright configs. Each profile runs
+ * an isolated stack: own port pair, own SQLite file, own email output dir, and
+ * own Redis DB index (queue names are identical across profiles — sharing a
+ * Redis DB would let one profile's workers consume the other's jobs).
+ */
+
+export type E2EProfile = "standard" | "waitlist";
+
+const SERVER_FILTER = "pnpm --filter {{PACKAGE_SCOPE}}/server exec";
+const WEBAPP_FILTER = "pnpm --filter {{PACKAGE_SCOPE}}/webapp exec";
+
+const SIGNOZ_OTLP_ENDPOINT =
+  process.env.OTEL_EXPORTER_OTLP_ENDPOINT ??
+  "https://signoz-ingester-production-9090.up.railway.app";
+
+const PORTS: Record<
+  E2EProfile,
+  {
+    web: number;
+    server: number;
+    expoWeb: number;
+    expoServer: number;
+    redisDb: number;
+    expoRedisDb: number;
+  }
+> = {
+  standard: {
+    web: 15173,
+    server: 18180,
+    expoWeb: 15183,
+    expoServer: 18182,
+    redisDb: 1,
+    expoRedisDb: 3,
+  },
+  waitlist: {
+    web: 15174,
+    server: 18181,
+    expoWeb: 15184,
+    expoServer: 18183,
+    redisDb: 2,
+    expoRedisDb: 4,
+  },
+};
+
+function serverEnv(profile: E2EProfile, expo: boolean): Record<string, string> {
+  const ports = PORTS[profile];
+  const serverPort = expo ? ports.expoServer : ports.server;
+  const webPort = expo ? ports.expoWeb : ports.web;
+  const suffix = expo ? `${profile}-expo` : profile;
+  return {
+    PORT: String(serverPort),
+    VITE_SERVER_URL: `http://127.0.0.1:${serverPort}`,
+    VITE_APP_URL: `http://127.0.0.1:${webPort}`,
+    DATABASE_URL: `file:./.e2e/${suffix}.db`,
+    EMAIL_OUTPUT_DIRECTORY: `.e2e/emails-${suffix}`,
+    PROVISIONED_EMAIL_DOMAIN: "provisioned.auth-e2e.local",
+    REDIS_URL: `redis://127.0.0.1:6379/${expo ? PORTS[profile].expoRedisDb : PORTS[profile].redisDb}`,
+    VITE_ENABLE_WAITLIST: profile === "waitlist" ? "true" : "false",
+    AUTH_E2E_PROFILE: profile,
+    BETTER_AUTH_SECRET: "auth-e2e-local-secret-auth-e2e-local-secret",
+    SYSTEM_NOTIFICATION_EMAIL: "ops@auth-e2e.local",
+    NODE_ENV: "development",
+    // hermetic: a real key in the invoking shell would flip email mode to
+    // "send" and the stored-email assertions would find nothing
+    RESEND_API_KEY: "",
+    ...(process.env.OTEL_SDK_DISABLED === "true"
+      ? {}
+      : {
+          OTEL_EXPORTER_OTLP_ENDPOINT: SIGNOZ_OTLP_ENDPOINT,
+          OTEL_EXPORTER_OTLP_PROTOCOL: "http/protobuf",
+          OTEL_SERVICE_NAME: `starter-server-e2e-${suffix}`,
+          OTEL_RESOURCE_ATTRIBUTES: `deployment.environment=e2e,e2e.profile=${profile},e2e.platform=${expo ? "expo" : "web"}`,
+        }),
+  };
+}
+
+export function serverWebServer(profile: E2EProfile, { expo = false } = {}) {
+  const env = serverEnv(profile, expo);
+  return {
+    command: [
+      `${SERVER_FILTER} tsx db.ts reset`,
+      `${SERVER_FILTER} drizzle-kit migrate`,
+      `${SERVER_FILTER} tsx db.e2e.ts seed`,
+      `${SERVER_FILTER} tsx src/index.ts`,
+    ].join(" && "),
+    url: `${env.VITE_SERVER_URL}/__emails`,
+    reuseExistingServer: !process.env.CI,
+    timeout: 120_000,
+    env,
+  };
+}
+
+export function webappWebServer(profile: E2EProfile) {
+  const ports = PORTS[profile];
+  const env = serverEnv(profile, false);
+  return {
+    command: `${WEBAPP_FILTER} vite --host 127.0.0.1 --port ${ports.web}`,
+    url: `http://127.0.0.1:${ports.web}`,
+    reuseExistingServer: !process.env.CI,
+    timeout: 120_000,
+    env: {
+      VITE_SERVER_URL: env.VITE_SERVER_URL,
+      VITE_APP_URL: env.VITE_APP_URL,
+      VITE_ENABLE_WAITLIST: env.VITE_ENABLE_WAITLIST,
+    },
+  };
+}
+
+export function expoWebServer(profile: E2EProfile) {
+  const ports = PORTS[profile];
+  const env = serverEnv(profile, true);
+  return {
+    command: `pnpm --filter {{PACKAGE_SCOPE}}/expo exec expo start --web --port ${ports.expoWeb} --host localhost`,
+    url: `http://127.0.0.1:${ports.expoWeb}`,
+    reuseExistingServer: !process.env.CI,
+    timeout: 180_000,
+    env: {
+      EXPO_PUBLIC_SERVER_URL: env.VITE_SERVER_URL,
+      EXPO_PUBLIC_APP_URL: `http://127.0.0.1:${ports.expoWeb}`,
+      EXPO_PUBLIC_ENABLE_WAITLIST: env.VITE_ENABLE_WAITLIST,
+      EXPO_NO_TELEMETRY: "1",
+      BROWSER: "none",
+    },
+  };
+}
+
+export const BASE_URLS: Record<E2EProfile, string> = {
+  standard: `http://127.0.0.1:${PORTS.standard.web}`,
+  waitlist: `http://127.0.0.1:${PORTS.waitlist.web}`,
+};
+
+export const EXPO_BASE_URLS: Record<E2EProfile, string> = {
+  standard: `http://127.0.0.1:${PORTS.standard.expoWeb}`,
+  waitlist: `http://127.0.0.1:${PORTS.waitlist.expoWeb}`,
+};

package/templates/minimal-app/apps/e2e/tests/conversation.spec.ts.tpl

@@ -0,0 +1,22 @@
+import { expect, test } from "@playwright/test";
+import { clearEmails, login, signUp, verifyLatestEmail } from "./helpers";
+
+const profile = "standard" as const;
+
+test.beforeEach(async ({ request }) => {
+  await clearEmails(request, profile);
+});
+
+test("open the agent conversation and see an empty transcript", async ({ page, request }) => {
+  const email = `conversation.${Date.now()}@auth-e2e.local`;
+  const password = "password1234";
+
+  await signUp(page, email, password);
+  await verifyLatestEmail(request, profile, email);
+  await login(page, email, password);
+
+  await page.goto("/conversation");
+  await expect(page.getByTestId("conversation-route")).toBeVisible();
+  await expect(page.getByText("No messages yet")).toBeVisible();
+  await expect(page.getByRole("button", { name: "Send" })).toBeVisible();
+});