create-tanejs 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eray
+
+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,44 @@
+# create-tanejs
+
+Scaffold a [tane](https://www.npmjs.com/package/tane) app — a file-system
+router with nested layouts, loaders, metadata and SSR for
+[Octane](https://octanejs.dev).
+
+```bash
+npm create tanejs my-app
+cd my-app
+npm install
+npm run dev
+```
+
+## What you get
+
+```
+app/
+  layout.tsrx      root layout, exports metadata
+  page.tsrx        /
+  about/page.tsrx  /about
+  not-found.tsrx   404
+  global.css       Tailwind entry, picked up automatically
+tane.config.ts     optional
+tsconfig.json
+package.json
+```
+
+Ten files, Tailwind wired up, routes in Octane's `.tsrx` syntax. No
+`vite.config.ts`, no `index.html`, no server file — `tane dev`, `tane build` and
+`tane start` handle those.
+
+## Flags
+
+```
+npm create tanejs <directory>
+
+    --name <name>   package name (default: the directory name)
+-f, --force         write into a directory that is not empty
+-h, --help          show this message
+```
+
+## License
+
+MIT

package/bin/create-tanejs.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { run } from "../dist/index.js";
+
+run(process.argv.slice(2));

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import { type TemplateOptions } from "./template.js";
+export { templateFiles, type TemplateOptions } from "./template.js";
+export declare class CreateError extends Error {
+    readonly name = "CreateError";
+}
+export interface CreateArgs {
+    readonly directory: string;
+    readonly name?: string;
+    readonly force: boolean;
+    readonly help: boolean;
+}
+/** npm package names are lowercase and a short list of punctuation. */
+export declare function toPackageName(directory: string): string;
+export declare function parseArgs(argv: readonly string[]): CreateArgs;
+/** A directory that does not exist, or exists with nothing but dotfiles in it. */
+export declare function isWritableTarget(directory: string): boolean;
+export interface ScaffoldOptions extends TemplateOptions {
+    readonly directory: string;
+    readonly force?: boolean;
+}
+export declare function scaffold(options: ScaffoldOptions): string[];
+export declare const HELP = "create-tanejs \u2014 scaffold a tane app\n\nUsage\n  npm create tanejs <directory>\n\nFlags\n      --name <name>   Package name        (default: the directory name)\n  -f, --force         Write into a directory that is not empty\n  -h, --help          Show this message\n";
+export declare function run(argv: readonly string[]): void;

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAEpE,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAkB,IAAI,iBAAiB;CACxC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAID,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAsC7D;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAG3D;AAED,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,EAAE,CAa3D;AAED,eAAO,MAAM,IAAI,gRAShB,CAAC;AAEF,wBAAgB,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAuCjD"}

package/dist/index.js

@@ -0,0 +1,121 @@
+import { existsSync, mkdirSync, readdirSync, writeFileSync } from "node:fs";
+import { basename, dirname, join, resolve } from "node:path";
+import { templateFiles } from "./template.js";
+export { templateFiles } from "./template.js";
+export class CreateError extends Error {
+    name = "CreateError";
+}
+const NAME_PATTERN = /^(?:@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/;
+/** npm package names are lowercase and a short list of punctuation. */
+export function toPackageName(directory) {
+    const base = basename(resolve(directory))
+        .toLowerCase()
+        .replace(/[^a-z0-9-._~]+/g, "-")
+        .replace(/^[-._]+|[-._]+$/g, "");
+    return base === "" ? "tane-app" : base;
+}
+export function parseArgs(argv) {
+    let directory;
+    let name;
+    let force = false;
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (arg === "--help" || arg === "-h") {
+            return { directory: ".", force, help: true };
+        }
+        if (arg === "--force" || arg === "-f") {
+            force = true;
+            continue;
+        }
+        if (arg === "--name") {
+            index += 1;
+            name = argv[index];
+            if (name === undefined)
+                throw new CreateError("--name needs a package name.");
+            continue;
+        }
+        if (arg.startsWith("--name=")) {
+            name = arg.slice("--name=".length);
+            continue;
+        }
+        if (arg.startsWith("-")) {
+            throw new CreateError(`Unknown flag "${arg}". Run \`create-tanejs --help\`.`);
+        }
+        if (directory !== undefined)
+            throw new CreateError(`Unexpected argument "${arg}".`);
+        directory = arg;
+    }
+    if (directory === undefined) {
+        throw new CreateError("Which directory? Try `npm create tanejs my-app`.");
+    }
+    if (name !== undefined && !NAME_PATTERN.test(name)) {
+        throw new CreateError(`"${name}" is not a valid npm package name.`);
+    }
+    return { directory, force, help: false, ...(name === undefined ? {} : { name }) };
+}
+/** A directory that does not exist, or exists with nothing but dotfiles in it. */
+export function isWritableTarget(directory) {
+    if (!existsSync(directory))
+        return true;
+    return readdirSync(directory).filter((entry) => !entry.startsWith(".")).length === 0;
+}
+export function scaffold(options) {
+    const target = resolve(options.directory);
+    if (options.force !== true && !isWritableTarget(target)) {
+        throw new CreateError(`"${target}" is not empty. Pass --force to write into it anyway.`);
+    }
+    const files = templateFiles(options);
+    for (const [relative, contents] of Object.entries(files)) {
+        const absolute = join(target, relative);
+        mkdirSync(dirname(absolute), { recursive: true });
+        writeFileSync(absolute, contents, "utf8");
+    }
+    return Object.keys(files).sort();
+}
+export const HELP = `create-tanejs — scaffold a tane app
+
+Usage
+  npm create tanejs <directory>
+
+Flags
+      --name <name>   Package name        (default: the directory name)
+  -f, --force         Write into a directory that is not empty
+  -h, --help          Show this message
+`;
+export function run(argv) {
+    let args;
+    try {
+        args = parseArgs(argv);
+    }
+    catch (error) {
+        process.stderr.write(`\n  ${error.message}\n\n`);
+        process.exitCode = 1;
+        return;
+    }
+    if (args.help) {
+        process.stdout.write(HELP);
+        return;
+    }
+    try {
+        scaffold({
+            directory: args.directory,
+            name: args.name ?? toPackageName(args.directory),
+            force: args.force,
+        });
+    }
+    catch (error) {
+        process.stderr.write(`\n  ${error.message}\n\n`);
+        process.exitCode = 1;
+        return;
+    }
+    process.stdout.write([
+        "",
+        `  Created ${resolve(args.directory)}`,
+        "",
+        `  cd ${args.directory}`,
+        "  npm install",
+        "  npm run dev",
+        "",
+        "",
+    ].join("\n"));
+}

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/template.d.ts

@@ -0,0 +1,12 @@
+export interface TemplateOptions {
+    /** The npm package name for the scaffolded app. */
+    readonly name: string;
+    /** Version range written for the `tanejs` dependency. */
+    readonly taneVersion?: string;
+    readonly octaneVersion?: string;
+}
+/**
+ * The files a new app is made of, as a path → contents map. Kept separate from
+ * disk writing so the shape of a scaffolded project can be asserted directly.
+ */
+export declare function templateFiles(options: TemplateOptions): Record<string, string>;

package/dist/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAmID;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAa9E"}

package/dist/template.js

@@ -0,0 +1,151 @@
+const DEFAULT_TANE = "^0.1.0";
+const DEFAULT_OCTANE = "^0.1.17";
+function packageJson(options) {
+    return `${JSON.stringify({
+        name: options.name,
+        private: true,
+        type: "module",
+        scripts: {
+            dev: "tane dev",
+            build: "tane build",
+            start: "tane start",
+        },
+        dependencies: {
+            octane: options.octaneVersion ?? DEFAULT_OCTANE,
+            tanejs: options.taneVersion ?? DEFAULT_TANE,
+        },
+        devDependencies: {
+            "@tailwindcss/vite": "^4.3.3",
+            tailwindcss: "^4.3.3",
+            typescript: "^5.7.0",
+        },
+    }, null, 2)}\n`;
+}
+const TSCONFIG = `${JSON.stringify({
+    compilerOptions: {
+        target: "ES2023",
+        lib: ["ES2023", "DOM", "DOM.Iterable"],
+        module: "ESNext",
+        moduleResolution: "bundler",
+        strict: true,
+        noEmit: true,
+        jsx: "react-jsx",
+        jsxImportSource: "octane",
+        verbatimModuleSyntax: true,
+        isolatedModules: true,
+        resolveJsonModule: true,
+        skipLibCheck: true,
+        types: ["vite/client", "tanejs/virtual-routes"],
+    },
+    // `.tane/types.d.ts` is written by the dev server and by `tane build`; it
+    // is what makes <Link href> check against the real route list.
+    include: ["app", "tane.config.ts", ".tane/types.d.ts"],
+}, null, 2)}\n`;
+// Routes are .tsrx — Octane's own syntax. A component body is `@{ … }` and
+// renders a single node, so several elements need a <>…</> around them.
+const LAYOUT = `import { Link, type Metadata } from "tanejs";
+import type { OctaneNode } from "octane";
+
+export const metadata: Metadata = {
+  title: "APP_NAME",
+  description: "Built with tane.",
+};
+
+export default function RootLayout(props: { children: OctaneNode }) @{
+  <div class="mx-auto max-w-2xl space-y-6 p-8 text-slate-900">
+    <nav class="flex gap-4 border-b border-slate-200 pb-4 text-sm">
+      <Link href="/" class="text-slate-600 hover:text-slate-900 hover:underline">
+        Home
+      </Link>
+      <Link href="/about" class="text-slate-600 hover:text-slate-900 hover:underline">
+        About
+      </Link>
+    </nav>
+    <main class="space-y-4">{props.children}</main>
+  </div>
+}
+`;
+const PAGE = `export default function HomePage() @{
+  <>
+    <h1 class="text-3xl font-semibold tracking-tight">APP_NAME</h1>
+    <p class="text-slate-600">Edit app/page.tsrx and save — the change is live.</p>
+  </>
+}
+`;
+const ABOUT_PAGE = `import type { Metadata } from "tanejs";
+
+export const metadata: Metadata = { title: "About — APP_NAME" };
+
+export default function AboutPage() @{
+  <h1 class="text-2xl font-semibold tracking-tight">About</h1>
+}
+`;
+const NOT_FOUND = `export default function NotFound() @{
+  <h1 class="text-2xl font-semibold tracking-tight">Page not found</h1>
+}
+`;
+const CONFIG = `import { defineConfig } from "tanejs/vite";
+import tailwindcss from "@tailwindcss/vite";
+
+// appDir, basePath, alias, outDir and server all have defaults — the \`vite\`
+// field is the escape hatch for anything Vite-specific.
+export default defineConfig({
+  vite: { plugins: [tailwindcss()] },
+});
+`;
+// Picked up automatically as `virtual:tane-global-css`; no import needed.
+const GLOBAL_CSS = `@import "tailwindcss";
+`;
+const GITIGNORE = `node_modules
+dist
+.tane
+*.tsbuildinfo
+`;
+function readme(name) {
+    return `# ${name}
+
+\`\`\`bash
+npm install
+npm run dev
+\`\`\`
+
+- \`app/\` — routes. \`page\` makes a route public, \`layout\` wraps its children,
+  and \`loading\`, \`error\` and \`not-found\` are the segment's boundaries.
+- \`app/global.css\` — Tailwind's entry, picked up automatically.
+- \`tane.config.ts\` — optional. \`appDir\`, \`basePath\`, \`alias\`, \`outDir\`,
+  \`server\` and a \`vite\` field for anything Vite-specific.
+
+\`npm run build\` writes \`dist/client\` and \`dist/server\`; \`npm start\` serves them.
+
+## .tsrx
+
+Routes are written in Octane's \`.tsrx\`: a component body is \`@{ … }\` rather
+than \`return (…)\`, and it renders a single node — wrap siblings in \`<>…</>\`.
+Control flow is \`@for\`, \`@if\` and friends. Plain \`.tsx\` works too; the router
+takes \`.tsrx\`, \`.tsx\`, \`.jsx\`, \`.ts\` and \`.js\`.
+
+\`tsc\` does not know the \`.tsrx\` extension and skips those files, so a bare
+\`tsc --noEmit\` will pass without having checked your routes. Use Octane's Volar
+integration (\`octane/compiler/volar\`) for editor diagnostics and type-checked
+\`<Link href>\`.
+`;
+}
+/**
+ * The files a new app is made of, as a path → contents map. Kept separate from
+ * disk writing so the shape of a scaffolded project can be asserted directly.
+ */
+export function templateFiles(options) {
+    const fill = (source) => source.replaceAll("APP_NAME", options.name);
+    return {
+        "package.json": packageJson(options),
+        "tsconfig.json": TSCONFIG,
+        "tane.config.ts": CONFIG,
+        ".gitignore": GITIGNORE,
+        "README.md": readme(options.name),
+        "app/global.css": GLOBAL_CSS,
+        "app/layout.tsrx": fill(LAYOUT),
+        "app/page.tsrx": fill(PAGE),
+        "app/about/page.tsrx": fill(ABOUT_PAGE),
+        "app/not-found.tsrx": NOT_FOUND,
+    };
+}

package/dist/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAQA,MAAM,YAAY,GAAG,QAAQ,CAAC;AAC9B,MAAM,cAAc,GAAG,SAAS,CAAC;AAEjC,SAAS,WAAW,CAAC,OAAwB;IAC3C,OAAO,GAAG,IAAI,CAAC,SAAS,CACtB;QACE,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE;YACP,GAAG,EAAE,UAAU;YACf,KAAK,EAAE,YAAY;YACnB,KAAK,EAAE,YAAY;SACpB;QACD,YAAY,EAAE;YACZ,MAAM,EAAE,OAAO,CAAC,aAAa,IAAI,cAAc;YAC/C,IAAI,EAAE,OAAO,CAAC,WAAW,IAAI,YAAY;SAC1C;QACD,eAAe,EAAE;YACf,UAAU,EAAE,QAAQ;SACrB;KACF,EACD,IAAI,EACJ,CAAC,CACF,IAAI,CAAC;AACR,CAAC;AAED,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,SAAS,CAChC;IACE,eAAe,EAAE;QACf,MAAM,EAAE,QAAQ;QAChB,GAAG,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,cAAc,CAAC;QACtC,MAAM,EAAE,QAAQ;QAChB,gBAAgB,EAAE,SAAS;QAC3B,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,IAAI;QACZ,GAAG,EAAE,WAAW;QAChB,eAAe,EAAE,QAAQ;QACzB,oBAAoB,EAAE,IAAI;QAC1B,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,CAAC,aAAa,EAAE,qBAAqB,CAAC;KAC9C;IACD,0EAA0E;IAC1E,+DAA+D;IAC/D,OAAO,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,CAAC;CACvD,EACD,IAAI,EACJ,CAAC,CACF,IAAI,CAAC;AAEN,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;CAmBd,CAAC;AAEF,MAAM,IAAI,GAAG;;;;;;;;CAQZ,CAAC;AAEF,MAAM,UAAU,GAAG;;;;;;;CAOlB,CAAC;AAEF,MAAM,SAAS,GAAG;;;CAGjB,CAAC;AAEF,MAAM,MAAM,GAAG;;;;;;CAMd,CAAC;AAEF,MAAM,SAAS,GAAG;;;;CAIjB,CAAC;AAEF,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,KAAK,IAAI;;;;;;;;;;;;;;CAcjB,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAwB;IACpD,MAAM,IAAI,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrF,OAAO;QACL,cAAc,EAAE,WAAW,CAAC,OAAO,CAAC;QACpC,eAAe,EAAE,QAAQ;QACzB,gBAAgB,EAAE,MAAM;QACxB,YAAY,EAAE,SAAS;QACvB,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;QACjC,gBAAgB,EAAE,IAAI,CAAC,MAAM,CAAC;QAC9B,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC;QAC1B,oBAAoB,EAAE,IAAI,CAAC,UAAU,CAAC;QACtC,mBAAmB,EAAE,SAAS;KAC/B,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "create-tanejs",
+  "version": "0.1.0",
+  "type": "module",
+  "license": "MIT",
+  "description": "Scaffold a tane app: npm create tane my-app",
+  "author": "Eray",
+  "homepage": "https://github.com/tanejs/tane/tree/main/packages/create-app#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tanejs/tane.git",
+    "directory": "packages/create-app"
+  },
+  "bugs": {
+    "url": "https://github.com/tanejs/tane/issues"
+  },
+  "keywords": [
+    "tane",
+    "octane",
+    "octanejs",
+    "scaffold",
+    "create",
+    "starter"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "create-tanejs": "./bin/create-tanejs.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json"
+  }
+}