create-daloy 0.6.0 → 0.7.0

package/README.md

@@ -112,7 +112,7 @@ A [Deno](https://deno.com) runtime starter using `@daloyjs/core/deno` with:
 ## Minimal scaffolds
 
 Pass `--minimal` to drop the bookstore demo route and the built-in
-`/docs` + `/openapi.json` Swagger UI routes from any template that supports
+`/docs` + `/openapi.json` API docs routes from any template that supports
 them. The scaffolded app is left with the framework bootstrap and a single
 `/healthz` route — the smallest realistic starting point:
 

package/bin/create-daloy.mjs

@@ -316,7 +316,7 @@ ${heading("Options")}
   ${color(COLORS.green, "--list-templates")}           Print available templates and exit.
   ${color(COLORS.green, "--install / --no-install")}   Install dependencies after scaffolding.
   ${color(COLORS.green, "--git / --no-git")}           Initialize a git repository.
-  ${color(COLORS.green, "--minimal")}                  Strip the bookstore + Swagger/OpenAPI demo routes.
+  ${color(COLORS.green, "--minimal")}                  Strip the bookstore + OpenAPI docs demo routes.
   ${color(COLORS.green, "--with-ci / --no-ci")}         Add hardened GitHub Actions + governance files.
   ${color(COLORS.green, "--code-owner <owner>")}        CODEOWNERS owner for --with-ci, e.g. @acme/security.
   ${color(COLORS.green, "--force")}                    Overwrite an existing non-empty directory.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-daloy",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Scaffold a new DaloyJS project. Run with `pnpm create daloy`, `npm create daloy@latest`, `yarn create daloy`, or `bun create daloy`.",
   "type": "module",
   "license": "MIT",

package/templates/bun-basic/README.md

@@ -21,7 +21,7 @@ curl http://localhost:3000/books/1
 <!-- daloy-minimal:strip-start docs -->
 ## API documentation
 
-- Swagger UI: <http://localhost:3000/docs>
+- API docs (Scalar): <http://localhost:3000/docs>
 - OpenAPI 3.1 JSON: <http://localhost:3000/openapi.json>
 <!-- daloy-minimal:strip-end docs -->
 

package/templates/bun-basic/package.json

@@ -7,7 +7,7 @@
     "bun": ">=1.1.0"
   },
   "scripts": {
-    "dev": "bun --hot src/index.ts",
+    "dev": "daloy dev --runtime bun",
     "start": "bun src/index.ts",
     "typecheck": "tsc --noEmit",
     "test": "bun test",
@@ -16,7 +16,7 @@
     "gen": "pnpm gen:openapi && pnpm gen:client"
   },
   "dependencies": {
-    "@daloyjs/core": "^0.12.0",
+    "@daloyjs/core": "^0.13.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {

package/templates/bun-basic/src/build-app.ts

@@ -6,10 +6,6 @@ import {
   requestId,
   secureHeaders,
 } from "@daloyjs/core";
-// daloy-minimal:strip-start docs
-import { generateOpenAPI } from "@daloyjs/core/openapi";
-import { htmlResponse, swaggerUiHtml } from "@daloyjs/core/docs";
-// daloy-minimal:strip-end docs
 
 /**
  * Build the application as a pure factory so the same `App` is reused by
@@ -22,6 +18,17 @@ export function buildApp(): App {
     bodyLimitBytes: 1024 * 1024,
     requestTimeoutMs: 5_000,
     production: process.env.NODE_ENV === "production",
+    // daloy-minimal:strip-start docs
+    // Auto-mounted docs:
+    //   GET /openapi.json — live OpenAPI 3.1 spec generated from your routes
+    //   GET /docs         — Scalar API reference UI that loads it
+    // `info.title` / `info.version` are pulled from package.json by default;
+    // set `openapi.info` here to override them.
+    openapi: {
+      servers: [{ url: `http://localhost:${process.env.PORT ?? 3000}` }],
+    },
+    docs: true,
+    // daloy-minimal:strip-end docs
   });
 
   app.use(requestId());
@@ -70,40 +77,6 @@ export function buildApp(): App {
   });
   // daloy-minimal:strip-end books
 
-  // daloy-minimal:strip-start docs
-  app.route({
-    method: "GET",
-    path: "/openapi.json",
-    operationId: "getOpenAPI",
-    tags: ["Docs"],
-    responses: { 200: { description: "OpenAPI 3.1 document" } },
-    handler: async () => ({
-      status: 200 as const,
-      body: generateOpenAPI(app, {
-        info: { title: "My Daloy Bun API", version: "0.0.1" },
-        servers: [{ url: `http://localhost:${process.env.PORT ?? 3000}` }],
-      }),
-    }),
-  });
-
-  app.route({
-    method: "GET",
-    path: "/docs",
-    operationId: "docs",
-    tags: ["Docs"],
-    responses: { 200: { description: "API reference UI" } },
-    handler: async () => {
-      const html = swaggerUiHtml({ specUrl: "/openapi.json", title: "My Daloy Bun API" });
-      const res = htmlResponse(html);
-      return {
-        status: 200 as const,
-        body: html,
-        headers: Object.fromEntries(res.headers),
-      };
-    },
-  });
-  // daloy-minimal:strip-end docs
-
   return app;
 }
 

package/templates/bun-basic/src/index.ts

@@ -14,7 +14,7 @@ const handle = serve(app, {
 const url = handle.url ? String(handle.url) : `http://localhost:${port}`;
 const links: StartupBannerLink[] = [
   // daloy-minimal:strip-start docs
-  { label: "Swagger UI", url: `${url}/docs` },
+  { label: "API docs", url: `${url}/docs` },
   { label: "OpenAPI JSON", url: `${url}/openapi.json` },
   // daloy-minimal:strip-end docs
   { label: "Health", url: `${url}/healthz` },

package/templates/cloudflare-worker/package.json

@@ -10,7 +10,7 @@
     "test": "node --import tsx/esm --test tests/**/*.test.ts"
   },
   "dependencies": {
-    "@daloyjs/core": "^0.12.0",
+    "@daloyjs/core": "^0.13.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {

package/templates/deno-basic/README.md

@@ -20,7 +20,7 @@ curl http://localhost:3000/books/1
 <!-- daloy-minimal:strip-start docs -->
 ## API documentation
 
-- Swagger UI: <http://localhost:3000/docs>
+- API docs (Scalar): <http://localhost:3000/docs>
 - OpenAPI 3.1 JSON: <http://localhost:3000/openapi.json>
 <!-- daloy-minimal:strip-end docs -->
 

package/templates/deno-basic/deno.json

@@ -8,8 +8,8 @@
     "gen:openapi": "deno run --allow-net --allow-env --allow-read --allow-write scripts/dump-openapi.ts"
   },
   "imports": {
-    "@daloyjs/core": "npm:@daloyjs/core@^0.12.0",
-    "@daloyjs/core/": "npm:@daloyjs/core@^0.12.0/",
+    "@daloyjs/core": "npm:@daloyjs/core@^0.13.0",
+    "@daloyjs/core/": "npm:@daloyjs/core@^0.13.0/",
     "zod": "npm:zod@^4.4.3"
   },
   "compilerOptions": {

package/templates/deno-basic/src/build-app.ts

@@ -6,10 +6,6 @@ import {
   requestId,
   secureHeaders,
 } from "@daloyjs/core";
-// daloy-minimal:strip-start docs
-import { generateOpenAPI } from "@daloyjs/core/openapi";
-import { htmlResponse, swaggerUiHtml } from "@daloyjs/core/docs";
-// daloy-minimal:strip-end docs
 
 /**
  * Build the application as a pure factory.
@@ -23,6 +19,17 @@ export function buildApp(): App {
     bodyLimitBytes: 1024 * 1024,
     requestTimeoutMs: 5_000,
     production: Deno.env.get("DENO_ENV") === "production",
+    // daloy-minimal:strip-start docs
+    // Auto-mounted docs:
+    //   GET /openapi.json — live OpenAPI 3.1 spec generated from your routes
+    //   GET /docs         — Scalar API reference UI that loads it
+    // `info.title` / `info.version` are pulled from deno.json by default;
+    // set `openapi.info` here to override them.
+    openapi: {
+      servers: [{ url: `http://localhost:${Deno.env.get("PORT") ?? "3000"}` }],
+    },
+    docs: true,
+    // daloy-minimal:strip-end docs
   });
 
   app.use(requestId());
@@ -71,40 +78,6 @@ export function buildApp(): App {
   });
   // daloy-minimal:strip-end books
 
-  // daloy-minimal:strip-start docs
-  app.route({
-    method: "GET",
-    path: "/openapi.json",
-    operationId: "getOpenAPI",
-    tags: ["Docs"],
-    responses: { 200: { description: "OpenAPI 3.1 document" } },
-    handler: async () => ({
-      status: 200 as const,
-      body: generateOpenAPI(app, {
-        info: { title: "My Daloy Deno API", version: "0.0.1" },
-        servers: [{ url: `http://localhost:${Deno.env.get("PORT") ?? "3000"}` }],
-      }),
-    }),
-  });
-
-  app.route({
-    method: "GET",
-    path: "/docs",
-    operationId: "docs",
-    tags: ["Docs"],
-    responses: { 200: { description: "API reference UI" } },
-    handler: async () => {
-      const html = swaggerUiHtml({ specUrl: "/openapi.json", title: "My Daloy Deno API" });
-      const res = htmlResponse(html);
-      return {
-        status: 200 as const,
-        body: html,
-        headers: Object.fromEntries(res.headers),
-      };
-    },
-  });
-  // daloy-minimal:strip-end docs
-
   return app;
 }
 

package/templates/deno-basic/src/main.ts

@@ -11,7 +11,7 @@ serve(app, {
     const url = `http://${hostname}:${actualPort}`;
     const links: StartupBannerLink[] = [
       // daloy-minimal:strip-start docs
-      { label: "Swagger UI", url: `${url}/docs` },
+      { label: "API docs", url: `${url}/docs` },
       { label: "OpenAPI JSON", url: `${url}/openapi.json` },
       // daloy-minimal:strip-end docs
       { label: "Health", url: `${url}/healthz` },

package/templates/node-basic/README.md

@@ -21,7 +21,7 @@ curl http://localhost:3000/books/1
 <!-- daloy-minimal:strip-start docs -->
 ## API documentation
 
-- Swagger UI: <http://localhost:3000/docs>
+- API docs (Scalar): <http://localhost:3000/docs>
 - OpenAPI 3.1 JSON: <http://localhost:3000/openapi.json>
 
 The spec is generated live from your routes, so it stays in sync with what is actually deployed.

package/templates/node-basic/package.json

@@ -7,7 +7,7 @@
     "node": ">=24.15.0"
   },
   "scripts": {
-    "dev": "node --import tsx/esm --watch src/index.ts",
+    "dev": "daloy dev",
     "start": "node --import tsx/esm src/index.ts",
     "build": "tsc -p tsconfig.build.json",
     "typecheck": "tsc --noEmit",
@@ -18,7 +18,7 @@
     "audit": "pnpm audit --prod"
   },
   "dependencies": {
-    "@daloyjs/core": "^0.12.0",
+    "@daloyjs/core": "^0.13.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {

package/templates/node-basic/src/build-app.ts

@@ -6,10 +6,6 @@ import {
   requestId,
   secureHeaders,
 } from "@daloyjs/core";
-// daloy-minimal:strip-start docs
-import { generateOpenAPI } from "@daloyjs/core/openapi";
-import { htmlResponse, swaggerUiHtml } from "@daloyjs/core/docs";
-// daloy-minimal:strip-end docs
 
 /**
  * Build the application as a pure factory.
@@ -24,6 +20,19 @@ export function buildApp(): App {
     bodyLimitBytes: 1024 * 1024,
     requestTimeoutMs: 5_000,
     production: process.env.NODE_ENV === "production",
+    // daloy-minimal:strip-start docs
+    // Auto-mounted docs:
+    //   GET /openapi.json — live OpenAPI 3.1 spec generated from your routes
+    //   GET /docs         — Scalar API reference UI that loads it
+    // `docs: true` always mounts. Use `docs: "auto"` to mount only when
+    // `NODE_ENV !== "production"`, or `docs: false` to disable entirely.
+    // `info.title` / `info.version` are pulled from package.json by default;
+    // set `openapi.info` here to override them.
+    openapi: {
+      servers: [{ url: `http://localhost:${process.env.PORT ?? 3000}` }],
+    },
+    docs: true,
+    // daloy-minimal:strip-end docs
   });
 
   app.use(requestId());
@@ -72,44 +81,6 @@ export function buildApp(): App {
   });
   // daloy-minimal:strip-end books
 
-  // daloy-minimal:strip-start docs
-  // --- API documentation ---------------------------------------------------
-  // `/openapi.json` returns the live OpenAPI 3.1 spec generated from the
-  // routes defined above. `/docs` serves a Swagger UI page that loads it.
-
-  app.route({
-    method: "GET",
-    path: "/openapi.json",
-    operationId: "getOpenAPI",
-    tags: ["Docs"],
-    responses: { 200: { description: "OpenAPI 3.1 document" } },
-    handler: async () => ({
-      status: 200 as const,
-      body: generateOpenAPI(app, {
-        info: { title: "My Daloy API", version: "0.0.1" },
-        servers: [{ url: `http://localhost:${process.env.PORT ?? 3000}` }],
-      }),
-    }),
-  });
-
-  app.route({
-    method: "GET",
-    path: "/docs",
-    operationId: "docs",
-    tags: ["Docs"],
-    responses: { 200: { description: "API reference UI" } },
-    handler: async () => {
-      const html = swaggerUiHtml({ specUrl: "/openapi.json", title: "My Daloy API" });
-      const res = htmlResponse(html);
-      return {
-        status: 200 as const,
-        body: html,
-        headers: Object.fromEntries(res.headers),
-      };
-    },
-  });
-  // daloy-minimal:strip-end docs
-
   return app;
 }
 

package/templates/node-basic/src/index.ts

@@ -10,7 +10,7 @@ serve(app, { port });
 const url = `http://localhost:${port}`;
 const links: StartupBannerLink[] = [
   // daloy-minimal:strip-start docs
-  { label: "Swagger UI", url: `${url}/docs` },
+  { label: "API docs", url: `${url}/docs` },
   { label: "OpenAPI JSON", url: `${url}/openapi.json` },
   // daloy-minimal:strip-end docs
   { label: "Health", url: `${url}/healthz` },

package/templates/vercel-edge/README.md

@@ -21,7 +21,7 @@ curl http://localhost:3000/books/1
 <!-- daloy-minimal:strip-start docs -->
 ## API documentation
 
-- Swagger UI: <http://localhost:3000/docs>
+- API docs (Scalar): <http://localhost:3000/docs>
 - OpenAPI 3.1 JSON: <http://localhost:3000/openapi.json>
 
 After deploying, the same routes serve `/docs` and `/openapi.json` from your Vercel Edge URL.
@@ -61,5 +61,5 @@ That catch-all API route lets DaloyJS own routing while Vercel handles the runti
 - A health route and a contract-first `/books/:id` route with Zod validation.
 <!-- daloy-minimal:strip-end books -->
 <!-- daloy-minimal:strip-start docs -->
-- Swagger UI at `/docs` and a live OpenAPI 3.1 document at `/openapi.json`.
+- A Scalar API reference UI at `/docs` and a live OpenAPI 3.1 document at `/openapi.json`.
 <!-- daloy-minimal:strip-end docs -->

package/templates/vercel-edge/api/[...path].ts

@@ -1,10 +1,6 @@
 import { z } from "zod";
 import { App, NotFoundError, requestId, secureHeaders } from "@daloyjs/core";
 import { toWebHandler } from "@daloyjs/core/vercel";
-// daloy-minimal:strip-start docs
-import { generateOpenAPI } from "@daloyjs/core/openapi";
-import { htmlResponse, swaggerUiHtml } from "@daloyjs/core/docs";
-// daloy-minimal:strip-end docs
 
 // This template defaults to Vercel's Edge runtime for compatibility with the
 // existing `vercel-edge` starter. For Vercel's recommended Node.js runtime,
@@ -15,6 +11,15 @@ const app = new App({
   bodyLimitBytes: 256 * 1024,
   requestTimeoutMs: 5_000,
   production: process.env.NODE_ENV === "production",
+  // daloy-minimal:strip-start docs
+  // Auto-mounted docs:
+  //   GET /openapi.json — live OpenAPI 3.1 spec generated from your routes
+  //   GET /docs         — Scalar API reference UI that loads it
+  openapi: {
+    info: { title: "My Daloy Edge API", version: "0.0.1" },
+  },
+  docs: true,
+  // daloy-minimal:strip-end docs
 });
 
 app.use(requestId());
@@ -61,41 +66,4 @@ app.route({
 });
 // daloy-minimal:strip-end books
 
-// daloy-minimal:strip-start docs
-// --- API documentation -----------------------------------------------------
-// `/openapi.json` returns the OpenAPI 3.1 spec generated from the routes above.
-// `/docs` serves a Swagger UI page that loads that spec.
-
-app.route({
-  method: "GET",
-  path: "/openapi.json",
-  operationId: "getOpenAPI",
-  tags: ["Docs"],
-  responses: { 200: { description: "OpenAPI 3.1 document" } },
-  handler: async () => ({
-    status: 200 as const,
-    body: generateOpenAPI(app, {
-      info: { title: "My Daloy Edge API", version: "0.0.1" },
-    }),
-  }),
-});
-
-app.route({
-  method: "GET",
-  path: "/docs",
-  operationId: "docs",
-  tags: ["Docs"],
-  responses: { 200: { description: "API reference UI" } },
-  handler: async () => {
-    const html = swaggerUiHtml({ specUrl: "/openapi.json", title: "My Daloy Edge API" });
-    const res = htmlResponse(html);
-    return {
-      status: 200 as const,
-      body: html,
-      headers: Object.fromEntries(res.headers),
-    };
-  },
-});
-// daloy-minimal:strip-end docs
-
 export default toWebHandler(app);

package/templates/vercel-edge/package.json

@@ -10,7 +10,7 @@
     "test": "node --import tsx/esm --test tests/**/*.test.ts"
   },
   "dependencies": {
-    "@daloyjs/core": "^0.12.0",
+    "@daloyjs/core": "^0.13.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {