okengine 0.14.1 → 0.16.0

package/site/content/docs/get-started/index.mdx

@@ -30,6 +30,11 @@ Learn the shape once, install on Bun, then write your first Flow from the standa
     description="Health Flow, typed client, Console proof."
     href="/docs/get-started/basic-usage"
   />
+  <Card
+    title="Project structure"
+    description="Folder and file conventions — URL, name, and the generated barrel."
+    href="/docs/get-started/project-structure"
+  />
   <Card
     title="Deployment"
     description="Compose, Swarm, Kubernetes, and reverse proxy."

package/site/content/docs/get-started/introduction.mdx

@@ -23,19 +23,21 @@ shape. Learn the shape once; only the trigger changes.
 
 Four contracts plus a `do`. This is the standard starter's health check:
 
-```typescript title="health"
+```typescript title="flows/main/health.ts"
 import { on, flow, http } from "okengine";
 import { z } from "zod";
 
 export const health = on(
-  http.get("/health"),
-  flow("health.check", {
+  http.get().public(),
+  flow({
     out: z.object({ ok: z.literal(true) }),
     do: () => ({ ok: true as const }),
   }),
 );
 ```
 
+`main` omits the URL prefix, so this file is `GET /health` named `main.health`. See [Project structure](/docs/get-started/project-structure). Explicit `http.get("/health")` and `flow("main.health")` still win.
+
 </Step>
 
 <Step>
@@ -162,6 +164,7 @@ and `okengine/full`.
 | Topic   | Page                                                                            |
 | ------- | ------------------------------------------------------------------------------- |
 | Why OKE | [Why OKE](/docs/get-started/why)                                                |
+| Folders | [Project structure](/docs/get-started/project-structure)                        |
 | Flow    | [Flow](/docs/elements/flow)                                                     |
 | `fx`    | [fx](/docs/reference/fx)                                                        |
 | Agents  | [MCP](/docs/ai/mcp) · [Skills](/docs/ai/skills) · [llms.txt](/docs/ai/llms-txt) |
@@ -184,4 +187,9 @@ and `okengine/full`.
     description="Health Flow, typed client, and bun:test."
     href="/docs/get-started/basic-usage"
   />
+  <Card
+    title="Project structure"
+    description="Folders are the URL; unit plus export is the name."
+    href="/docs/get-started/project-structure"
+  />
 </Cards>

package/site/content/docs/get-started/meta.json

@@ -1,5 +1,5 @@
 {
   "title": "Get Started",
   "icon": "Rocket",
-  "pages": ["index", "introduction", "why", "installation", "basic-usage"]
+  "pages": ["index", "introduction", "why", "installation", "basic-usage", "project-structure"]
 }