@alxia/create 0.1.4 → 0.1.5

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,18 +1,18 @@
-import { app } from './app';
+import { app } from "./app";
 
 // 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);
-			},
-		);
-	});
+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));
+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/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",