create-m5kdev 0.38.15 → 0.38.17

package/templates/minimal-app/.gitignore.tpl

@@ -6,5 +6,6 @@ coverage
 *.db
 *.db-*
 apps/server/.emails
+apps/landing/.env
 apps/shared/.env
 **/.env.production

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

@@ -8,12 +8,20 @@
 
 ## Repository Structure
 
+- `apps/landing` holds the public one-page site and its Fly adapter.
+// m5k:server:start
 - `apps/shared` holds shared Zod schemas, constants, and the product Deploy home.
 - `apps/server` holds the backend composition root, modules, auth wiring, and database scripts.
-- `apps/webapp` holds the React app shell, routes, providers, and the `posts` feature.
-- `apps/landing` holds the public one-page site and its Fly adapter.
 - `apps/email` holds the email templates used by auth flows and local email delivery.
+// m5k:server:end
+// m5k:webapp:start
+- `apps/webapp` holds the React app shell, routes, providers, and the `posts` feature.
+// m5k:webapp:end
+// m5k:expo:start
+- `apps/expo` holds the Expo (React Native) client.
+// m5k:expo:end
 
+// m5k:server:start
 ## Backend Conventions
 
 - Keep repository, service, and transport layers separate inside each module.
@@ -26,7 +34,9 @@
 - Renaming a dependency method, repackaging arguments, constructing a prompt, or forwarding actor/context data alone does not justify a service wrapper.
 - Do not create Drizzle migrations by hand. Use the scaffolded config and your project migration workflow later if you need generated migrations.
 - Server event: emit through Auth from Workflow job handlers (and similar background work) when the UI must refresh a change the triggering mutation did not return. See `.cursor/rules/server-event-emit.mdc`.
+// m5k:server:end
 
+// m5k:webapp:start
 ## Frontend Conventions
 
 - Keep the app shell shape: `NuqsAdapter` + `BrowserRouter` + `Providers`.
@@ -45,3 +55,5 @@
 - Forms are uncontrolled HeroUI `Form` + `TextField`/`TextArea` with native HTML validation (`isRequired`, `type`, `minLength`) and `FieldError`; read values from `FormData` on submit. Never add form libraries (react-hook-form, formik). Validation that HTML cannot express (e.g. confirm-password) happens in the submit handler.
 - All user-facing copy goes through i18next (`useTranslation`); keys live in `apps/webapp/translations/`.
 - The `posts` feature (`apps/webapp/src/modules/posts/`) is the reference implementation for these conventions; see `.cursor/rules/frontend-*.mdc` for the detailed guides.
+// m5k:webapp:end
+

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

@@ -11,7 +11,9 @@ This is a pnpm + Turborepo monorepo built on the **m5kdev framework**:
 - `@m5kdev/backend` — backend kernel: Express, Better Auth, Drizzle (LibSQL), and tRPC. Apps compose it via `createBackendApp(config, [modules])`.
 - `@m5kdev/commons` — shared runtime utilities and contracts.
 - `@m5kdev/config` — configuration loading and validation.
+// m5k:server:start
 - `@m5kdev/email` — email rendering and local delivery used by auth flows.
+// m5k:server:end
 // m5k:webapp:start
 - `@m5kdev/frontend` — framework-level React providers (`AppConfigProvider`, `AppTrpcQueryProvider`) and hooks.
 - `@m5kdev/web-ui` — web UI components built on HeroUI v3.
@@ -21,16 +23,20 @@ The framework owns the plumbing (auth, database wiring, tRPC composition, permis
 
 ## Workspace
 
+// m5k:server:start
 - `apps/shared` — shared Zod schemas, constants, and the `.env` file every app reads.
 - `apps/server` — backend composition root (`src/app.ts`), app modules (`src/modules/`), hand-registered table list (`src/schema.ts`), and Drizzle scripts.
+// m5k:server:end
 // m5k:webapp:start
 - `apps/webapp` — Vite + React 19 frontend: app shell, routes, providers, and feature modules.
 // m5k:webapp:end
 // m5k:expo:start
 - `apps/expo` — Expo (React Native) app sharing the same server and shared contracts.
 // m5k:expo:end
-- `apps/landing` — public one-page site (app name, pitch, CTA) with its own Dockerfile and `fly.toml`.
+- `apps/landing` — public one-page site (app name, pitch) with its own Dockerfile and `fly.toml`.
+// m5k:server:start
 - `apps/email` — email templates and the local delivery registry.
+// m5k:server:end
 // m5k:test-harness:start
 - `apps/e2e` — Playwright end-to-end tests; the server exposes a test-harness module for them.
 // m5k:test-harness:end
@@ -44,6 +50,7 @@ pnpm lint         # biome check
 pnpm lint:fix     # biome check --write
 pnpm check-types  # tsc --noEmit everywhere
 ```
+// m5k:server:start
 
 Database (Drizzle, run from the repo root):
 
@@ -62,7 +69,9 @@ End-to-end tests: `pnpm --filter ./apps/e2e test:e2e` (Playwright).
 // m5k:test-harness:end
 
 The local database is a LibSQL file; local auth emails are written to `apps/server/.emails`. Demo login: `admin@{{APP_SLUG}}.local` / `password1234`.
+// m5k:server:end
 
+// m5k:server:start
 ## Framework Architecture
 
 ### Backend: kernel + modules
@@ -131,3 +140,5 @@ The framework's detailed conventions live in `.cursor/rules/*.mdc`. Cursor appli
 // m5k:webapp:end
 
 `AGENTS.md` (repo root and per-app) carries a compact summary of the same conventions for other agents; this file plus the guides above are the authoritative version for Claude.
+// m5k:server:end
+

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

@@ -4,19 +4,32 @@
 
 ## Workspace
 
+- `apps/landing` contains the public marketing site (one page) and its Fly adapter.
+// m5k:server:start
 - `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.
+// m5k:server:end
+// m5k:webapp:start
+- `apps/webapp` contains the Vite, React Router, HeroUI, and `nuqs` frontend.
+// m5k:webapp:end
+// m5k:expo:start
+- `apps/expo` contains the Expo (React Native) client.
+// m5k:expo:end
 
 ## Getting Started
 
 ```sh
 pnpm install
+pnpm dev
+```
+// m5k:server:start
+
+Then migrate and seed the local database:
+
+```sh
 pnpm --filter ./apps/server drizzle:migrate
 pnpm --filter ./apps/server drizzle:seed
-pnpm dev
 ```
 
 The starter uses a local LibSQL file by default and writes local auth emails to `apps/server/.emails`.
@@ -26,6 +39,7 @@ Database tables are registered by hand in `apps/server/src/schema.ts`; after cha
 
 - Email: `admin@{{APP_SLUG}}.local`
 - Password: `password1234`
+// m5k:server:end
 
 ## Typical Commands
 
@@ -58,26 +72,30 @@ The Dockerfile is the portable image. Fly is the adapter this starter ships —
 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).
+as Fly **build secrets** and **runtime secrets**.
 
 ```sh
-cp apps/shared/.env.production.example apps/shared/.env.production
 cp apps/landing/.env.production.example apps/landing/.env.production
+// m5k:server:start
+cp apps/shared/.env.production.example apps/shared/.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
+// m5k:server:end
+fly apps create {{APP_SLUG}}-landing
+pnpm landing:secrets
 pnpm landing:deploy
 ```
 
-`app:deploy` / `landing:deploy` read that app’s `.env.production` and forward
-every key as `fly deploy --build-secret` via Kernel bins
-(`m5kdev-fly-deploy` / `m5kdev-fly-secrets`). 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.
+`landing:deploy` reads that app’s `.env.production` and forwards every key as
+`fly deploy --build-secret` via Kernel bins (`m5kdev-fly-deploy` /
+`m5kdev-fly-secrets`). A missing env file errors with a copy-the-example
+message.
+// m5k:server:start
+`app:deploy` does the same for the product image. 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.
+// m5k:server:end

package/templates/minimal-app/apps/landing/.env.example.tpl

@@ -0,0 +1 @@
+VITE_APP_NAME={{APP_NAME}}

package/templates/minimal-app/apps/landing/.env.tpl

@@ -0,0 +1 @@
+VITE_APP_NAME={{APP_NAME}}

package/templates/minimal-app/apps/landing/src/LandingPage.tsx.tpl

@@ -1,8 +1,7 @@
-import { Button, Card } from "@heroui/react";
+import { Card } from "@heroui/react";
 
 export function LandingPage() {
   const appName = import.meta.env.VITE_APP_NAME ?? "{{APP_NAME}}";
-  const appUrl = import.meta.env.VITE_APP_URL ?? "http://localhost:5173";
 
   return (
     <main className="relative flex min-h-dvh flex-col items-center justify-center overflow-hidden px-6 py-16">
@@ -15,7 +14,7 @@ export function LandingPage() {
         className="pointer-events-none absolute inset-0 opacity-[0.12] [background-image:repeating-linear-gradient(0deg,transparent,transparent_23px,var(--color-rule)_24px)]"
       />
       <Card className="relative max-w-xl border border-[var(--color-rule)] bg-[color-mix(in_oklch,var(--color-paper)_92%,white)] shadow-none">
-        <Card.Header className="grid gap-4 p-8 pb-4 sm:p-10 sm:pb-4">
+        <Card.Header className="grid gap-4 p-8 sm:p-10">
           <p className="text-xs font-medium tracking-[0.28em] text-[color-mix(in_oklch,var(--color-ink)_55%,transparent)] uppercase">
             Public site
           </p>
@@ -23,14 +22,9 @@ export function LandingPage() {
             {appName}
           </Card.Title>
           <Card.Description className="max-w-md text-base leading-relaxed text-[color-mix(in_oklch,var(--color-ink)_72%,transparent)]">
-            An AI SaaS workspace. Sign in on the app when you are ready to write, ship, and operate.
+            An AI SaaS workspace.
           </Card.Description>
         </Card.Header>
-        <Card.Footer className="p-8 pt-2 sm:p-10 sm:pt-2">
-          <Button variant="primary" onPress={() => window.location.assign(appUrl)}>
-            Open app
-          </Button>
-        </Card.Footer>
       </Card>
     </main>
   );

package/templates/minimal-app/apps/landing/vite.config.ts.tpl

@@ -17,7 +17,9 @@ export default defineConfig({
   resolve: {
     dedupe: ["react", "react-dom", "react-router"],
   },
+  // m5k:server:start
   envDir: "../shared",
+  // m5k:server:end
   server: {
     port: 5174,
   },

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

@@ -8,8 +8,10 @@
     "lint": "turbo run lint",
     "lint:fix": "turbo run lint:fix",
     "check-types": "turbo run check-types",
+    // m5k:server:start
     "app:deploy": "m5kdev-fly-deploy --config apps/shared/fly.toml --dockerfile apps/shared/Dockerfile --env apps/shared/.env.production",
     "app:secrets": "m5kdev-fly-secrets --config apps/shared/fly.toml --env apps/shared/.env.production",
+    // m5k:server:end
     "landing:deploy": "m5kdev-fly-deploy --config apps/landing/fly.toml --dockerfile apps/landing/Dockerfile --env apps/landing/.env.production",
     "landing:secrets": "m5kdev-fly-secrets --config apps/landing/fly.toml --env apps/landing/.env.production"
   },

package/templates/minimal-app/pnpm-workspace.yaml.tpl

@@ -7,18 +7,18 @@ catalogs:
     "@heroui/react": 3.0.3
     "@heroui/styles": 3.0.3
     "@libsql/client": 0.17.4
-    "@m5kdev/backend": 0.38.15
-    "@m5kdev/commons": 0.38.15
-    "@m5kdev/config": 0.38.15
-    "@m5kdev/email": 0.38.15
-    "@m5kdev/expo": 0.38.15
-    "@m5kdev/frontend": 0.38.15
-    "@m5kdev/module-clay": 0.38.15
-    "@m5kdev/module-docx": 0.38.15
-    "@m5kdev/module-pdf": 0.38.15
-    "@m5kdev/module-social": 0.38.15
-    "@m5kdev/module-video": 0.38.15
-    "@m5kdev/web-ui": 0.38.15
+    "@m5kdev/backend": 0.38.17
+    "@m5kdev/commons": 0.38.17
+    "@m5kdev/config": 0.38.17
+    "@m5kdev/email": 0.38.17
+    "@m5kdev/expo": 0.38.17
+    "@m5kdev/frontend": 0.38.17
+    "@m5kdev/module-clay": 0.38.17
+    "@m5kdev/module-docx": 0.38.17
+    "@m5kdev/module-pdf": 0.38.17
+    "@m5kdev/module-social": 0.38.17
+    "@m5kdev/module-video": 0.38.17
+    "@m5kdev/web-ui": 0.38.17
     "@mastra/core": 1.51.0
     "@openrouter/ai-sdk-provider": 3.0.0
     "@opentelemetry/api": 1.9.0

package/templates/minimal-app/template.manifest.json

@@ -21,6 +21,14 @@
         "apps/expo/"
       ]
     },
+    "server": {
+      "kind": "platform",
+      "paths": [
+        "apps/server/",
+        "apps/email/",
+        "apps/shared/"
+      ]
+    },
     "billing": {
       "kind": "module",
       "label": "Billing",
@@ -97,9 +105,6 @@
   "requiredPaths": [
     "package.json",
     "pnpm-workspace.yaml",
-    "apps/shared/package.json",
-    "apps/server/package.json",
-    "apps/email/package.json",
     "apps/landing/package.json"
   ],
   "sync": {