@alxia/create 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Steve Tsala
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,101 @@
+# @alxia/create
+
+Start an [alxia](https://github.com/softistx/alxia) app in one command: an
+API with Zod, or React Router's official template served by alxia.
+
+```sh
+bun create @alxia my-app
+```
+
+`bun create @alxia` runs this package's bin, as `bun create <name>` runs
+`create-<name>` and `bun create @scope` runs `@scope/create`. It asks for
+what it is not given, writes the project, installs it and prints the next
+steps:
+
+```sh
+cd my-app
+bun dev
+```
+
+It needs Bun 1.4.2 or later, which the projects it writes run on.
+
+## Templates
+
+```sh
+bun create @alxia my-api --template api
+bun create @alxia my-site --template react-router
+```
+
+| template | what it writes |
+| --- | --- |
+| `api` | an `@alxia/core` app with Zod: `POST /todos` validates its body, behind `requireKey`, a hook made with `defineHook` that answers 401 without an API key; a `bun test` spec calling it with `app.request()` and through `@alxia/client`, typed; `bun dev` restarting on change, `typecheck`, `build`, a strict `tsconfig.json`, `.gitignore` and a README |
+| `react-router` | React Router's own template, written by its `create-react-router`, then [`@alxia/react-router`](https://www.npmjs.com/package/@alxia/react-router) added as its README says: `alxia()` in `vite.config.ts`'s plugins, `start` running `bun build/server/index.js`, a `bunfig.toml` starting React Router's CLI on Bun. No server file: the default one serves the pages; `bunx alxia-react-router reveal` writes it out to customise |
+
+The heart of the `api` project, its route and hook (the whole file, with
+its imports and schemas, is in the [guide](https://github.com/softistx/alxia/blob/develop/packages/create/docs/guide.md#the-api-template)):
+
+```ts
+// src/app.ts, in part
+const requireKey = defineHook(({ request, reply }) =>
+	request.headers.get('x-api-key') === apiKey
+		? undefined
+		: reply(401, { error: 'unauthorized' as const }),
+);
+
+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);
+	});
+```
+
+## Options
+
+| option | |
+| --- | --- |
+| `[dir]` | where to write the project: a directory that is empty or does not exist yet. Asked when not given |
+| `--template <name>`, `-t` | `api` or `react-router`. Asked when not given |
+| `--no-install` | write the files, skip `bun install` |
+| `--help`, `-h` | the usage |
+
+Given both `dir` and `--template`, it asks nothing, so it runs in a script
+or CI.
+
+## Versions
+
+- **alxia's packages** are at the versions this release of `@alxia/create`
+  was published with, as `^` ranges: `@alxia/core`, `@alxia/client`,
+  `@alxia/react-router`. `bunx @alxia/create@<version>` picks an older set.
+- **Everything else** — Zod, TypeScript, Vite, React, React Router, Tailwind
+  — is moved to the newest version on the registry when the project is
+  written, within the range alxia's packages accept: TypeScript within
+  `^6.0.3 || ^7.0.0`, Vite within `^7.0.0 || ^8.0.0`, React Router and its
+  packages within `^8.0.0`, Zod within `^4.2.0`; what no alxia package
+  constrains goes to npm's `latest`. A newer major outside alxia's range is
+  left out, and the output says so. The registry is the one
+  `BUN_CONFIG_REGISTRY` or `npm_config_registry` names, else npmjs.org;
+  when it does not answer, the template's own versions stay, with a warning.
+
+## Other package managers
+
+```sh
+bunx @alxia/create my-app --template api
+npm create @alxia my-app -- --template api
+```
+
+The bin runs on Bun (`#!/usr/bin/env bun`) whichever runner starts it, and
+the project it writes installs with `bun install`.
+
+## API
+
+| export | |
+| --- | --- |
+| `create-alxia` | the bin `bun create @alxia`, `bunx @alxia/create` and `npm create @alxia` run. The package exports no module |
+
+## Documentation
+
+- [Guide](https://github.com/softistx/alxia/blob/develop/packages/create/docs/guide.md): each template file by file, what the `react-router` template changes in React Router's, how versions are chosen, and running it in CI.
+- [Troubleshooting](https://github.com/softistx/alxia/blob/develop/packages/create/docs/troubleshooting.md): each message the command prints, and what to do about it.
+- [Roadmap](https://github.com/softistx/alxia/blob/develop/packages/create/docs/roadmap.md): what is coming, and what is not planned.

package/dist/args.d.ts

@@ -0,0 +1,19 @@
+/** The command line of `create-alxia`, read into what to create. */
+/** The command's name, which starts every line it prints to stderr. */
+export declare const NAME = "create-alxia";
+/** The templates, in the order the prompt lists them. */
+export declare const TEMPLATES: readonly ["api", "react-router"];
+export type Template = (typeof TEMPLATES)[number];
+export declare function isTemplate(value: string): value is Template;
+/** What the arguments asked for. A missing `dir` or `template` is prompted. */
+export interface Options {
+    readonly dir?: string;
+    readonly template?: Template;
+    readonly install: boolean;
+    readonly help: boolean;
+}
+/** The arguments as options, or the message that refuses them. */
+export declare function parseArgs(args: readonly string[]): Options | {
+    readonly error: string;
+};
+//# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAEpE,uEAAuE;AACvE,eAAO,MAAM,IAAI,iBAAiB,CAAC;AAEnC,yDAAyD;AACzD,eAAO,MAAM,SAAS,kCAAmC,CAAC;AAC1D,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAElD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,QAAQ,CAE3D;AAED,+EAA+E;AAC/E,MAAM,WAAW,OAAO;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACvB;AAED,kEAAkE;AAClE,wBAAgB,SAAS,CACxB,IAAI,EAAE,SAAS,MAAM,EAAE,GACrB,OAAO,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAoCtC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}