@alxia/create 0.1.3 → 0.1.5

package/templates/api/package.json

@@ -1,21 +1,27 @@
 {
-	"name": "my-api",
-	"private": true,
-	"type": "module",
-	"scripts": {
-		"dev": "bun --watch src/server.ts",
-		"build": "bun build src/server.ts --target=bun --outdir=dist --minify --sourcemap=linked",
-		"start": "bun dist/server.js",
-		"test": "bun test",
-		"typecheck": "tsc --noEmit"
-	},
-	"dependencies": {
-		"@alxia/core": "workspace:^",
-		"zod": "^4.2.0"
-	},
-	"devDependencies": {
-		"@alxia/client": "workspace:^",
-		"@types/bun": "^1.4.2",
-		"typescript": "^6.0.3"
-	}
+  "name": "my-api",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "bun --watch src/server.ts",
+    "build": "bun build src/server.ts --target=bun --outdir=dist --minify --sourcemap=linked",
+    "start": "bun dist/server.js",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome lint",
+    "format": "biome format --write",
+    "check": "biome check --write",
+    "check:ci": "biome ci",
+    "verify": "bun run check:ci && bun run typecheck && bun run test"
+  },
+  "dependencies": {
+    "@alxia/core": "workspace:^",
+    "zod": "^4.2.0"
+  },
+  "devDependencies": {
+    "@alxia/client": "workspace:^",
+    "@biomejs/biome": "2.5.15",
+    "@types/bun": "^1.4.2",
+    "typescript": "^6.0.3"
+  }
 }

package/templates/api/src/app.spec.ts

@@ -1,46 +1,46 @@
-import { expect, test } from 'bun:test';
-import { client } from '@alxia/client';
-import { apiKey, app } from './app';
+import { expect, test } from "bun:test";
+import { client } from "@alxia/client";
+import { apiKey, app } from "./app";
 
-const json = { 'content-type': 'application/json', 'x-api-key': apiKey };
+const json = { "content-type": "application/json", "x-api-key": apiKey };
 
-test('creates a todo from JSON', async () => {
-	const response = await app.request('/todos', {
-		method: 'POST',
-		headers: json,
-		body: JSON.stringify({ title: 'Write a route' }),
-	});
-	expect(response.status).toBe(201);
-	expect(await response.json()).toEqual({
-		id: expect.any(Number),
-		title: 'Write a route',
-		done: false,
-	});
+test("creates a todo from JSON", async () => {
+  const response = await app.request("/todos", {
+    method: "POST",
+    headers: json,
+    body: JSON.stringify({ title: "Write a route" }),
+  });
+  expect(response.status).toBe(201);
+  expect(await response.json()).toEqual({
+    id: expect.any(Number),
+    title: "Write a route",
+    done: false,
+  });
 });
 
-test('refuses an empty title with a 400 naming it', async () => {
-	const response = await app.request('/todos', {
-		method: 'POST',
-		headers: json,
-		body: JSON.stringify({ title: '' }),
-	});
-	expect(response.status).toBe(400);
-	expect((await response.json()).issues[0].path).toEqual(['title']);
+test("refuses an empty title with a 400 naming it", async () => {
+  const response = await app.request("/todos", {
+    method: "POST",
+    headers: json,
+    body: JSON.stringify({ title: "" }),
+  });
+  expect(response.status).toBe(400);
+  expect((await response.json()).issues[0].path).toEqual(["title"]);
 });
 
-test('the typed client reads each status the route answers', async () => {
-	// Given the app itself, the client calls its fetch in process.
-	const api = client(app, { headers: { 'x-api-key': apiKey } });
-	const created = await api.post('/todos', {
-		body: { title: 'Call it typed' },
-	});
-	if (created.status !== 201) throw new Error(`got ${created.status}`);
-	expect(created.data.title).toBe('Call it typed'); // data is the Todo schema's type
+test("the typed client reads each status the route answers", async () => {
+  // Given the app itself, the client calls its fetch in process.
+  const api = client(app, { headers: { "x-api-key": apiKey } });
+  const created = await api.post("/todos", {
+    body: { title: "Call it typed" },
+  });
+  if (created.status !== 201) throw new Error(`got ${created.status}`);
+  expect(created.data.title).toBe("Call it typed"); // data is the Todo schema's type
 
-	const anonymous = await client(app).post('/todos', {
-		body: { title: 'No key' },
-	});
-	expect(anonymous.status).toBe(401);
-	if (anonymous.status === 401)
-		expect(anonymous.data.error).toBe('unauthorized');
+  const anonymous = await client(app).post("/todos", {
+    body: { title: "No key" },
+  });
+  expect(anonymous.status).toBe(401);
+  if (anonymous.status === 401)
+    expect(anonymous.data.error).toBe("unauthorized");
 });

package/templates/api/src/app.ts

@@ -1,33 +1,33 @@
-import { alxia, defineHook } from '@alxia/core';
-import { z } from 'zod';
+import { alxia, defineHook } from "@alxia/core";
+import { z } from "zod";
 
 const Todo = z.object({ id: z.number(), title: z.string(), done: z.boolean() });
 const NewTodo = z.object({ title: z.string().min(1) });
 
 /** Set API_KEY in the environment: this default is for development. */
-export const apiKey = Bun.env['API_KEY'] ?? 'dev-key';
+export const apiKey = Bun.env["API_KEY"] ?? "dev-key";
 
 // A hook of the routes it is given to: it answers 401 without the key, and
 // that 401 joins the type of each, so the client reads it.
 const requireKey = defineHook(({ request, reply }) =>
-	request.headers.get('x-api-key') === apiKey
-		? undefined
-		: reply(401, { error: 'unauthorized' as const }),
+  request.headers.get("x-api-key") === apiKey
+    ? undefined
+    : reply(401, { error: "unauthorized" as const }),
 );
 
 const todos: z.infer<typeof Todo>[] = [];
 
 export const app = alxia()
-	.decorate({ todos })
-	.post(
-		'/todos',
-		[requireKey],
-		{ body: NewTodo, response: { 201: Todo } },
-		({ body, todos, reply }) => {
-			const todo = { id: todos.length + 1, title: body.title, done: false };
-			todos.push(todo);
-			return reply.created(todo);
-		},
-	);
+  .decorate({ todos })
+  .post(
+    "/todos",
+    [requireKey],
+    { body: NewTodo, response: { 201: Todo } },
+    ({ body, todos, reply }) => {
+      const todo = { id: todos.length + 1, title: body.title, done: false };
+      todos.push(todo);
+      return reply.created(todo);
+    },
+  );
 
 export type App = typeof app;

package/templates/api/src/server.ts

@@ -1,4 +1,18 @@
-import { app } from './app';
+import { app } from "./app";
 
-const server = app.listen(Number(Bun.env['PORT'] ?? 3000));
+// Stop as the platform asks. In a container Bun is process 1, which a
+// signal with no handler does not stop: `docker stop` would wait.
+for (const signal of ["SIGINT", "SIGTERM"] as const) {
+  process.once(signal, () => {
+    void app.stop().then(
+      () => process.exit(0),
+      (error: unknown) => {
+        console.error(error);
+        process.exit(1);
+      },
+    );
+  });
+}
+
+const server = app.listen(Number(Bun.env["PORT"] ?? 3000));
 console.log(`listening on ${server.url}`);

package/templates/api/tsconfig.json

@@ -1,25 +1,25 @@
 {
-	"compilerOptions": {
-		"types": ["bun"],
-		"lib": ["ESNext", "DOM"],
-		"target": "ESNext",
-		"module": "ESNext",
-		"moduleDetection": "force",
-		"moduleResolution": "bundler",
-		"verbatimModuleSyntax": true,
-		"noEmit": true,
-		"skipLibCheck": true,
-		"resolveJsonModule": true,
-		"strict": true,
-		"noImplicitOverride": true,
-		"noImplicitReturns": true,
-		"noFallthroughCasesInSwitch": true,
-		"noUncheckedIndexedAccess": true,
-		"exactOptionalPropertyTypes": true,
-		"noPropertyAccessFromIndexSignature": true,
-		"noUnusedLocals": true,
-		"noUnusedParameters": true,
-		"forceConsistentCasingInFileNames": true
-	},
-	"include": ["src"]
+  "compilerOptions": {
+    "types": ["bun"],
+    "lib": ["ESNext", "DOM"],
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleDetection": "force",
+    "moduleResolution": "bundler",
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "strict": true,
+    "noImplicitOverride": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "noPropertyAccessFromIndexSignature": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src"]
 }

package/templates/react-router/.vscode/extensions.json

@@ -0,0 +1,3 @@
+{
+  "recommendations": ["biomejs.biome"]
+}

package/templates/react-router/.vscode/settings.json

@@ -0,0 +1,8 @@
+{
+  "editor.defaultFormatter": "biomejs.biome",
+  "editor.formatOnSave": true,
+  "editor.codeActionsOnSave": {
+    "source.fixAll.biome": "explicit",
+    "source.organizeImports.biome": "explicit"
+  }
+}

package/templates/react-router/Dockerfile

@@ -16,8 +16,10 @@ RUN bun run build
 # command, and --no-install: with no node_modules, Bun would otherwise
 # fetch a package the build left out from the registry at startup,
 # where this fails.
-# The server listens on PORT (3000) and HOST (0.0.0.0).
-FROM oven/bun:1
+# The server listens on PORT (3000) and HOST (0.0.0.0). On Alpine, about
+# 200 MB lighter: build/ is JavaScript, which runs the same on musl. A
+# native addon built for glibc alone needs oven/bun:1 here.
+FROM oven/bun:1-alpine
 WORKDIR /app
 ENV NODE_ENV=production
 COPY --from=build /app/build ./build

package/templates/react-router/README.md

@@ -78,6 +78,33 @@ Make sure to deploy the output of `bun run build`
 │   └── server/    # Server-side code
 ```
 
+## Lint and format
+
+[Biome](https://biomejs.dev) lints and formats the project, as `biome.json`
+sets it: Biome's recommended rules, spaces, double quotes, imports
+sorted. What the build and `react-router typegen` write, `build/` and
+`.react-router/`, is skipped.
+
+```bash
+bun run check      # lint, format and sort imports, fixing what it can
+bun run lint       # lint only
+bun run format     # format only, in place
+bun run check:ci   # what CI runs: changes nothing, fails on an error
+bun run verify     # check:ci, then typecheck, then build
+```
+
+`bun run check:ci`, not `bun ci`: `bun ci` is Bun's frozen-lockfile
+install. In VS Code, `.vscode/` recommends Biome's extension and formats
+on save with it.
+
+`@biomejs/biome` is pinned exactly, since a release of Biome may format
+differently. To move it:
+
+```bash
+bun add --dev --exact @biomejs/biome@latest
+bunx biome migrate --write
+```
+
 ## Styling
 
 This template comes with [Tailwind CSS](https://tailwindcss.com/) already configured for a simple default starting experience. You can use whatever CSS framework you prefer.

package/templates/react-router/_biome.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "files": {
+    "includes": ["**", "!!**/build", "!!**/.react-router"]
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space"
+  },
+  "css": {
+    "parser": {
+      "tailwindDirectives": true
+    }
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "preset": "recommended",
+      "correctness": {
+        "noEmptyPattern": "off"
+      }
+    }
+  },
+  "assist": {
+    "enabled": true,
+    "actions": {
+      "source": {
+        "organizeImports": "on"
+      }
+    }
+  },
+  "overrides": [
+    {
+      "includes": ["**/app/welcome/**"],
+      "linter": {
+        "rules": {
+          "a11y": {
+            "noSvgWithoutTitle": "off"
+          }
+        }
+      }
+    }
+  ]
+}

package/templates/react-router/app/app.css

@@ -1,8 +1,9 @@
 @import "tailwindcss";
 
 @theme {
-  --font-sans: "Inter", ui-sans-serif, system-ui, sans-serif,
-    "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
+  --font-sans:
+    "Inter", ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji",
+    "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
 }
 
 html,

package/templates/react-router/app/routes/home.tsx

@@ -1,5 +1,5 @@
-import type { Route } from "./+types/home";
 import { Welcome } from "../welcome/welcome";
+import type { Route } from "./+types/home";
 
 export function meta({}: Route.MetaArgs) {
   return [

package/templates/react-router/app/routes.ts

@@ -1,3 +1,3 @@
-import { type RouteConfig, index } from "@react-router/dev/routes";
+import { index, type RouteConfig } from "@react-router/dev/routes";
 
 export default [index("routes/home.tsx")] satisfies RouteConfig;

package/templates/react-router/package.json

@@ -6,7 +6,12 @@
     "build": "react-router build",
     "dev": "react-router dev",
     "start": "bun build/server/index.js",
-    "typecheck": "react-router typegen && tsc"
+    "typecheck": "react-router typegen && tsc",
+    "lint": "biome lint",
+    "format": "biome format --write",
+    "check": "biome check --write",
+    "check:ci": "biome ci",
+    "verify": "bun run check:ci && bun run typecheck && bun run build"
   },
   "dependencies": {
     "@alxia/core": "workspace:^",
@@ -19,6 +24,7 @@
     "react-router": "^8.4.0"
   },
   "devDependencies": {
+    "@biomejs/biome": "2.5.15",
     "@react-router/dev": "^8.4.0",
     "@tailwindcss/vite": "^4.2.2",
     "@types/node": "^22",