@clubedge/create-clubedge-app 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to `create-clubedge-app` are documented here.
 
+## 0.6.0
+
+- Default to Starter `v0.6.0`, which adds the local infrastructure module and `pnpm check:services`.
+- Add `--infra docker|supabase|none`: Docker Compose services, the Supabase CLI's local stack, or no local services. The environment examples point at the chosen services.
+- Let module options set root `package.json` scripts; scripts that only left-out options define are removed, so each project gets the `infra:*` scripts for its option.
+- Fix Starter tag verification on Windows, where an annotated tag resolved to the tag object instead of its commit and scaffolding a downloaded Starter release failed.
+
 ## 0.5.0
 
 - Default to Starter `v0.5.0`, which adds optional modules, Better Auth, and template schema 3.

package/README.md

@@ -12,27 +12,27 @@ The CLI downloads a tested Starter release, names the generated project, creates
 Each CLI release is tested against one specific Starter release:
 
 ```text
-create-clubedge-app v0.5.0
+create-clubedge-app v0.6.0
         |
         v
-Clubedge Starter v0.5.0
-commit d9375c2c3b520323ff0255ef8ec65da19251c3c1
+Clubedge Starter v0.6.0
+commit bf5a5e801254816455cbb837902283b788ab7595
 ```
 
 The current relationship is:
 
 | CLI release | Default Starter release | Meaning |
 | --- | --- | --- |
-| `create-clubedge-app@0.5.0` | `clubedge-starter@v0.5.0` | The CLI's required, tested default |
+| `create-clubedge-app@0.6.0` | `clubedge-starter@v0.6.0` | The CLI's required, tested default |
 
 This means the same CLI version always scaffolds the same Starter revision by default. The CLI does not silently follow Starter `main`.
 
-The `v0.5.0` tag is expected to resolve to commit
-`d9375c2c3b520323ff0255ef8ec65da19251c3c1`. The CLI verifies this before
+The `v0.6.0` tag is expected to resolve to commit
+`bf5a5e801254816455cbb837902283b788ab7595`. The CLI verifies this before
 scaffolding with the default reference and fails rather than silently using a
 moved tag.
 
-When the Starter changes, its maintainers first publish a new versioned release, such as `v0.5.0`. The CLI is then updated to use that release, all generated-project checks must pass, and a new CLI version is published. This keeps Starter and CLI releases independently versioned while preserving a tested compatibility relationship.
+When the Starter changes, its maintainers first publish a new versioned release, such as `v0.6.0`. The CLI is then updated to use that release, all generated-project checks must pass, and a new CLI version is published. This keeps Starter and CLI releases independently versioned while preserving a tested compatibility relationship.
 
 ## Requirements
 
@@ -92,6 +92,7 @@ Authentication, file storage, and caching are modules. Each has a default, and a
 | `--auth`    | `supabase`, `better-auth`, `none`          | `supabase` |
 | `--storage` | `s3`, `supabase` (needs Supabase Auth), `none` | `s3`   |
 | `--cache`   | `redis` (falls back to memory without `REDIS_URL`), `memory` | `redis` |
+| `--infra`   | `docker` (Docker Compose), `supabase` (Supabase CLI), `none` | `docker` |
 
 ```sh
 # Only the monorepo, UI, database, and tooling
@@ -109,6 +110,7 @@ Usage: pnpm dlx @clubedge/create-clubedge-app [project-directory] [options]
 --auth <id>             Authentication: supabase (default), better-auth, or none
 --storage <id>          File storage: s3 (default), supabase, or none
 --cache <id>            Cache and rate limits: redis (default) or memory
+--infra <id>            Local services: docker (default), supabase, or none
 --ref <ref>             Download this Starter tag, branch, or commit from GitHub instead
 --template-dir <path>   Scaffold from a local Starter checkout (for Starter development)
 --dry-run               Show what would be created without writing anything
@@ -134,7 +136,7 @@ pnpm dlx @clubedge/create-clubedge-app my-app --yes --no-git --framework tanstac
 pnpm dlx @clubedge/create-clubedge-app my-app --ref main
 
 # Reproduce a specific Starter release or commit
-pnpm dlx @clubedge/create-clubedge-app my-app --ref v0.5.0
+pnpm dlx @clubedge/create-clubedge-app my-app --ref v0.6.0
 pnpm dlx @clubedge/create-clubedge-app my-app --ref <commit-sha>
 
 # Test local Starter changes before releasing them
@@ -145,7 +147,7 @@ pnpm dlx @clubedge/create-clubedge-app my-app --template-dir ../clubedge-starter
 
 Each CLI release bundles one Starter release. When the release is built, `scripts/bundle-template.mjs` clones the pinned Starter tag, verifies that it resolves to the pinned commit, and copies its tracked files into the package (`template/` and `template.lock.json`). Running the CLI then needs no GitHub access for the default Starter.
 
-The Starter describes itself in `clubedge.template.json`: its app directory, site config, environment files, Docker image name, and files that stay out of generated projects. Schema 2 manifests also list each framework's app directory, environment example, and Dockerfile. The CLI moves the selected framework's app to `apps/web` (renaming its package to `@clubedge/web`), moves its environment example and Dockerfile to the project root, leaves the other frameworks out, and removes their entries from `pnpm-lock.yaml` so `pnpm install --frozen-lockfile` keeps working. Schema 3 adds `modules`: for each option, the workspace packages it uses, the files it owns, the variant files that replace defaults, and the options it requires. Files listed under `conditional` contain `clubedge:if <condition>` / `clubedge:end` blocks (in `#`, `//`, `<!-- -->`, or JSX comments) that the CLI keeps or drops for the selection, always removing the markers; `clubedge:if starter-repository` marks sections for Starter maintainers only. The CLI refuses a Starter whose manifest schema is newer than it understands and asks you to update. Starters before v0.3.0 have no manifest and use the previous layout.
+The Starter describes itself in `clubedge.template.json`: its app directory, site config, environment files, Docker image name, and files that stay out of generated projects. Schema 2 manifests also list each framework's app directory, environment example, and Dockerfile. The CLI moves the selected framework's app to `apps/web` (renaming its package to `@clubedge/web`), moves its environment example and Dockerfile to the project root, leaves the other frameworks out, and removes their entries from `pnpm-lock.yaml` so `pnpm install --frozen-lockfile` keeps working. Schema 3 adds `modules`: for each option, the workspace packages it uses, the files it owns, the variant files that replace defaults, the root `package.json` scripts it sets, and the options it requires. Files listed under `conditional` contain `clubedge:if <condition>` / `clubedge:end` blocks (in `#`, `//`, `<!-- -->`, or JSX comments) that the CLI keeps or drops for the selection, always removing the markers; `clubedge:if starter-repository` marks sections for Starter maintainers only. The CLI refuses a Starter whose manifest schema is newer than it understands and asks you to update. Starters before v0.3.0 have no manifest and use the previous layout.
 
 The CLI first builds a plan (the files to copy and the edits to make), which `--dry-run` prints, and then applies it. The source is organized the same way:
 
@@ -179,7 +181,7 @@ CI packs the CLI with `npm pack`, scaffolds a clean project from the packed tarb
 1. Make and validate changes in `clubedge-starter`.
 2. Run lint, typecheck, unit tests, browser tests, and production build.
 3. Update the Starter package versions.
-4. Commit `main`, create a release tag such as `v0.5.0`, and publish the Starter release.
+4. Commit `main`, create a release tag such as `v0.6.0`, and publish the Starter release.
 
 ### CLI maintainers
 

package/dist/cli/args.js

@@ -1,6 +1,6 @@
 import { parseArgs } from "node:util";
 /** Module flags the CLI accepts. Which options exist is up to the Starter's manifest. */
-export const MODULE_FLAGS = ["auth", "storage", "cache"];
+export const MODULE_FLAGS = ["auth", "storage", "cache", "infra"];
 export class UsageError extends Error {
     name = "UsageError";
 }
@@ -17,6 +17,7 @@ export function parseCliArgs(argv) {
                 auth: { type: "string" },
                 storage: { type: "string" },
                 cache: { type: "string" },
+                infra: { type: "string" },
                 ref: { type: "string" },
                 "template-dir": { type: "string" },
                 install: { type: "boolean", default: true },

package/dist/cli/ui.js

@@ -67,6 +67,7 @@ Options:
   --auth <id>             Authentication: supabase (default), better-auth, or none
   --storage <id>          File storage: s3 (default), supabase, or none
   --cache <id>            Cache and rate limits: redis (default) or memory
+  --infra <id>            Local services: docker (default), supabase, or none
   --ref <ref>             Download this Starter tag, branch, or commit from GitHub instead
   --template-dir <path>   Scaffold from a local Starter checkout (for Starter development)
   --dry-run               Show what would be created without writing anything

package/dist/core/customize.js

@@ -1,9 +1,15 @@
 // Pure text transforms applied to template files. Keeping them free of I/O makes each one easy
 // to test and lets --dry-run describe them without touching the disk.
 const json = (value) => `${JSON.stringify(value, null, 2)}\n`;
-export function customizeRootManifest(source, { packageName }, provenance, dockerImage) {
+export function customizeRootManifest(source, { packageName }, provenance, dockerImage, scripts = { set: {}, remove: [] }) {
     const manifest = JSON.parse(source);
     manifest.name = packageName;
+    if (manifest.scripts && typeof manifest.scripts === "object") {
+        for (const name of scripts.remove)
+            delete manifest.scripts[name];
+    }
+    if (Object.keys(scripts.set).length)
+        manifest.scripts = { ...manifest.scripts, ...scripts.set };
     manifest.clubedge = {
         cliVersion: provenance.cliVersion,
         starterRepository: provenance.starterRepository,

package/dist/core/manifest.js

@@ -102,6 +102,7 @@ function parseModules(value) {
                 files: optionalStringArray(option, "files", optionPrefix),
                 replace: optionalStringRecord(option, "replace", optionPrefix),
                 requires: parseRequires(option.requires, optionPrefix),
+                scripts: optionalStringRecord(option, "scripts", optionPrefix),
             };
         }
         const defaultOption = requireString(entry, "default", prefix);

package/dist/core/plan.js

@@ -97,8 +97,22 @@ function resolveModuleFiles(manifest, selection) {
             }
         }
     }
+    // Selected options set their scripts; scripts only left-out options define are removed.
+    const scripts = { set: {}, remove: [] };
+    const offeredScripts = new Set();
+    for (const [id, module] of Object.entries(manifest.modules)) {
+        for (const [optionId, option] of Object.entries(module.options)) {
+            for (const [name, command] of Object.entries(option.scripts)) {
+                offeredScripts.add(name);
+                if (selection[id] === optionId)
+                    scripts.set[name] = command;
+            }
+        }
+    }
+    scripts.remove = [...offeredScripts].filter((name) => !(name in scripts.set));
     const removedPackages = [...offeredPackages].filter(([name]) => !usedPackages.has(name));
     return {
+        scripts,
         removedPackageNames: removedPackages.map(([name]) => name),
         removedPackageDirectories: removedPackages.map(([, directory]) => directory),
         replacedTargets: new Set(replacements.values()),
@@ -165,7 +179,7 @@ export function createPlan(input) {
         edits.push({
             path: "package.json",
             description: `Name the package "${identity.packageName}" and record its origin`,
-            apply: (text) => customizeRootManifest(text, identity, provenance, manifest.dockerImage),
+            apply: (text) => customizeRootManifest(text, identity, provenance, manifest.dockerImage, moduleFiles.scripts),
         });
     }
     const appManifest = `${manifest.app}/package.json`;

package/dist/core/source.js

@@ -50,15 +50,18 @@ export async function readDirectoryTemplate(directory) {
 }
 /** Resolves a tag to its commit with `git ls-remote`, following annotated tags. */
 export async function resolveTagCommit(repository, tag) {
-    const output = await runCapture("git", [
-        "ls-remote",
-        `https://github.com/${repository}.git`,
-        `refs/tags/${tag}^{}`,
-        `refs/tags/${tag}`,
-    ]);
-    const lines = output.split("\n").map((line) => line.split(/\s+/));
-    const peeled = lines.find(([, ref]) => ref?.endsWith("^{}"));
-    return (peeled ?? lines[0])?.[0] || undefined;
+    // List every tag rather than passing a `refs/tags/<tag>^{}` pattern: on Windows the command
+    // runs through cmd.exe, which strips `^`, so the peeled ref would never match.
+    const output = await runCapture("git", ["ls-remote", "--tags", `https://github.com/${repository}.git`]);
+    return pickTagCommit(output, tag);
+}
+/** Picks a tag's commit from `git ls-remote` output, preferring the peeled ref of an annotated tag. */
+export function pickTagCommit(output, tag) {
+    const refs = new Map(output
+        .split("\n")
+        .map((line) => line.trim().split(/\s+/))
+        .map(([id, ref]) => [ref, id]));
+    return refs.get(`refs/tags/${tag}^{}`) ?? refs.get(`refs/tags/${tag}`);
 }
 export async function downloadGitHubTemplate(ref, { repository = starterPin.starterRepository, expectedCommit } = {}) {
     if (expectedCommit) {

package/dist/index.js

@@ -61,7 +61,7 @@ async function chooseModules(manifest, requested, interactive) {
     if (!interactive || unasked.length === 0)
         return requested;
     const customize = await confirm({
-        message: "Customize the included services (auth, storage, cache)?",
+        message: "Customize the included services (auth, storage, cache, local infrastructure)?",
         initialValue: false,
     });
     if (isCancel(customize))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/create-clubedge-app",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Create a Next.js or TanStack Start application from the Clubedge Starter reference implementation.",
   "type": "module",
   "packageManager": "pnpm@10.9.0",
@@ -22,8 +22,8 @@
   },
   "clubedge": {
     "starterRepository": "Clubedge/clubedge-starter",
-    "starterRef": "v0.5.0",
-    "starterCommit": "d9375c2c3b520323ff0255ef8ec65da19251c3c1"
+    "starterRef": "v0.6.0",
+    "starterCommit": "bf5a5e801254816455cbb837902283b788ab7595"
   },
   "license": "Apache-2.0",
   "repository": {

package/template/.env.example

@@ -1,12 +1,18 @@
 NODE_ENV=development
 NEXT_PUBLIC_APP_URL=http://localhost:3000
 
-# Supabase PostgreSQL: use the transaction pooler with prepare disabled (configured in packages/db).
-DATABASE_URL=postgresql://postgres.[project-ref]:[password]@aws-0-[region].pooler.supabase.com:6543/postgres
+# Supabase PostgreSQL: use the transaction pooler with prepare disabled (configured in packages/db). # clubedge:only infra=none
+DATABASE_URL=postgresql://postgres.[project-ref]:[password]@aws-0-[region].pooler.supabase.com:6543/postgres # clubedge:only infra=none
+# Local Supabase database, started by pnpm infra:up. # clubedge:only infra=supabase
+DATABASE_URL=postgresql://postgres:postgres@127.0.0.1:54322/postgres # clubedge:only infra=supabase
+# Local PostgreSQL from docker-compose.dev.yml, started by pnpm infra:up. # clubedge:only infra=docker
+DATABASE_URL=postgresql://postgres:postgres@localhost:5432/app # clubedge:only infra=docker
 
 # clubedge:if auth=supabase
 # Supabase Auth (publishable key only; never put a service role key in the browser)
-NEXT_PUBLIC_SUPABASE_URL=
+NEXT_PUBLIC_SUPABASE_URL= # clubedge:only infra!=supabase
+# Local Supabase Auth. pnpm infra:status prints the publishable key to copy below. # clubedge:only infra=supabase
+NEXT_PUBLIC_SUPABASE_URL=http://127.0.0.1:54321 # clubedge:only infra=supabase
 NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=
 # clubedge:end
 
@@ -19,20 +25,28 @@ BETTER_AUTH_SECRET=
 # clubedge:if cache=redis
 # Optional cache and rate limits (Redis protocol; rediss:// enables TLS). Without it, both use
 # process memory. Upstash example: rediss://default:YOUR_PASSWORD@your-database.upstash.io:6379
-REDIS_URL=
+REDIS_URL= # clubedge:only infra!=docker
+REDIS_URL=redis://localhost:6379 # clubedge:only infra=docker
 # clubedge:end
 
 # clubedge:if storage=s3
 # S3-compatible storage (AWS S3, Cloudflare R2, MinIO)
-STORAGE_BUCKET=
-STORAGE_REGION=auto
-STORAGE_ENDPOINT=
-STORAGE_ACCESS_KEY_ID=
-STORAGE_SECRET_ACCESS_KEY=
+STORAGE_BUCKET= # clubedge:only infra!=docker
+STORAGE_REGION=auto # clubedge:only infra!=docker
+STORAGE_ENDPOINT= # clubedge:only infra!=docker
+STORAGE_ACCESS_KEY_ID= # clubedge:only infra!=docker
+STORAGE_SECRET_ACCESS_KEY= # clubedge:only infra!=docker
+# Local S3-compatible storage from docker-compose.dev.yml; it accepts any credentials. # clubedge:only infra=docker
+STORAGE_BUCKET=app # clubedge:only infra=docker
+STORAGE_REGION=us-east-1 # clubedge:only infra=docker
+STORAGE_ENDPOINT=http://localhost:9090 # clubedge:only infra=docker
+STORAGE_ACCESS_KEY_ID=local # clubedge:only infra=docker
+STORAGE_SECRET_ACCESS_KEY=local-secret # clubedge:only infra=docker
 STORAGE_PUBLIC_URL=
 # clubedge:end
 
 # clubedge:if storage=supabase
 # Supabase Storage bucket, accessed with the signed-in user's Supabase session
-SUPABASE_STORAGE_BUCKET=
+SUPABASE_STORAGE_BUCKET= # clubedge:only infra!=supabase
+SUPABASE_STORAGE_BUCKET=app # clubedge:only infra=supabase
 # clubedge:end

package/template/README.md

@@ -93,7 +93,36 @@ macOS/Linux:
 cp .env.example apps/web/.env.local
 ```
 
-Set `DATABASE_URL` in `apps/web/.env.local`, then start the app. [SETUP.md](SETUP.md) describes every variable and provider.
+<!-- clubedge:if infra=docker -->
+
+Start PostgreSQL and the other local services with Docker, apply the migrations, and check that the app can reach every service. The example environment already points at them.
+
+```sh
+pnpm infra:up
+pnpm db:migrate
+pnpm check:services
+```
+
+<!-- clubedge:end -->
+<!-- clubedge:if infra=supabase -->
+
+Start the local Supabase stack (it needs Docker), copy the publishable key that `pnpm infra:status` prints into `apps/web/.env.local`, and apply the migrations.
+
+```sh
+pnpm infra:up
+pnpm infra:status
+pnpm db:migrate
+pnpm check:services
+```
+
+<!-- clubedge:end -->
+<!-- clubedge:if infra=none -->
+
+Set `DATABASE_URL` and your providers' settings in `apps/web/.env.local`, then run `pnpm db:migrate` and `pnpm check:services`.
+
+<!-- clubedge:end -->
+
+Then start the app. [SETUP.md](SETUP.md) describes every variable and provider.
 
 ```sh
 pnpm dev
@@ -125,6 +154,14 @@ Run these from the repository root:
 
 Playwright's first run may require installing Chromium with `pnpm exec playwright install chromium`. CI runs the browser checks automatically.
 
+Local services:
+
+- `pnpm check:services`: check every configured service with a real round trip.
+- `pnpm infra:up` and `pnpm infra:down`: start and stop the local services from `docker-compose.dev.yml`. <!-- clubedge:only infra=docker -->
+- `pnpm infra:reset`: stop them and delete their data. `pnpm infra:logs` follows their logs. <!-- clubedge:only infra=docker -->
+- `pnpm infra:up` and `pnpm infra:down`: start and stop the local Supabase stack. <!-- clubedge:only infra=supabase -->
+- `pnpm infra:status`: print its URLs and keys. `pnpm infra:reset` stops it and deletes its data. <!-- clubedge:only infra=supabase -->
+
 <!-- clubedge:if starter-repository -->
 
 ## Working on this repository

package/template/SETUP.md

@@ -31,7 +31,10 @@ macOS/Linux:
 cp .env.example apps/web/.env.local
 ```
 
-The example file leaves provider URLs and keys blank so the app can build and start without connecting to real services. At minimum, set `DATABASE_URL`. The variables are:
+The example file points at the local services described in [Local services](#local-services) and leaves provider keys blank, so the app builds and starts before anything is configured. <!-- clubedge:only infra!=none -->
+The example file leaves provider URLs and keys blank so the app can build and start without connecting to real services. At minimum, set `DATABASE_URL`. <!-- clubedge:only infra=none -->
+
+The variables are:
 
 - `DATABASE_URL` (required): PostgreSQL connection URL, such as a Supabase transaction pooler URL.
 - `NEXT_PUBLIC_APP_URL` (recommended): the app's origin, defaulting to `http://localhost:3000`. <!-- clubedge:only framework=next -->
@@ -83,6 +86,45 @@ Put the result in `BETTER_AUTH_SECRET`. Until it is set, the dashboard stays vie
 
 <!-- clubedge:end -->
 
+## Local services
+
+<!-- clubedge:if infra=docker -->
+
+`docker-compose.dev.yml` runs the services this project uses on your machine, listening on `127.0.0.1` only. Install Docker Desktop (or Docker Engine with Compose), then:
+
+```sh
+pnpm infra:up      # start and wait until every service is healthy
+pnpm db:migrate    # create the tables
+pnpm check:services
+```
+
+- PostgreSQL 17 on port 5432, database `app`, user and password `postgres`. Data survives restarts in a Docker volume.
+- Redis on port 6379. <!-- clubedge:only cache=redis -->
+- S3-compatible storage (adobe/s3mock) on port 9090 with the bucket `app`. It accepts any credentials and is for development only. <!-- clubedge:only storage=s3 -->
+
+`pnpm infra:down` stops the services, `pnpm infra:reset` also deletes their data, and `pnpm infra:logs` follows their logs. The file is for development; in production, point the same variables at managed services.
+
+<!-- clubedge:end -->
+<!-- clubedge:if infra=supabase -->
+
+`supabase/config.toml` configures the Supabase CLI's local stack: PostgreSQL, Auth, Storage, the Studio dashboard, and an inbox that captures emails. The CLI runs it in Docker, so install Docker Desktop first. Then:
+
+```sh
+pnpm infra:up       # start the stack (the first run downloads its images)
+pnpm infra:status   # print the local URLs and keys
+pnpm db:migrate
+pnpm check:services
+```
+
+The database is on port 54322 and the API on port 54321, matching the example environment. Copy the publishable key from `pnpm infra:status` into the Supabase variables. Email confirmation is off locally, so sign-up signs the user in directly. `pnpm infra:down` stops the stack and `pnpm infra:reset` also deletes its data.
+
+<!-- clubedge:end -->
+<!-- clubedge:if infra=none -->
+
+This project does not include local service definitions. Point `DATABASE_URL` and the provider variables at services you run yourself or at hosted ones, such as Supabase or Neon for PostgreSQL and Upstash for Redis, then run `pnpm check:services` to confirm the app can reach them.
+
+<!-- clubedge:end -->
+
 ## Set up the database
 
 Application tables are managed with Drizzle. Keep one migration source of truth for application tables: do not also create an independent Supabase migration history for those same tables.

package/template/_gitignore

@@ -17,3 +17,6 @@ test-results/
 dist/
 # Generated by TanStack Router during dev, build, and typecheck
 routeTree.gen.ts
+# Supabase CLI working files
+supabase/.temp/
+supabase/.branches/

package/template/apps/start/.env.example

@@ -2,13 +2,19 @@
 # development JSX that crashes the production server. `vite dev` and `vite build` set it.
 APP_URL=http://localhost:3000
 
-# Supabase PostgreSQL: use the transaction pooler with prepare disabled (configured in packages/db).
-DATABASE_URL=postgresql://postgres.[project-ref]:[password]@aws-0-[region].pooler.supabase.com:6543/postgres
+# Supabase PostgreSQL: use the transaction pooler with prepare disabled (configured in packages/db). # clubedge:only infra=none
+DATABASE_URL=postgresql://postgres.[project-ref]:[password]@aws-0-[region].pooler.supabase.com:6543/postgres # clubedge:only infra=none
+# Local Supabase database, started by pnpm infra:up. # clubedge:only infra=supabase
+DATABASE_URL=postgresql://postgres:postgres@127.0.0.1:54322/postgres # clubedge:only infra=supabase
+# Local PostgreSQL from docker-compose.dev.yml, started by pnpm infra:up. # clubedge:only infra=docker
+DATABASE_URL=postgresql://postgres:postgres@localhost:5432/app # clubedge:only infra=docker
 
 # clubedge:if auth=supabase
 # Supabase Auth (publishable key only; never use a service role key here).
 # All auth runs on the server, so these need no browser prefix.
-SUPABASE_URL=
+SUPABASE_URL= # clubedge:only infra!=supabase
+# Local Supabase Auth. pnpm infra:status prints the publishable key to copy below. # clubedge:only infra=supabase
+SUPABASE_URL=http://127.0.0.1:54321 # clubedge:only infra=supabase
 SUPABASE_PUBLISHABLE_KEY=
 # clubedge:end
 
@@ -21,20 +27,28 @@ BETTER_AUTH_SECRET=
 # clubedge:if cache=redis
 # Optional cache and rate limits (Redis protocol; rediss:// enables TLS). Without it, both use
 # process memory. Upstash example: rediss://default:YOUR_PASSWORD@your-database.upstash.io:6379
-REDIS_URL=
+REDIS_URL= # clubedge:only infra!=docker
+REDIS_URL=redis://localhost:6379 # clubedge:only infra=docker
 # clubedge:end
 
 # clubedge:if storage=s3
 # S3-compatible storage (AWS S3, Cloudflare R2, MinIO)
-STORAGE_BUCKET=
-STORAGE_REGION=auto
-STORAGE_ENDPOINT=
-STORAGE_ACCESS_KEY_ID=
-STORAGE_SECRET_ACCESS_KEY=
+STORAGE_BUCKET= # clubedge:only infra!=docker
+STORAGE_REGION=auto # clubedge:only infra!=docker
+STORAGE_ENDPOINT= # clubedge:only infra!=docker
+STORAGE_ACCESS_KEY_ID= # clubedge:only infra!=docker
+STORAGE_SECRET_ACCESS_KEY= # clubedge:only infra!=docker
+# Local S3-compatible storage from docker-compose.dev.yml; it accepts any credentials. # clubedge:only infra=docker
+STORAGE_BUCKET=app # clubedge:only infra=docker
+STORAGE_REGION=us-east-1 # clubedge:only infra=docker
+STORAGE_ENDPOINT=http://localhost:9090 # clubedge:only infra=docker
+STORAGE_ACCESS_KEY_ID=local # clubedge:only infra=docker
+STORAGE_SECRET_ACCESS_KEY=local-secret # clubedge:only infra=docker
 STORAGE_PUBLIC_URL=
 # clubedge:end
 
 # clubedge:if storage=supabase
 # Supabase Storage bucket, accessed with the signed-in user's Supabase session
-SUPABASE_STORAGE_BUCKET=
+SUPABASE_STORAGE_BUCKET= # clubedge:only infra!=supabase
+SUPABASE_STORAGE_BUCKET=app # clubedge:only infra=supabase
 # clubedge:end

package/template/apps/start/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/start",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",
@@ -8,7 +8,8 @@
     "dev": "vite dev",
     "build": "vite build",
     "start": "node --env-file-if-exists=.env.local .output/server/index.mjs",
-    "typecheck": "tsr generate && tsc --noEmit"
+    "typecheck": "tsr generate && tsc --noEmit",
+    "check:services": "tsx scripts/check-services.ts"
   },
   "dependencies": {
     "@clubedge/auth": "workspace:*",
@@ -38,6 +39,7 @@
     "@vitejs/plugin-react": "^6.1.2",
     "nitro": "3.0.260903-beta",
     "tailwindcss": "^4.1.13",
+    "tsx": "^4.20.5",
     "vite": "^8.3.4"
   }
 }

package/template/apps/start/scripts/check-services.ts

@@ -0,0 +1,106 @@
+// Checks every service this project uses with a real round trip: `pnpm check:services`.
+// It reads the app's .env.local like the app does, so it confirms the app's own settings.
+import { existsSync } from "node:fs";
+import { createDb } from "@clubedge/db";
+// clubedge:if cache=redis
+import { createRedisCache } from "@clubedge/cache-redis";
+// clubedge:end
+// clubedge:if storage=s3
+import { createS3Storage } from "@clubedge/storage-s3";
+// clubedge:end
+
+type Check = { name: string; skip?: string; run: () => Promise<string> };
+
+/** Services can take a few seconds to accept connections after `pnpm infra:up`. */
+async function withRetry(run: () => Promise<string>, attempts = 15): Promise<string> {
+  for (let attempt = 1; ; attempt++) {
+    try {
+      return await run();
+    } catch (error) {
+      if (attempt >= attempts) throw error;
+      await new Promise((resolve) => setTimeout(resolve, 2_000));
+    }
+  }
+}
+
+async function main() {
+  if (existsSync(".env.local")) process.loadEnvFile(".env.local");
+  const env = process.env;
+
+  const checks: Check[] = [
+    {
+      name: "PostgreSQL",
+      skip: env.DATABASE_URL ? undefined : "DATABASE_URL is not set",
+      async run() {
+        const db = createDb({ url: env.DATABASE_URL! });
+        try {
+          const [row] = await db.$client`select current_database() as name`;
+          // clubedge:if auth=better-auth
+          // Better Auth's tables exist once `pnpm db:migrate` has run.
+          await db.$client`select 1 from auth_user limit 1`;
+          // clubedge:end
+          return `connected to database "${row?.name}"`;
+        } finally {
+          await db.$client.end();
+        }
+      },
+    },
+    // clubedge:if cache=redis
+    {
+      name: "Redis",
+      skip: env.REDIS_URL ? undefined : "REDIS_URL is not set; the app uses process memory",
+      async run() {
+        const cache = createRedisCache(env.REDIS_URL!);
+        const value = { checkedAt: Date.now() };
+        await cache.set("check-services", value, 30);
+        const read = await cache.get<typeof value>("check-services");
+        if (read?.checkedAt !== value.checkedAt) throw new Error("read back a different value");
+        return "wrote and read a cached value";
+      },
+    },
+    // clubedge:end
+    // clubedge:if storage=s3
+    {
+      name: "File storage",
+      skip: env.STORAGE_BUCKET ? undefined : "STORAGE_BUCKET is not set",
+      async run() {
+        const storage = createS3Storage({
+          bucket: env.STORAGE_BUCKET,
+          region: env.STORAGE_REGION || "auto",
+          endpoint: env.STORAGE_ENDPOINT || undefined,
+          accessKeyId: env.STORAGE_ACCESS_KEY_ID || undefined,
+          secretAccessKey: env.STORAGE_SECRET_ACCESS_KEY || undefined,
+        });
+        const key = `check-services/${Date.now()}.txt`;
+        await storage.upload({
+          key,
+          body: new TextEncoder().encode("ok"),
+          contentType: "text/plain",
+        });
+        const text = await new Response(await storage.download(key)).text();
+        await storage.delete(key);
+        if (text !== "ok") throw new Error(`read back "${text}"`);
+        return `uploaded, read back, and deleted an object in "${env.STORAGE_BUCKET}"`;
+      },
+    },
+    // clubedge:end
+  ];
+
+  let failed = false;
+  for (const check of checks) {
+    if (check.skip) {
+      console.log(`-  ${check.name}: skipped (${check.skip})`);
+      continue;
+    }
+    try {
+      console.log(`✓  ${check.name}: ${await withRetry(check.run)}`);
+    } catch (error) {
+      failed = true;
+      console.log(`✗  ${check.name}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
+  // Redis clients keep the process alive, so exit explicitly.
+  process.exit(failed ? 1 : 0);
+}
+
+void main();

package/template/apps/web/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@clubedge/web",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "private": true,
   "license": "Apache-2.0",
   "scripts": {
     "dev": "next dev",
     "build": "next build",
     "start": "node scripts/start-standalone.mjs",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "check:services": "tsx scripts/check-services.ts"
   },
   "dependencies": {
     "@clubedge/auth": "workspace:*",
@@ -33,6 +34,7 @@
     "@tailwindcss/postcss": "^4.1.13",
     "@types/react": "^19.1.13",
     "@types/react-dom": "^19.1.9",
-    "tailwindcss": "^4.1.13"
+    "tailwindcss": "^4.1.13",
+    "tsx": "^4.20.5"
   }
 }

package/template/apps/web/scripts/check-services.ts

@@ -0,0 +1,106 @@
+// Checks every service this project uses with a real round trip: `pnpm check:services`.
+// It reads the app's .env.local like the app does, so it confirms the app's own settings.
+import { existsSync } from "node:fs";
+import { createDb } from "@clubedge/db";
+// clubedge:if cache=redis
+import { createRedisCache } from "@clubedge/cache-redis";
+// clubedge:end
+// clubedge:if storage=s3
+import { createS3Storage } from "@clubedge/storage-s3";
+// clubedge:end
+
+type Check = { name: string; skip?: string; run: () => Promise<string> };
+
+/** Services can take a few seconds to accept connections after `pnpm infra:up`. */
+async function withRetry(run: () => Promise<string>, attempts = 15): Promise<string> {
+  for (let attempt = 1; ; attempt++) {
+    try {
+      return await run();
+    } catch (error) {
+      if (attempt >= attempts) throw error;
+      await new Promise((resolve) => setTimeout(resolve, 2_000));
+    }
+  }
+}
+
+async function main() {
+  if (existsSync(".env.local")) process.loadEnvFile(".env.local");
+  const env = process.env;
+
+  const checks: Check[] = [
+    {
+      name: "PostgreSQL",
+      skip: env.DATABASE_URL ? undefined : "DATABASE_URL is not set",
+      async run() {
+        const db = createDb({ url: env.DATABASE_URL! });
+        try {
+          const [row] = await db.$client`select current_database() as name`;
+          // clubedge:if auth=better-auth
+          // Better Auth's tables exist once `pnpm db:migrate` has run.
+          await db.$client`select 1 from auth_user limit 1`;
+          // clubedge:end
+          return `connected to database "${row?.name}"`;
+        } finally {
+          await db.$client.end();
+        }
+      },
+    },
+    // clubedge:if cache=redis
+    {
+      name: "Redis",
+      skip: env.REDIS_URL ? undefined : "REDIS_URL is not set; the app uses process memory",
+      async run() {
+        const cache = createRedisCache(env.REDIS_URL!);
+        const value = { checkedAt: Date.now() };
+        await cache.set("check-services", value, 30);
+        const read = await cache.get<typeof value>("check-services");
+        if (read?.checkedAt !== value.checkedAt) throw new Error("read back a different value");
+        return "wrote and read a cached value";
+      },
+    },
+    // clubedge:end
+    // clubedge:if storage=s3
+    {
+      name: "File storage",
+      skip: env.STORAGE_BUCKET ? undefined : "STORAGE_BUCKET is not set",
+      async run() {
+        const storage = createS3Storage({
+          bucket: env.STORAGE_BUCKET,
+          region: env.STORAGE_REGION || "auto",
+          endpoint: env.STORAGE_ENDPOINT || undefined,
+          accessKeyId: env.STORAGE_ACCESS_KEY_ID || undefined,
+          secretAccessKey: env.STORAGE_SECRET_ACCESS_KEY || undefined,
+        });
+        const key = `check-services/${Date.now()}.txt`;
+        await storage.upload({
+          key,
+          body: new TextEncoder().encode("ok"),
+          contentType: "text/plain",
+        });
+        const text = await new Response(await storage.download(key)).text();
+        await storage.delete(key);
+        if (text !== "ok") throw new Error(`read back "${text}"`);
+        return `uploaded, read back, and deleted an object in "${env.STORAGE_BUCKET}"`;
+      },
+    },
+    // clubedge:end
+  ];
+
+  let failed = false;
+  for (const check of checks) {
+    if (check.skip) {
+      console.log(`-  ${check.name}: skipped (${check.skip})`);
+      continue;
+    }
+    try {
+      console.log(`✓  ${check.name}: ${await withRetry(check.run)}`);
+    } catch (error) {
+      failed = true;
+      console.log(`✗  ${check.name}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
+  // Redis clients keep the process alive, so exit explicitly.
+  process.exit(failed ? 1 : 0);
+}
+
+void main();

package/template/clubedge.template.json

@@ -160,6 +160,35 @@
           }
         }
       }
+    },
+    "infra": {
+      "name": "Local infrastructure",
+      "default": "docker",
+      "options": {
+        "docker": {
+          "name": "Docker Compose",
+          "files": ["docker-compose.dev.yml"],
+          "scripts": {
+            "infra:up": "docker compose -f docker-compose.dev.yml up -d --wait",
+            "infra:down": "docker compose -f docker-compose.dev.yml down",
+            "infra:reset": "docker compose -f docker-compose.dev.yml down --volumes",
+            "infra:logs": "docker compose -f docker-compose.dev.yml logs --follow"
+          }
+        },
+        "supabase": {
+          "name": "Supabase CLI",
+          "files": ["supabase"],
+          "scripts": {
+            "infra:up": "npx --yes supabase@2 start",
+            "infra:down": "npx --yes supabase@2 stop",
+            "infra:reset": "npx --yes supabase@2 stop --no-backup",
+            "infra:status": "npx --yes supabase@2 status"
+          }
+        },
+        "none": {
+          "name": "None (bring your own services)"
+        }
+      }
     }
   },
   "conditional": [
@@ -169,12 +198,16 @@
     "README.md",
     "SETUP.md",
     "apps/start/.env.example",
+    "apps/start/scripts/check-services.ts",
     "apps/start/src/env/auth.ts",
     "apps/start/src/routes/dashboard.tsx",
     "apps/start/src/routes/index.tsx",
+    "apps/web/scripts/check-services.ts",
     "apps/web/src/app/dashboard/page.tsx",
     "apps/web/src/app/page.tsx",
-    "apps/web/src/env/auth.ts"
+    "apps/web/src/env/auth.ts",
+    "docker-compose.dev.yml",
+    "supabase/config.toml"
   ],
   "exclude": [
     ".github/workflows/starter.yml",

package/template/docker-compose.dev.yml

@@ -0,0 +1,42 @@
+# Local services for development. `pnpm infra:up` starts them and waits until they are ready,
+# `pnpm infra:down` stops them, and `pnpm infra:reset` also deletes their data. Ports listen on
+# 127.0.0.1 only. This file is for development; production uses managed services.
+services:
+  postgres:
+    image: postgres:17
+    environment:
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: postgres
+      POSTGRES_DB: app
+    ports:
+      - "127.0.0.1:5432:5432"
+    volumes:
+      - postgres-data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U postgres -d app"]
+      interval: 2s
+      timeout: 5s
+      retries: 30
+  # clubedge:if cache=redis
+  redis:
+    image: redis:8
+    ports:
+      - "127.0.0.1:6379:6379"
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 2s
+      timeout: 5s
+      retries: 30
+  # clubedge:end
+  # clubedge:if storage=s3
+  # S3-compatible storage for development, with the "app" bucket created at startup.
+  storage:
+    image: adobe/s3mock:5
+    environment:
+      COM_ADOBE_TESTING_S3MOCK_STORE_INITIAL_BUCKETS: app
+    ports:
+      - "127.0.0.1:9090:9090"
+  # clubedge:end
+
+volumes:
+  postgres-data:

package/template/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clubedge-starter-v1",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "private": true,
   "license": "Apache-2.0",
   "packageManager": "pnpm@10.9.0",
@@ -27,7 +27,12 @@
     "test:e2e:ui": "playwright test --ui",
     "docker:dev": "docker compose up --build",
     "docker:build": "docker build -t clubedge-starter .",
-    "docker:start": "docker run --rm -p 3000:3000 --env-file apps/web/.env.local clubedge-starter"
+    "docker:start": "docker run --rm -p 3000:3000 --env-file apps/web/.env.local clubedge-starter",
+    "check:services": "pnpm --filter @clubedge/web check:services",
+    "infra:up": "docker compose -f docker-compose.dev.yml up -d --wait",
+    "infra:down": "docker compose -f docker-compose.dev.yml down",
+    "infra:reset": "docker compose -f docker-compose.dev.yml down --volumes",
+    "infra:logs": "docker compose -f docker-compose.dev.yml logs --follow"
   },
   "devDependencies": {
     "@playwright/test": "^1.55.0",

package/template/packages/auth/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/auth",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",

package/template/packages/auth-better-auth/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/auth-better-auth",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Better Auth adapter for @clubedge/auth, storing users and sessions in your own PostgreSQL.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/auth-supabase/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/auth-supabase",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Supabase Auth adapter for @clubedge/auth.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/cache/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/cache",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",

package/template/packages/cache-redis/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/cache-redis",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Redis rate limiter and cache for @clubedge/cache.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/core",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",

package/template/packages/db/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/db",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",

package/template/packages/storage/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/storage",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",

package/template/packages/storage-s3/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/storage-s3",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "S3-compatible adapter for @clubedge/storage.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/storage-s3/src/index.test.ts

@@ -37,6 +37,28 @@ describe("createS3Storage", () => {
     expect(S3Client).toHaveBeenCalledTimes(1);
   });
 
+  it("uses path-style addressing with a custom endpoint unless told otherwise", async () => {
+    send.mockResolvedValue({});
+    await createS3Storage({ bucket: "files", region: "auto" }).delete("a.txt");
+    await createS3Storage({
+      bucket: "files",
+      region: "auto",
+      endpoint: "http://localhost:9090",
+    }).delete("a.txt");
+    await createS3Storage({
+      bucket: "files",
+      region: "auto",
+      endpoint: "https://r2.example",
+      forcePathStyle: false,
+    }).delete("a.txt");
+
+    expect(vi.mocked(S3Client).mock.calls.map(([options]) => options?.forcePathStyle)).toEqual([
+      false,
+      true,
+      false,
+    ]);
+  });
+
   it("uploads to the configured bucket and builds the public URL", async () => {
     const storage = createS3Storage({
       bucket: "files",

package/template/packages/storage-s3/src/index.ts

@@ -13,6 +13,11 @@ export interface S3StorageConfig {
   bucket?: string;
   region: string;
   endpoint?: string;
+  /**
+   * Address buckets as https://endpoint/bucket rather than https://bucket.endpoint. Defaults to
+   * true with a custom endpoint, which local servers (s3mock), MinIO, and R2 all accept.
+   */
+  forcePathStyle?: boolean;
   accessKeyId?: string;
   secretAccessKey?: string;
   /** Public base URL for uploaded objects, such as a CDN or R2 public bucket. */
@@ -25,7 +30,7 @@ function bodyForS3(body: UploadInput["body"]) {
   return body;
 }
 
-/** Works with AWS S3 and S3-compatible services such as Cloudflare R2 and MinIO. */
+/** Works with AWS S3 and S3-compatible services such as Cloudflare R2, MinIO, and s3mock. */
 export function createS3Storage(config: S3StorageConfig): StorageProvider {
   let s3Client: S3Client | undefined;
 
@@ -33,6 +38,7 @@ export function createS3Storage(config: S3StorageConfig): StorageProvider {
     s3Client ??= new S3Client({
       region: config.region,
       ...(config.endpoint ? { endpoint: config.endpoint } : {}),
+      forcePathStyle: config.forcePathStyle ?? Boolean(config.endpoint),
       credentials:
         config.accessKeyId && config.secretAccessKey
           ? { accessKeyId: config.accessKeyId, secretAccessKey: config.secretAccessKey }

package/template/packages/storage-supabase/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/storage-supabase",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Supabase Storage adapter for @clubedge/storage.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/ui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/ui",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",

package/template/playwright.config.ts

@@ -13,7 +13,9 @@ export default defineConfig({
     url: "http://127.0.0.1:3000",
     reuseExistingServer: !process.env.CI,
     env: {
-      DATABASE_URL: "postgresql://postgres:postgres@127.0.0.1:5432/postgres",
+      // A placeholder unless set, so pages render without a database.
+      DATABASE_URL:
+        process.env.DATABASE_URL ?? "postgresql://postgres:postgres@127.0.0.1:5432/postgres",
       // Next.js reads NEXT_PUBLIC_APP_URL; TanStack Start reads APP_URL.
       NEXT_PUBLIC_APP_URL: "http://127.0.0.1:3000",
       APP_URL: "http://127.0.0.1:3000",

package/template/pnpm-lock.yaml

@@ -114,6 +114,9 @@ importers:
       tailwindcss:
         specifier: ^4.1.13
         version: 4.3.3
+      tsx:
+        specifier: ^4.20.5
+        version: 4.23.15
       vite:
         specifier: ^8.3.4
         version: 8.3.4(@types/node@22.20.5)(esbuild@0.25.12)(jiti@2.7.0)(tsx@4.23.15)
@@ -187,6 +190,9 @@ importers:
       tailwindcss:
         specifier: ^4.1.13
         version: 4.3.3
+      tsx:
+        specifier: ^4.20.5
+        version: 4.23.15
 
   packages/auth:
     dependencies:

package/template/supabase/config.toml

@@ -0,0 +1,40 @@
+# Local Supabase stack for development: `pnpm infra:up` runs `supabase start`, and
+# `pnpm infra:status` prints the local URLs and keys. Docs: https://supabase.com/docs/guides/local-development
+project_id = "clubedge-app"
+
+[api]
+port = 54321
+
+[db]
+port = 54322
+major_version = 17
+
+[studio]
+port = 54323
+
+# Captures sign-up and password emails locally; open it from `pnpm infra:status`.
+[inbucket]
+port = 54324
+
+[auth]
+site_url = "http://localhost:3000"
+additional_redirect_urls = ["http://localhost:3000/auth/callback", "http://127.0.0.1:3000/auth/callback"]
+
+[auth.email]
+# Sign-up signs the user in directly during local development.
+enable_confirmations = false
+
+# clubedge:if storage=supabase
+[storage.buckets.app]
+public = false
+# clubedge:end
+
+# Not used by the app; disabled so the stack starts faster.
+[realtime]
+enabled = false
+
+[edge_runtime]
+enabled = false
+
+[analytics]
+enabled = false

package/template.lock.json

@@ -1,7 +1,7 @@
 {
   "repository": "Clubedge/clubedge-starter",
-  "ref": "v0.5.0",
-  "commit": "d9375c2c3b520323ff0255ef8ec65da19251c3c1",
+  "ref": "v0.6.0",
+  "commit": "bf5a5e801254816455cbb837902283b788ab7595",
   "files": [
     ".dockerignore",
     ".env.example",
@@ -32,6 +32,7 @@
     "apps/start/package.json",
     "apps/start/public/.well-known/logo.svg",
     "apps/start/public/favicon.ico",
+    "apps/start/scripts/check-services.ts",
     "apps/start/src/components/auth/auth-form-controls.tsx",
     "apps/start/src/components/branding/clubedge-mark.tsx",
     "apps/start/src/components/dashboard/account-button.tsx",
@@ -87,6 +88,7 @@
     "apps/web/postcss.config.mjs",
     "apps/web/public/.gitkeep",
     "apps/web/public/.well-known/logo.svg",
+    "apps/web/scripts/check-services.ts",
     "apps/web/scripts/start-standalone.mjs",
     "apps/web/src/app/actions/auth.ts",
     "apps/web/src/app/api/health/route.ts",
@@ -127,6 +129,7 @@
     "apps/web/src/variants/proxy.better-auth.ts",
     "apps/web/tsconfig.json",
     "clubedge.template.json",
+    "docker-compose.dev.yml",
     "docker-compose.yml",
     "e2e/app.ts",
     "e2e/auth-flow.spec.ts",
@@ -219,6 +222,7 @@
     "playwright.config.ts",
     "pnpm-lock.yaml",
     "pnpm-workspace.yaml",
+    "supabase/config.toml",
     "tsconfig.base.json",
     "turbo.json",
     "vitest.config.ts"