create-oke 0.2.3 → 0.2.8

package/templates/full/oke.config.ts

@@ -3,19 +3,48 @@ import { defineConfig } from "okengine/config";
 export default defineConfig({
   drivers: {
     store: {
-      sql: { dev: "sqlite", test: "memory", prod: "postgres" },
-      kv: { dev: "memory", test: "memory", prod: "redis" },
+      sql: {
+        local: "sqlite",
+        docker: "postgres",
+        test: "memory",
+        prod: "postgres",
+      },
+      kv: {
+        local: "memory",
+        docker: "redis",
+        test: "memory",
+        prod: "redis",
+      },
+    },
+    signal: {
+      local: "memory",
+      docker: "postgres",
+      test: "memory",
+      prod: "postgres",
+    },
+    clock: {
+      local: "memory",
+      docker: "postgres",
+      test: "frozen",
+      prod: "postgres",
+    },
+    vault: {
+      local: "dotenv",
+      docker: "dotenv",
+      test: "memory",
+      prod: "sops",
     },
-    signal: { dev: "memory", test: "memory", prod: "postgres" },
-    clock: { dev: "memory", test: "frozen", prod: "postgres" },
-    vault: { dev: "dotenv", test: "memory", prod: "sops" },
     channel: {
-      email: { dev: "console", test: "console", prod: "smtp" },
-      sms: { dev: "console", test: "console", prod: "unifonic" },
-      whatsapp: { dev: "console", test: "console", prod: "wa-cloud" },
+      email: {
+        local: "console",
+        docker: "smtp",
+        test: "console",
+        prod: "smtp",
+      },
     },
     ai: {
-      dev: "mock",
+      local: "mock",
+      docker: "mock",
       test: "mock",
     },
   },

package/templates/full/package.json

@@ -8,6 +8,9 @@
     "drizzle-orm": "^1.0.0-rc.4",
     "zod": "^4.4.3"
   },
+  "devDependencies": {
+    "drizzle-kit": "^1.0.0-rc.4"
+  },
   "scripts": {
     "test": "bun test",
     "dev": "oke dev"

package/templates/hello/.env.example

@@ -0,0 +1,9 @@
+# Environment template — copy to `.env.local` for local overrides.
+# create-oke copies this file to `.env.local` when you scaffold a new project.
+#
+# Resolution order (first hit wins):
+#   process.env → .env.local → docker/.env.docker → vault driver → dev fallback
+#
+# This template has no Vault declarations and no pinned infrastructure drivers.
+# Add variables here when you introduce `vault.secret(...)` in src/vault.ts or
+# pin postgres/redis/s3/smtp drivers in oke.config.ts.

package/templates/hello/README.md

@@ -7,18 +7,20 @@ Fastest possible “it works” — one unit, two HTTP flows, **no Store**.
 ```bash
 bun install
 oke dev          # app :6530 · Console :6533 · MCP :6535
+# or: oke mode docker && oke dev   # compose infra on host Bun
 ```
 
-| Port | Try |
-|---|---|
+| Port    | Try                    |
+| ------- | ---------------------- |
 | `:6530` | `GET /` · `GET /hello` |
-| `:6533` | Console |
-| `:6535` | MCP |
+| `:6533` | Console                |
+| `:6535` | MCP                    |
 
 ## What’s in this template
 
 ```text
 hello/
+├── .env.example               # copied to .env.local by create-oke
 ├── oke.config.ts
 ├── src/
 │   ├── app.ts                 # oke({ name: "hello" }).adopt({ hello })

package/templates/minimal/.env.example

@@ -0,0 +1,13 @@
+# Environment template — copy to `.env.local` for local overrides.
+# create-oke copies this file to `.env.local` when you scaffold a new project.
+#
+# Resolution order (first hit wins):
+#   process.env → .env.local → docker/.env.docker → vault driver → dev fallback
+#
+# --- Infrastructure (optional) ---
+# This app pins postgres for docker/prod SQL in oke.config.ts.
+# Local dev uses sqlite by default; uncomment only when overriding postgres URLs.
+# Run `oke dev --docker` to write role-accurate keys into `docker/.env.docker`.
+
+# DATABASE_URL — primary Postgres connection; from your host (Neon, RDS, …) or `docker/.env.docker` after `oke dev --docker`
+# DATABASE_URL=postgres://user:password@127.0.0.1:5432/oke

package/templates/minimal/README.md

@@ -7,23 +7,29 @@ Smallest shape you’d actually ship — **Store + HTTP flows** over a single ta
 ```bash
 bun install
 oke dev          # app :6530 · Console :6533 · MCP :6535
+# or: oke mode docker && oke dev   # postgres via compose
 ```
 
-| Port | Try |
-|---|---|
+Local `oke dev` auto-runs `oke db push` when `schema.ts` changes (opt out:
+`--no-db-push`). Docker/prod never auto-apply DDL — use `oke db migrate`.
+
+| Port    | Try                                         |
+| ------- | ------------------------------------------- |
 | `:6530` | `GET /` · `GET /entries` · `POST /entries` |
-| `:6533` | Console |
-| `:6535` | MCP |
+| `:6533` | Console                                     |
+| `:6535` | MCP                                         |
 
 ## What’s in this template
 
 ```text
 minimal/
-├── oke.config.ts
+├── .env.example               # copied to .env.local by create-oke
+├── drizzle.config.ts          # oke db push|generate|migrate
+├── oke.config.ts              # local: sqlite · docker/prod: postgres
 ├── src/
 │   ├── app.ts                 # adopt({ main }), stores: [db]
 │   ├── core.ts                # store.sql("…")
-│   ├── schema.ts              # entries table (Drizzle)
+│   ├── schema.ts              # entries table (Drizzle escape hatch)
 │   └── flows/main/index.ts    # GET / · GET|POST /entries
 └── tests/minimal.test.ts
 ```
@@ -33,7 +39,9 @@ minimal/
 - **Flows:** `root`, `list` (`GET /entries`), `create` (`POST /entries` with `{ body }`)
 - **Schema:** `entries` — `id`, `body`, `createdAt`
 
-Swap `entries` for your domain table and grow flows beside it. Need gates,
+Swap `entries` for your domain table and grow flows beside it. Prefer
+`store.schema.table` + `field.*` in `schema.decl.ts` when you want ORM-agnostic
+declare (Linkly); hand-written `schema.ts` remains the escape hatch. Need gates,
 channels, or locales? Use `standard`.
 
 ## Agent contract

package/templates/minimal/drizzle.config.ts

@@ -0,0 +1,14 @@
+import { defineConfig } from "drizzle-kit";
+
+/**
+ * Domain schema sync for `oke db push|generate|migrate`.
+ * Versioned prod migrations land in `./drizzle` — never mix with `.oke/`.
+ */
+export default defineConfig({
+  dialect: "sqlite",
+  schema: "./src/schema.ts",
+  out: "./drizzle",
+  dbCredentials: {
+    url: process.env.OKE_SQLITE_URL ?? "file:.oke/app.sqlite",
+  },
+});

package/templates/minimal/oke.config.ts

@@ -2,6 +2,13 @@ import { defineConfig } from "okengine/config";
 
 export default defineConfig({
   drivers: {
-    store: { sql: { dev: "sqlite", test: "memory", prod: "postgres" } },
+    store: {
+      sql: {
+        local: "sqlite",
+        docker: "postgres",
+        test: "memory",
+        prod: "postgres",
+      },
+    },
   },
 });

package/templates/minimal/package.json

@@ -8,6 +8,9 @@
     "drizzle-orm": "^1.0.0-rc.4",
     "zod": "^4.4.3"
   },
+  "devDependencies": {
+    "drizzle-kit": "^1.0.0-rc.4"
+  },
   "scripts": {
     "test": "bun test",
     "dev": "oke dev"

package/templates/standard/.env.example

@@ -0,0 +1,21 @@
+# Environment template — copy to `.env.local` for local overrides.
+# create-oke copies this file to `.env.local` when you scaffold a new project.
+#
+# Resolution order (first hit wins):
+#   process.env → .env.local → docker/.env.docker → vault driver → dev fallback
+#
+# --- Vault (app secrets) ---
+# Declare secrets in src/vault.ts with `vault.secret(...)`, then uncomment lines here.
+
+# --- Infrastructure (optional) ---
+# Commented — this app pins postgres, redis, and smtp (Mailpit) in oke.config.ts.
+# Run `oke dev --docker` to write role-accurate keys into `docker/.env.docker`.
+
+# DATABASE_URL — primary Postgres connection; from your host or `docker/.env.docker` after `oke dev --docker`
+# DATABASE_URL=postgres://user:password@127.0.0.1:5432/oke
+
+# REDIS_URL — Redis/Valkey connection for store.kv; from your host or `docker/.env.docker` after `oke dev --docker`
+# REDIS_URL=redis://:password@127.0.0.1:6379
+
+# SMTP_URL — outbound email (Mailpit in docker dev); from your provider or `docker/.env.docker` after `oke dev --docker`
+# SMTP_URL=smtp://127.0.0.1:1025

package/templates/standard/README.md

@@ -8,19 +8,25 @@ business logic. Default `create-oke` template.
 ```bash
 bun install
 oke dev          # app :6530 · Console :6533 · MCP :6535
+# or: oke mode docker && oke dev   # postgres · redis · Mailpit · RustFS · sops
 ```
 
-| Port | Try |
-|---|---|
-| `:6530` | `GET /` · `GET /health` |
-| `:6533` | Console |
-| `:6535` | MCP |
+Local `oke dev` auto-runs `oke db push` when `schema.ts` changes (opt out:
+`--no-db-push`). Docker/prod never auto-apply DDL — use `oke db migrate`.
+
+| Port    | Try                       |
+| ------- | ------------------------- |
+| `:6530` | `GET /` · `GET /health`   |
+| `:6533` | Console                   |
+| `:6535` | MCP                       |
 
 ## What’s in this template
 
 ```text
 standard/
-├── oke.config.ts
+├── .env.example               # copied to .env.local by create-oke
+├── drizzle.config.ts          # oke db push|generate|migrate
+├── oke.config.ts              # local: sqlite · docker/prod: postgres
 ├── src/
 │   ├── app.ts                 # adopt({ main }); wires stores + side modules
 │   ├── core.ts / schema.ts    # Store (replace the placeholder table)
@@ -39,8 +45,19 @@ standard/
 - **Unit:** `main`
 - **Flows to replace:** `root`, `health` — delete or rename once your domain exists
 
-Fill `schema.ts`, then add real flows under `src/flows/<unit>/`. Prefer this
-layout for new products; use `hello` / `minimal` only when you want less surface.
+Fill `schema.ts` (or `schema.decl.ts` + `oke db`), then add real flows under
+`src/flows/<unit>/`. Prefer this layout for new products; use `hello` / `minimal`
+only when you want less surface.
+
+## Docker mode (`oke dev --docker`)
+
+Closest to production protocols: Postgres, Redis, SMTP (Mailpit), S3 (RustFS),
+vault `sops`/age. Compose credentials land in `docker/.env.docker`.
+
+| Surface        | URL                                              |
+| -------------- | ------------------------------------------------ |
+| Mailpit UI     | [http://127.0.0.1:8025](http://127.0.0.1:8025)   |
+| RustFS console | [http://127.0.0.1:9001](http://127.0.0.1:9001)   |
 
 ## Agent contract
 

package/templates/standard/drizzle.config.ts

@@ -0,0 +1,14 @@
+import { defineConfig } from "drizzle-kit";
+
+/**
+ * Domain schema sync for `oke db push|generate|migrate`.
+ * Versioned prod migrations land in `./drizzle` — never mix with `.oke/`.
+ */
+export default defineConfig({
+  dialect: "sqlite",
+  schema: "./src/schema.ts",
+  out: "./drizzle",
+  dbCredentials: {
+    url: process.env.OKE_SQLITE_URL ?? "file:.oke/app.sqlite",
+  },
+});

package/templates/standard/oke.config.ts

@@ -3,16 +3,44 @@ import { defineConfig } from "okengine/config";
 export default defineConfig({
   drivers: {
     store: {
-      sql: { dev: "sqlite", test: "memory", prod: "postgres" },
-      kv: { dev: "memory", test: "memory", prod: "redis" },
+      sql: {
+        local: "sqlite",
+        docker: "postgres",
+        test: "memory",
+        prod: "postgres",
+      },
+      kv: {
+        local: "memory",
+        docker: "redis",
+        test: "memory",
+        prod: "redis",
+      },
+    },
+    signal: {
+      local: "memory",
+      docker: "postgres",
+      test: "memory",
+      prod: "postgres",
+    },
+    clock: {
+      local: "memory",
+      docker: "postgres",
+      test: "frozen",
+      prod: "postgres",
+    },
+    vault: {
+      local: "dotenv",
+      docker: "dotenv",
+      test: "memory",
+      prod: "sops",
     },
-    signal: { dev: "memory", test: "memory", prod: "postgres" },
-    clock: { dev: "memory", test: "frozen", prod: "postgres" },
-    vault: { dev: "dotenv", test: "memory", prod: "sops" },
     channel: {
-      email: { dev: "console", test: "console", prod: "smtp" },
-      sms: { dev: "console", test: "console", prod: "unifonic" },
-      whatsapp: { dev: "console", test: "console", prod: "wa-cloud" },
+      email: {
+        local: "console",
+        docker: "smtp",
+        test: "console",
+        prod: "smtp",
+      },
     },
   },
   images: {

package/templates/standard/package.json

@@ -8,6 +8,9 @@
     "drizzle-orm": "^1.0.0-rc.4",
     "zod": "^4.4.3"
   },
+  "devDependencies": {
+    "drizzle-kit": "^1.0.0-rc.4"
+  },
   "scripts": {
     "test": "bun test",
     "dev": "oke dev"