create-heximon 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WP Online Magyarország Kft.
+
+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,72 @@
+# ⏣ Create Heximon
+
+Scaffold a new Heximon app with nothing installed yet. `npm create heximon` (and its `pnpm`, `yarn`, and
+`bun` equivalents) runs the same scaffolder as `heximon create`, so every option works the same way.
+
+## Why you want it
+
+- **Nothing to install first.** Your package manager's `create` command downloads and runs this package
+  once, then discards it.
+- **The same scaffolder, one command shorter.** This package forwards to `heximon create` verbatim, so
+  the prompts and the flags never drift apart.
+- **Every prompt has a flag.** Run it non-interactively in a script with `--template`, `--validator`, and
+  `--yes`.
+
+## Install
+
+There is nothing to install. Run one command for your package manager.
+
+```sh
+npm create heximon@latest my-app
+pnpm create heximon my-app
+yarn create heximon my-app
+bun create heximon my-app
+```
+
+## Registry access
+
+The `@heximon/*` packages live on GitHub Packages. Before the first install, add two lines to your
+user-level `~/.npmrc`. The token is a GitHub personal access token with the `read:packages` scope.
+
+```ini
+@heximon:registry=https://npm.pkg.github.com
+//npm.pkg.github.com/:_authToken=<your token>
+```
+
+The scaffolder writes the first line into the new project's `.npmrc`. It checks registry access before it
+runs the install and prints the fix if the check fails.
+
+## Your first app
+
+Add flags to skip every prompt. `--template` picks `minimal` or `database`. `--validator` picks `zod`,
+`valibot`, or `none`. `--yes` accepts every remaining default and installs dependencies.
+
+```sh
+npm create heximon@latest my-app -- --template database --validator zod --yes
+```
+
+`npm create` removes that `--` itself. `pnpm`, `yarn`, and `bun` forward it, so this package drops one
+leading `--` before it reads the flags. The same command line works on every package manager.
+
+## What is included
+
+| Feature | What it does |
+| :-- | :-- |
+| `create-heximon` binary | The one command this package ships. Package managers run it for `create heximon`. |
+| `--template` | Selects the starter: `minimal` or `database`. |
+| `--validator` | Selects the request-body validator: `zod`, `valibot`, or `none`. |
+| `--yes` | Accepts every remaining default and runs the install. |
+
+## Works with
+
+- [`heximon`](../cli) owns the real implementation. This package only forwards to its `create` command.
+
+## Learn more
+
+- [Create a new app](https://heximon.dev/docs/cli/create) — every prompt and flag, and what each starter
+  contains.
+- [The Heximon agent skill](../../../docs/skills/heximon) — the technical reference for coding agents.
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/bin.d.mts

@@ -0,0 +1 @@
+export {}

package/dist/bin.mjs

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+import { createRequire } from "node:module";
+import { createCommand } from "heximon";
+import process from "node:process";
+import { runMain } from "citty";
+//#region src/front-door.ts
+/**
+* The `npm create heximon` front door around the shared `heximon create` command.
+*
+* The command's `args` and `run` are reused verbatim — one implementation, two invocations — but its
+* `meta` is not: `heximon create`'s meta names a SUBCOMMAND, which as a program name makes `--help`
+* advertise a `create` binary that is on nobody's PATH, and its missing `version` makes citty's
+* builtin `--version` exit 1 with a usage dump.
+*/
+var CreateFrontDoor = class CreateFrontDoor {
+	/** The binary name, as it appears in `--help`'s usage line. */
+	static binaryName = "create-heximon";
+	/** The POSIX end-of-options marker some package managers forward into this bin's argv. */
+	static optionsSeparator = "--";
+	/** The command citty runs: the shared implementation under this package's own identity. */
+	static command() {
+		return {
+			...createCommand,
+			meta: {
+				name: CreateFrontDoor.binaryName,
+				version: CreateFrontDoor.version(),
+				description: "Scaffold a new Heximon app (the `npm create heximon` front door)."
+			}
+		};
+	}
+	/**
+	* The argument vector citty parses, with the FIRST bare `--` dropped.
+	*
+	* `npm create` consumes the separator itself, but `pnpm`/`yarn`/`bun` forward it verbatim — and
+	* citty has no end-of-options handling, so everything after a bare `--` lands in `_` and never
+	* matches an arg. Without this, the documented `pnpm create heximon my-app -- --template database
+	* --yes` scaffolds the DEFAULT template with the install skipped, silently. Dropping it is safe at
+	* any position: a bare `--` carries no meaning this command reads, and no valid project name is
+	* spelled that way.
+	*/
+	static rawArgs(argv) {
+		const separator = argv.indexOf(CreateFrontDoor.optionsSeparator);
+		return separator === -1 ? [...argv] : [...argv.slice(0, separator), ...argv.slice(separator + 1)];
+	}
+	/** This package's own version — the one citty's builtin `--version` prints. */
+	static version() {
+		return createRequire(import.meta.url)("../package.json").version;
+	}
+};
+//#endregion
+//#region src/bin.ts
+await runMain(CreateFrontDoor.command(), { rawArgs: [...CreateFrontDoor.rawArgs(process.argv.slice(2))] });
+//#endregion
+export {};

package/dist/index.d.mts

@@ -0,0 +1,2 @@
+import { createCommand } from "heximon";
+export { createCommand };

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { createCommand } from "heximon";
+export { createCommand };

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "create-heximon",
+  "version": "0.1.0",
+  "description": "Scaffold a new Heximon app — the `npm create heximon` front door (forwards to `heximon create`).",
+  "keywords": [
+    "cli",
+    "create",
+    "esm",
+    "heximon",
+    "scaffolding",
+    "starter",
+    "typescript"
+  ],
+  "homepage": "https://heximon.dev",
+  "bugs": {
+    "url": "https://github.com/heximon/heximon/issues"
+  },
+  "license": "MIT",
+  "author": "WP Online Magyarország Kft. (https://wpo.hu)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/heximon/heximon.git",
+    "directory": "packages/tooling/create-heximon"
+  },
+  "bin": {
+    "create-heximon": "./dist/bin.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": "./dist/index.mjs"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "citty": "^0.2.2",
+    "heximon": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.3",
+    "@typescript/native-preview": "^7.0.0-dev.20260707.2",
+    "typescript": "^6.0.3",
+    "vitest": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "scripts": {
+    "build": "vp pack",
+    "test": "vitest --run"
+  }
+}