@getstrata/starter 0.1.0 → 0.1.1

package/README.md

@@ -12,10 +12,25 @@ bunx @getstrata/starter my-app
 ## What you get
 
 - Bun + TypeScript app using `@getstrata/core` and `@getstrata/bootstrap`
-- Postgres via Docker Compose
+- Postgres via Docker Compose (no WorkHub `tenant` table; set `TENANCY_DRIVER=none`)
 - Eta templates, simple router, health check
 - `db:migrate` and `db:fresh` scripts
 
+## Environment
+
+Copy `.env.example` to `.env`. The scaffold is an API app without a `tenant` table:
+
+| Variable | Local default | Notes |
+|----------|---------------|--------|
+| `TENANCY_DRIVER` | `none` | Skip Postgres RLS / `tenant` lookups |
+| `FRONTEND_MODE` | `api` | Use `server-htmx` only if you add cookie sessions |
+| `SESSION_SECRET` | unset | Required in production when `FRONTEND_MODE=server-htmx` |
+| `TRUST_FORWARDED_FOR` | unset | Set `true` only behind a trusted reverse proxy |
+| `METRICS_TOKEN` | unset | Required in production to expose `GET /metrics` |
+| `FEATURE_PUBLIC_READS` | unset | Set `false` in production |
+
+`assertProductionSecrets()` is WorkHub-oriented (API tokens, Stripe, SCIM). Starter apps do not call it; add it if you enable those features.
+
 ## Publish
 
 Released from the strata monorepo on npm as `@getstrata/starter`.

package/dist/templates/.env.example

@@ -1,3 +1,18 @@
 DATABASE_URL=postgresql://postgres:postgres@localhost:5432/{{PROJECT_NAME}}
 PORT=3000
 APP_URL=http://localhost:3000
+APP_ENV=local
+FRONTEND_MODE=api
+TENANCY_DRIVER=none
+
+# Required in production when FRONTEND_MODE=server-htmx
+# SESSION_SECRET=
+
+# Set only behind a trusted reverse proxy
+# TRUST_FORWARDED_FOR=true
+
+# Required in production to expose GET /metrics
+# METRICS_TOKEN=
+
+# Production should set FEATURE_PUBLIC_READS=false
+# FEATURE_PUBLIC_READS=false

package/dist/templates/package.json

@@ -11,13 +11,11 @@
     "check": "tsc --noEmit"
   },
   "dependencies": {
-    "@getstrata/bootstrap": "^0.1.0",
-    "@getstrata/core": "^0.3.0",
-    "eta": "^4.6.0",
-    "postgres": "3.4.7"
+    "@getstrata/bootstrap": "^0.2.48",
+    "@getstrata/core": "^0.5.57"
   },
   "devDependencies": {
-    "@types/bun": "latest",
+    "@types/bun": "^1.4.0",
     "typescript": "^5.9.2"
   }
 }

package/dist/templates/src/bootstrap/createApp.ts

@@ -0,0 +1,93 @@
+import { runProviderPhase } from "@getstrata/bootstrap/context";
+import {
+  type AppContext,
+  type AppDependencies,
+  type AppRouteMap,
+  assertAppDependenciesComplete,
+  type ConfigStore,
+  type MutableAppDependencies,
+  type ProviderContext,
+  ServiceContainer,
+} from "@getstrata/bootstrap/contracts";
+import { createWebServer } from "@getstrata/bootstrap/web/server";
+import { setActiveApplicationContext } from "@getstrata/core/runtime/applicationRegistry";
+import { migrate } from "../db/migrate.ts";
+import { buildRoutes } from "../routes.ts";
+import { loadConfig } from "./config.ts";
+import { starterProviders } from "./providers/index.ts";
+
+export interface BootstrapOptions {
+  migrate?: boolean;
+}
+
+export interface BootstrappedApp {
+  context: AppContext;
+  routes: AppRouteMap;
+  config: ReturnType<typeof loadConfig>;
+}
+
+class AppConfigStore {
+  private readonly values = new Map<string, unknown>();
+
+  set<T>(key: string, value: T): T {
+    this.values.set(key, value);
+    return value;
+  }
+
+  get<T>(key: string): T | undefined {
+    return this.values.get(key) as T | undefined;
+  }
+
+  require<T>(key: string): T {
+    const value = this.get<T>(key);
+    if (value === undefined) {
+      throw new Error(`Missing required config value "${key}".`);
+    }
+    return value;
+  }
+
+  has(key: string): boolean {
+    return this.values.has(key);
+  }
+}
+
+function createAppContext(): AppContext {
+  const container = new ServiceContainer();
+  const config = new AppConfigStore() as unknown as ConfigStore;
+  const dependencies: MutableAppDependencies = { container };
+  const context: ProviderContext = { container, config, dependencies };
+
+  runProviderPhase(starterProviders, "register", context);
+  runProviderPhase(starterProviders, "boot", context);
+
+  assertAppDependenciesComplete(dependencies);
+
+  const appContext = { container, config, dependencies: dependencies as AppDependencies };
+  setActiveApplicationContext(appContext as never);
+  return appContext;
+}
+
+export async function bootstrapApp(options: BootstrapOptions = {}): Promise<BootstrappedApp> {
+  const { migrate: runMigrate = true } = options;
+
+  const appConfig = loadConfig();
+  const context = createAppContext();
+
+  if (runMigrate) {
+    await migrate();
+  }
+
+  const routes = buildRoutes(context.dependencies);
+
+  return { context, routes, config: appConfig };
+}
+
+export function createAppServer(routes: AppRouteMap, port = 0) {
+  return createWebServer({
+    port,
+    publicDir: "./public",
+    routes,
+  });
+}
+
+export { createAppContext };

package/dist/templates/src/bootstrap/database.ts

@@ -1,12 +1,14 @@
-import postgres from "postgres";
+import { SQL } from "bun";
 
-let sql: ReturnType<typeof postgres> | null = null;
+export type SqlClient = InstanceType<typeof SQL>;
 
-export function getSql() {
+let sql: SqlClient | null = null;
+
+export function getSql(): SqlClient {
   if (!sql) {
     const url = process.env.DATABASE_URL;
     if (!url) throw new Error("DATABASE_URL is required");
-    sql = postgres(url, { max: 5 });
+    sql = new SQL({ url, max: 5 });
   }
   return sql;
 }
@@ -22,7 +24,7 @@ export async function pingDatabase(): Promise<boolean> {
 
 export async function closeDatabase() {
   if (sql) {
-    await sql.end();
+    await sql.close();
     sql = null;
   }
 }

package/dist/templates/src/bootstrap/preload.ts

@@ -1,17 +1,5 @@
-import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
-
-const envPath = join(import.meta.dir, "../../.env");
-if (existsSync(envPath)) {
-  for (const line of readFileSync(envPath, "utf8").split("\n")) {
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith("#")) continue;
-    const idx = trimmed.indexOf("=");
-    if (idx === -1) continue;
-    const key = trimmed.slice(0, idx);
-    const value = trimmed.slice(idx + 1);
-    if (!process.env[key]) process.env[key] = value;
-  }
-}
+import { configureModulesDirectory } from "@getstrata/bootstrap/discoverModules";
 
 process.env.DATABASE_URL ??= "postgresql://postgres:postgres@localhost:5432/{{PROJECT_NAME}}";
+configureModulesDirectory(join(import.meta.dir, "../modules"));

package/dist/templates/src/bootstrap/providers/auth.ts

@@ -0,0 +1,41 @@
+import { CORE_AUTH_TOKEN } from "@getstrata/bootstrap/config";
+import type { AuthUser } from "@getstrata/core/auth/authContext";
+import { currentAuthUser } from "@getstrata/core/auth/authContext";
+import type { ServiceProvider } from "@getstrata/core/contracts/di";
+
+class StarterAuthManager {
+  async resolve(request?: Request): Promise<AuthUser | null> {
+    if (request) {
+      const userId = request.headers.get("x-authenticated-user-id");
+      if (!userId) {
+        return null;
+      }
+
+      const role = request.headers.get("x-authenticated-user-role");
+
+      return {
+        id: userId,
+        ...(role ? { role } : {}),
+      };
+    }
+
+    return currentAuthUser();
+  }
+
+  user(request?: Request) {
+    return this.resolve(request);
+  }
+
+  async check(request: Request) {
+    return (await this.user(request)) !== null;
+  }
+}
+
+const authProvider: ServiceProvider = {
+  name: "starter.auth",
+  register({ container }) {
+    container.set(CORE_AUTH_TOKEN, new StarterAuthManager());
+  },
+};
+
+export default authProvider;

package/dist/templates/src/bootstrap/providers/cache.ts

@@ -0,0 +1,28 @@
+import { CORE_CACHE_TOKEN } from "@getstrata/bootstrap/config";
+import { createCacheStore } from "@getstrata/core/cache/createCacheStore";
+import { CacheRepository } from "@getstrata/core/cache/repository";
+import type { ServiceProvider } from "@getstrata/core/contracts/di";
+
+const cacheProvider: ServiceProvider = {
+  name: "starter.cache",
+  register({ container, config, dependencies }) {
+    container.singleton(CORE_CACHE_TOKEN, () => {
+      const ttlMs = config.get<number>("cache.ttlMs") ?? 3_600_000;
+      const maxEntries = config.get<number>("cache.maxEntries") ?? 100;
+      const driver = config.get<"array" | "redis">("cache.driver") ?? "array";
+
+      return new CacheRepository(
+        createCacheStore({
+          driver,
+          ttlMs,
+          maxEntries,
+          redisUrl: process.env.REDIS_URL,
+        }),
+      );
+    });
+
+    Reflect.set(dependencies, "cache", container.resolve(CORE_CACHE_TOKEN));
+  },
+};
+
+export default cacheProvider;

package/dist/templates/src/bootstrap/providers/config.ts

@@ -0,0 +1,27 @@
+import {
+  APP_PORT_CONFIG_KEY,
+  CORE_CONFIG_TOKEN,
+  DATABASE_URL_CONFIG_KEY,
+  REDIS_URL_CONFIG_KEY,
+} from "@getstrata/bootstrap/config";
+import type { ServiceProvider } from "@getstrata/core/contracts/di";
+import { loadConfig } from "../config.ts";
+
+const configProvider: ServiceProvider = {
+  name: "starter.config",
+  register({ container, config }) {
+    const appConfig = loadConfig();
+
+    container.set(CORE_CONFIG_TOKEN, config);
+    config.set(DATABASE_URL_CONFIG_KEY, appConfig.databaseUrl);
+    config.set(APP_PORT_CONFIG_KEY, appConfig.port);
+    config.set(REDIS_URL_CONFIG_KEY, process.env.REDIS_URL ?? "");
+    config.set("app.url", appConfig.appUrl);
+    config.set("cache.driver", "array");
+    config.set("cache.ttlMs", 3_600_000);
+    config.set("cache.maxEntries", 100);
+    config.set("queue.driver", process.env.QUEUE_DRIVER ?? "sync");
+  },
+};
+
+export default configProvider;

package/dist/templates/src/bootstrap/providers/index.ts

@@ -0,0 +1,14 @@
+import type { ServiceProvider } from "@getstrata/core/contracts/di";
+import authProvider from "./auth.ts";
+import cacheProvider from "./cache.ts";
+import configProvider from "./config.ts";
+import storageProvider from "./storage.ts";
+
+const starterProviders: ServiceProvider[] = [
+  configProvider,
+  cacheProvider,
+  storageProvider,
+  authProvider,
+];
+
+export { starterProviders };

package/dist/templates/src/bootstrap/providers/storage.ts

@@ -0,0 +1,11 @@
+import type { ServiceProvider } from "@getstrata/core/contracts/di";
+import { createStorageDriver, StorageManager } from "@getstrata/core/storage/storage";
+
+const storageProvider: ServiceProvider = {
+  name: "starter.storage",
+  register({ dependencies }) {
+    Reflect.set(dependencies, "storage", new StorageManager(createStorageDriver()));
+  },
+};
+
+export default storageProvider;

package/dist/templates/src/bootstrap/server.ts

@@ -1,23 +1,13 @@
-import { createWebServer } from "@getstrata/bootstrap";
 import "./preload.ts";
-import { migrate } from "../db/migrate.ts";
-import { Router } from "../lib/router.ts";
-import { registerRoutes } from "../routes.ts";
-import { loadConfig } from "./config.ts";
+import { ensureModulesLoaded } from "@getstrata/bootstrap/discoverModules";
+import { bootstrapApp, createAppServer } from "./createApp.ts";
 import { closeDatabase, pingDatabase } from "./database.ts";
 
-const config = loadConfig();
+await ensureModulesLoaded();
 
-await migrate();
+const { routes, config } = await bootstrapApp();
 
-const router = new Router();
-registerRoutes(router);
-
-const server = createWebServer({
-  port: config.port,
-  publicDir: "./public",
-  handle: (request) => router.handle(request),
-});
+const server = createAppServer(routes, config.port);
 
 console.log(`${config.appUrl} (port ${server.port})`);
 

package/dist/templates/src/lib/view.ts

@@ -1,7 +1,7 @@
 import { join } from "node:path";
-import { Eta } from "eta";
+import { EtaViewEngine, htmlResponse } from "@getstrata/core/view";
 
-const eta = new Eta({ views: join(import.meta.dir, "../../views") });
+const engine = new EtaViewEngine(join(import.meta.dir, "../../views"));
 
 export interface LayoutData {
   title: string;
@@ -12,11 +12,8 @@ export async function renderPage(
   template: string,
   data: Record<string, unknown> & { layout: LayoutData },
 ): Promise<Response> {
-  const body = await eta.renderAsync(template, data);
-  const html = await eta.renderAsync("layouts/app.eta", { ...data, body });
-  return new Response(html, {
-    headers: { "content-type": "text/html; charset=utf-8" },
-  });
+  const html = await engine.render(template, data);
+  return htmlResponse(html);
 }
 
 export function plainText(body: string): Response {

package/dist/templates/src/modules/site/index.ts

@@ -0,0 +1,29 @@
+import type { AppModule } from "@getstrata/bootstrap/contracts";
+import { withErrorHandling } from "@getstrata/core/http/response";
+import { pingDatabase } from "../../bootstrap/database.ts";
+import { plainText, renderPage } from "../../lib/view.ts";
+
+const siteModule: AppModule = {
+  name: "site",
+  order: 1,
+  webRoutes({ kernel }) {
+    return {
+      "/": kernel.wrapWeb(async () =>
+        renderPage("home.eta", {
+          layout: {
+            title: "Home",
+            description: "A new Strata application",
+          },
+        }),
+      ),
+      "/health": kernel.wrapWeb(
+        withErrorHandling(async () => {
+          const dbOk = await pingDatabase();
+          return plainText(dbOk ? "ok" : "degraded");
+        }),
+      ),
+    };
+  },
+};
+
+export default siteModule;

package/dist/templates/src/routes.ts

@@ -1,23 +1,6 @@
-import { withErrorHandling } from "@getstrata/core";
-import { pingDatabase } from "./bootstrap/database.ts";
-import type { Router } from "./lib/router.ts";
-import { plainText, renderPage } from "./lib/view.ts";
+import { buildWebModuleRoutes } from "@getstrata/bootstrap/buildWebModuleRoutes";
+import type { AppDependencies, AppRouteMap } from "@getstrata/bootstrap/contracts";
 
-export function registerRoutes(router: Router) {
-  router.get("/", async () =>
-    renderPage("home.eta", {
-      layout: {
-        title: "Home",
-        description: "A new Strata application",
-      },
-    }),
-  );
-
-  router.get(
-    "/health",
-    withErrorHandling(async () => {
-      const dbOk = await pingDatabase();
-      return plainText(dbOk ? "ok" : "degraded");
-    }),
-  );
+export function buildRoutes(dependencies: AppDependencies): AppRouteMap {
+  return buildWebModuleRoutes(dependencies);
 }

package/dist/templates/templates/.env.example

@@ -1,3 +1,18 @@
 DATABASE_URL=postgresql://postgres:postgres@localhost:5432/{{PROJECT_NAME}}
 PORT=3000
 APP_URL=http://localhost:3000
+APP_ENV=local
+FRONTEND_MODE=api
+TENANCY_DRIVER=none
+
+# Required in production when FRONTEND_MODE=server-htmx
+# SESSION_SECRET=
+
+# Set only behind a trusted reverse proxy
+# TRUST_FORWARDED_FOR=true
+
+# Required in production to expose GET /metrics
+# METRICS_TOKEN=
+
+# Production should set FEATURE_PUBLIC_READS=false
+# FEATURE_PUBLIC_READS=false

package/dist/templates/templates/package.json

@@ -11,13 +11,11 @@
     "check": "tsc --noEmit"
   },
   "dependencies": {
-    "@getstrata/bootstrap": "^0.1.0",
-    "@getstrata/core": "^0.3.0",
-    "eta": "^4.6.0",
-    "postgres": "3.4.7"
+    "@getstrata/bootstrap": "^0.2.48",
+    "@getstrata/core": "^0.5.57"
   },
   "devDependencies": {
-    "@types/bun": "latest",
+    "@types/bun": "^1.4.0",
     "typescript": "^5.9.2"
   }
 }

package/dist/templates/templates/src/bootstrap/createApp.ts

@@ -0,0 +1,93 @@
+import { runProviderPhase } from "@getstrata/bootstrap/context";
+import {
+  type AppContext,
+  type AppDependencies,
+  type AppRouteMap,
+  assertAppDependenciesComplete,
+  type ConfigStore,
+  type MutableAppDependencies,
+  type ProviderContext,
+  ServiceContainer,
+} from "@getstrata/bootstrap/contracts";
+import { createWebServer } from "@getstrata/bootstrap/web/server";
+import { setActiveApplicationContext } from "@getstrata/core/runtime/applicationRegistry";
+import { migrate } from "../db/migrate.ts";
+import { buildRoutes } from "../routes.ts";
+import { loadConfig } from "./config.ts";
+import { starterProviders } from "./providers/index.ts";
+
+export interface BootstrapOptions {
+  migrate?: boolean;
+}
+
+export interface BootstrappedApp {
+  context: AppContext;
+  routes: AppRouteMap;
+  config: ReturnType<typeof loadConfig>;
+}
+
+class AppConfigStore {
+  private readonly values = new Map<string, unknown>();
+
+  set<T>(key: string, value: T): T {
+    this.values.set(key, value);
+    return value;
+  }
+
+  get<T>(key: string): T | undefined {
+    return this.values.get(key) as T | undefined;
+  }
+
+  require<T>(key: string): T {
+    const value = this.get<T>(key);
+    if (value === undefined) {
+      throw new Error(`Missing required config value "${key}".`);
+    }
+    return value;
+  }
+
+  has(key: string): boolean {
+    return this.values.has(key);
+  }
+}
+
+function createAppContext(): AppContext {
+  const container = new ServiceContainer();
+  const config = new AppConfigStore() as unknown as ConfigStore;
+  const dependencies: MutableAppDependencies = { container };
+  const context: ProviderContext = { container, config, dependencies };
+
+  runProviderPhase(starterProviders, "register", context);
+  runProviderPhase(starterProviders, "boot", context);
+
+  assertAppDependenciesComplete(dependencies);
+
+  const appContext = { container, config, dependencies: dependencies as AppDependencies };
+  setActiveApplicationContext(appContext as never);
+  return appContext;
+}
+
+export async function bootstrapApp(options: BootstrapOptions = {}): Promise<BootstrappedApp> {
+  const { migrate: runMigrate = true } = options;
+
+  const appConfig = loadConfig();
+  const context = createAppContext();
+
+  if (runMigrate) {
+    await migrate();
+  }
+
+  const routes = buildRoutes(context.dependencies);
+
+  return { context, routes, config: appConfig };
+}
+
+export function createAppServer(routes: AppRouteMap, port = 0) {
+  return createWebServer({
+    port,
+    publicDir: "./public",
+    routes,
+  });
+}
+
+export { createAppContext };

package/dist/templates/templates/src/bootstrap/database.ts

@@ -1,12 +1,14 @@
-import postgres from "postgres";
+import { SQL } from "bun";
 
-let sql: ReturnType<typeof postgres> | null = null;
+export type SqlClient = InstanceType<typeof SQL>;
 
-export function getSql() {
+let sql: SqlClient | null = null;
+
+export function getSql(): SqlClient {
   if (!sql) {
     const url = process.env.DATABASE_URL;
     if (!url) throw new Error("DATABASE_URL is required");
-    sql = postgres(url, { max: 5 });
+    sql = new SQL({ url, max: 5 });
   }
   return sql;
 }
@@ -22,7 +24,7 @@ export async function pingDatabase(): Promise<boolean> {
 
 export async function closeDatabase() {
   if (sql) {
-    await sql.end();
+    await sql.close();
     sql = null;
   }
 }

package/dist/templates/templates/src/bootstrap/preload.ts

@@ -1,17 +1,5 @@
-import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
-
-const envPath = join(import.meta.dir, "../../.env");
-if (existsSync(envPath)) {
-  for (const line of readFileSync(envPath, "utf8").split("\n")) {
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith("#")) continue;
-    const idx = trimmed.indexOf("=");
-    if (idx === -1) continue;
-    const key = trimmed.slice(0, idx);
-    const value = trimmed.slice(idx + 1);
-    if (!process.env[key]) process.env[key] = value;
-  }
-}
+import { configureModulesDirectory } from "@getstrata/bootstrap/discoverModules";
 
 process.env.DATABASE_URL ??= "postgresql://postgres:postgres@localhost:5432/{{PROJECT_NAME}}";
+configureModulesDirectory(join(import.meta.dir, "../modules"));

package/dist/templates/templates/src/bootstrap/providers/auth.ts

@@ -0,0 +1,41 @@
+import { CORE_AUTH_TOKEN } from "@getstrata/bootstrap/config";
+import type { AuthUser } from "@getstrata/core/auth/authContext";
+import { currentAuthUser } from "@getstrata/core/auth/authContext";
+import type { ServiceProvider } from "@getstrata/core/contracts/di";
+
+class StarterAuthManager {
+  async resolve(request?: Request): Promise<AuthUser | null> {
+    if (request) {
+      const userId = request.headers.get("x-authenticated-user-id");
+      if (!userId) {
+        return null;
+      }
+
+      const role = request.headers.get("x-authenticated-user-role");
+
+      return {
+        id: userId,
+        ...(role ? { role } : {}),
+      };
+    }
+
+    return currentAuthUser();
+  }
+
+  user(request?: Request) {
+    return this.resolve(request);
+  }
+
+  async check(request: Request) {
+    return (await this.user(request)) !== null;
+  }
+}
+
+const authProvider: ServiceProvider = {
+  name: "starter.auth",
+  register({ container }) {
+    container.set(CORE_AUTH_TOKEN, new StarterAuthManager());
+  },
+};
+
+export default authProvider;

package/dist/templates/templates/src/bootstrap/providers/cache.ts

@@ -0,0 +1,28 @@
+import { CORE_CACHE_TOKEN } from "@getstrata/bootstrap/config";
+import { createCacheStore } from "@getstrata/core/cache/createCacheStore";
+import { CacheRepository } from "@getstrata/core/cache/repository";
+import type { ServiceProvider } from "@getstrata/core/contracts/di";
+
+const cacheProvider: ServiceProvider = {
+  name: "starter.cache",
+  register({ container, config, dependencies }) {
+    container.singleton(CORE_CACHE_TOKEN, () => {
+      const ttlMs = config.get<number>("cache.ttlMs") ?? 3_600_000;
+      const maxEntries = config.get<number>("cache.maxEntries") ?? 100;
+      const driver = config.get<"array" | "redis">("cache.driver") ?? "array";
+
+      return new CacheRepository(
+        createCacheStore({
+          driver,
+          ttlMs,
+          maxEntries,
+          redisUrl: process.env.REDIS_URL,
+        }),
+      );
+    });
+
+    Reflect.set(dependencies, "cache", container.resolve(CORE_CACHE_TOKEN));
+  },
+};
+
+export default cacheProvider;

package/dist/templates/templates/src/bootstrap/providers/config.ts

@@ -0,0 +1,27 @@
+import {
+  APP_PORT_CONFIG_KEY,
+  CORE_CONFIG_TOKEN,
+  DATABASE_URL_CONFIG_KEY,
+  REDIS_URL_CONFIG_KEY,
+} from "@getstrata/bootstrap/config";
+import type { ServiceProvider } from "@getstrata/core/contracts/di";
+import { loadConfig } from "../config.ts";
+
+const configProvider: ServiceProvider = {
+  name: "starter.config",
+  register({ container, config }) {
+    const appConfig = loadConfig();
+
+    container.set(CORE_CONFIG_TOKEN, config);
+    config.set(DATABASE_URL_CONFIG_KEY, appConfig.databaseUrl);
+    config.set(APP_PORT_CONFIG_KEY, appConfig.port);
+    config.set(REDIS_URL_CONFIG_KEY, process.env.REDIS_URL ?? "");
+    config.set("app.url", appConfig.appUrl);
+    config.set("cache.driver", "array");
+    config.set("cache.ttlMs", 3_600_000);
+    config.set("cache.maxEntries", 100);
+    config.set("queue.driver", process.env.QUEUE_DRIVER ?? "sync");
+  },
+};
+
+export default configProvider;

package/dist/templates/templates/src/bootstrap/providers/index.ts

@@ -0,0 +1,14 @@
+import type { ServiceProvider } from "@getstrata/core/contracts/di";
+import authProvider from "./auth.ts";
+import cacheProvider from "./cache.ts";
+import configProvider from "./config.ts";
+import storageProvider from "./storage.ts";
+
+const starterProviders: ServiceProvider[] = [
+  configProvider,
+  cacheProvider,
+  storageProvider,
+  authProvider,
+];
+
+export { starterProviders };

package/dist/templates/templates/src/bootstrap/providers/storage.ts

@@ -0,0 +1,11 @@
+import type { ServiceProvider } from "@getstrata/core/contracts/di";
+import { createStorageDriver, StorageManager } from "@getstrata/core/storage/storage";
+
+const storageProvider: ServiceProvider = {
+  name: "starter.storage",
+  register({ dependencies }) {
+    Reflect.set(dependencies, "storage", new StorageManager(createStorageDriver()));
+  },
+};
+
+export default storageProvider;

package/dist/templates/templates/src/bootstrap/server.ts

@@ -1,23 +1,13 @@
-import { createWebServer } from "@getstrata/bootstrap";
 import "./preload.ts";
-import { migrate } from "../db/migrate.ts";
-import { Router } from "../lib/router.ts";
-import { registerRoutes } from "../routes.ts";
-import { loadConfig } from "./config.ts";
+import { ensureModulesLoaded } from "@getstrata/bootstrap/discoverModules";
+import { bootstrapApp, createAppServer } from "./createApp.ts";
 import { closeDatabase, pingDatabase } from "./database.ts";
 
-const config = loadConfig();
+await ensureModulesLoaded();
 
-await migrate();
+const { routes, config } = await bootstrapApp();
 
-const router = new Router();
-registerRoutes(router);
-
-const server = createWebServer({
-  port: config.port,
-  publicDir: "./public",
-  handle: (request) => router.handle(request),
-});
+const server = createAppServer(routes, config.port);
 
 console.log(`${config.appUrl} (port ${server.port})`);
 

package/dist/templates/templates/src/lib/view.ts

@@ -1,7 +1,7 @@
 import { join } from "node:path";
-import { Eta } from "eta";
+import { EtaViewEngine, htmlResponse } from "@getstrata/core/view";
 
-const eta = new Eta({ views: join(import.meta.dir, "../../views") });
+const engine = new EtaViewEngine(join(import.meta.dir, "../../views"));
 
 export interface LayoutData {
   title: string;
@@ -12,11 +12,8 @@ export async function renderPage(
   template: string,
   data: Record<string, unknown> & { layout: LayoutData },
 ): Promise<Response> {
-  const body = await eta.renderAsync(template, data);
-  const html = await eta.renderAsync("layouts/app.eta", { ...data, body });
-  return new Response(html, {
-    headers: { "content-type": "text/html; charset=utf-8" },
-  });
+  const html = await engine.render(template, data);
+  return htmlResponse(html);
 }
 
 export function plainText(body: string): Response {

package/dist/templates/templates/src/modules/site/index.ts

@@ -0,0 +1,29 @@
+import type { AppModule } from "@getstrata/bootstrap/contracts";
+import { withErrorHandling } from "@getstrata/core/http/response";
+import { pingDatabase } from "../../bootstrap/database.ts";
+import { plainText, renderPage } from "../../lib/view.ts";
+
+const siteModule: AppModule = {
+  name: "site",
+  order: 1,
+  webRoutes({ kernel }) {
+    return {
+      "/": kernel.wrapWeb(async () =>
+        renderPage("home.eta", {
+          layout: {
+            title: "Home",
+            description: "A new Strata application",
+          },
+        }),
+      ),
+      "/health": kernel.wrapWeb(
+        withErrorHandling(async () => {
+          const dbOk = await pingDatabase();
+          return plainText(dbOk ? "ok" : "degraded");
+        }),
+      ),
+    };
+  },
+};
+
+export default siteModule;

package/dist/templates/templates/src/routes.ts

@@ -1,23 +1,6 @@
-import { withErrorHandling } from "@getstrata/core";
-import { pingDatabase } from "./bootstrap/database.ts";
-import type { Router } from "./lib/router.ts";
-import { plainText, renderPage } from "./lib/view.ts";
+import { buildWebModuleRoutes } from "@getstrata/bootstrap/buildWebModuleRoutes";
+import type { AppDependencies, AppRouteMap } from "@getstrata/bootstrap/contracts";
 
-export function registerRoutes(router: Router) {
-  router.get("/", async () =>
-    renderPage("home.eta", {
-      layout: {
-        title: "Home",
-        description: "A new Strata application",
-      },
-    }),
-  );
-
-  router.get(
-    "/health",
-    withErrorHandling(async () => {
-      const dbOk = await pingDatabase();
-      return plainText(dbOk ? "ok" : "degraded");
-    }),
-  );
+export function buildRoutes(dependencies: AppDependencies): AppRouteMap {
+  return buildWebModuleRoutes(dependencies);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getstrata/starter",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Scaffold a new Strata app — bun create strata",
   "type": "module",
   "license": "MIT",

package/dist/templates/src/lib/router.ts

@@ -1,60 +0,0 @@
-export type HttpMethod = "GET" | "POST";
-
-export type RouteHandler = (
-  request: Request,
-  params: Record<string, string>,
-) => Response | Promise<Response>;
-
-interface Route {
-  method: HttpMethod;
-  pattern: RegExp;
-  paramNames: string[];
-  handler: RouteHandler;
-}
-
-export class Router {
-  private routes: Route[] = [];
-
-  get(path: string, handler: RouteHandler) {
-    this.add("GET", path, handler);
-  }
-
-  post(path: string, handler: RouteHandler) {
-    this.add("POST", path, handler);
-  }
-
-  private add(method: HttpMethod, path: string, handler: RouteHandler) {
-    const paramNames: string[] = [];
-    const patternSource = path
-      .replace(/\//g, "\\/")
-      .replace(/:([a-zA-Z_]+)/g, (_, name: string) => {
-        paramNames.push(name);
-        return "([^/]+)";
-      });
-    this.routes.push({
-      method,
-      pattern: new RegExp(`^${patternSource}$`),
-      paramNames,
-      handler,
-    });
-  }
-
-  async handle(request: Request): Promise<Response | null> {
-    const url = new URL(request.url);
-    const pathname = url.pathname.replace(/\/+$/, "") || "/";
-
-    for (const route of this.routes) {
-      if (route.method !== request.method) continue;
-      const match = pathname.match(route.pattern);
-      if (!match) continue;
-
-      const params: Record<string, string> = {};
-      route.paramNames.forEach((name, index) => {
-        params[name] = decodeURIComponent(match[index + 1] ?? "");
-      });
-      return await route.handler(request, params);
-    }
-
-    return null;
-  }
-}

package/dist/templates/templates/src/lib/router.ts

@@ -1,60 +0,0 @@
-export type HttpMethod = "GET" | "POST";
-
-export type RouteHandler = (
-  request: Request,
-  params: Record<string, string>,
-) => Response | Promise<Response>;
-
-interface Route {
-  method: HttpMethod;
-  pattern: RegExp;
-  paramNames: string[];
-  handler: RouteHandler;
-}
-
-export class Router {
-  private routes: Route[] = [];
-
-  get(path: string, handler: RouteHandler) {
-    this.add("GET", path, handler);
-  }
-
-  post(path: string, handler: RouteHandler) {
-    this.add("POST", path, handler);
-  }
-
-  private add(method: HttpMethod, path: string, handler: RouteHandler) {
-    const paramNames: string[] = [];
-    const patternSource = path
-      .replace(/\//g, "\\/")
-      .replace(/:([a-zA-Z_]+)/g, (_, name: string) => {
-        paramNames.push(name);
-        return "([^/]+)";
-      });
-    this.routes.push({
-      method,
-      pattern: new RegExp(`^${patternSource}$`),
-      paramNames,
-      handler,
-    });
-  }
-
-  async handle(request: Request): Promise<Response | null> {
-    const url = new URL(request.url);
-    const pathname = url.pathname.replace(/\/+$/, "") || "/";
-
-    for (const route of this.routes) {
-      if (route.method !== request.method) continue;
-      const match = pathname.match(route.pattern);
-      if (!match) continue;
-
-      const params: Record<string, string> = {};
-      route.paramNames.forEach((name, index) => {
-        params[name] = decodeURIComponent(match[index + 1] ?? "");
-      });
-      return await route.handler(request, params);
-    }
-
-    return null;
-  }
-}