create-neutron 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tyler
+
+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,25 @@
+# create-neutron
+
+Scaffold a new Neutron project.
+
+Project scaffolding with templates for static sites, marketing pages, SaaS apps, and documentation.
+
+## Installation
+
+## Usage
+
+```bash
+npm create @neutron-build
+# or
+pnpm create @neutron-build
+# or
+bun create @neutron-build
+```
+
+## Documentation
+
+[neutron.build](https://neutron.build)
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+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":""}

package/dist/index.js

@@ -0,0 +1,201 @@
+#!/usr/bin/env node
+import * as fs from "node:fs";
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+const TEMPLATE_NAMES = ["basic", "marketing", "app", "full", "docs"];
+async function main() {
+    const options = parseArgs(process.argv.slice(2));
+    if (!options) {
+        printUsage();
+        process.exit(1);
+    }
+    if (options.targetDir === "--help" || options.targetDir === "-h") {
+        printUsage();
+        return;
+    }
+    const absoluteTargetDir = path.resolve(process.cwd(), options.targetDir);
+    const packageName = toPackageName(path.basename(absoluteTargetDir));
+    const dependencyVersions = resolveDependencyVersions(absoluteTargetDir);
+    await ensureTargetDirectory(absoluteTargetDir);
+    await copyTemplate(options.template, absoluteTargetDir, {
+        PROJECT_NAME: path.basename(absoluteTargetDir),
+        PACKAGE_NAME: packageName,
+        RUNTIME: options.runtime,
+        NEUTRON_VERSION: dependencyVersions.neutron,
+        NEUTRON_CLI_VERSION: dependencyVersions.neutronCli,
+    });
+    printSuccess(path.basename(absoluteTargetDir), options.template, options.runtime);
+}
+function parseArgs(argv) {
+    const positional = [];
+    let template = "basic";
+    let runtime = "preact";
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (!arg) {
+            continue;
+        }
+        if (arg === "--template" && argv[i + 1]) {
+            const candidate = argv[++i];
+            if (isTemplateName(candidate)) {
+                template = candidate;
+            }
+            else {
+                console.error(`Unsupported template: ${candidate}`);
+                return null;
+            }
+            continue;
+        }
+        if (arg.startsWith("--template=")) {
+            const candidate = arg.split("=")[1];
+            if (isTemplateName(candidate)) {
+                template = candidate;
+            }
+            else {
+                console.error(`Unsupported template: ${candidate}`);
+                return null;
+            }
+            continue;
+        }
+        if (arg === "--runtime" && argv[i + 1]) {
+            const candidate = argv[++i];
+            if (candidate === "preact" || candidate === "react-compat") {
+                runtime = candidate;
+            }
+            else {
+                console.error(`Unsupported runtime: ${candidate}`);
+                return null;
+            }
+            continue;
+        }
+        if (arg.startsWith("--runtime=")) {
+            const candidate = arg.split("=")[1];
+            if (candidate === "preact" || candidate === "react-compat") {
+                runtime = candidate;
+            }
+            else {
+                console.error(`Unsupported runtime: ${candidate}`);
+                return null;
+            }
+            continue;
+        }
+        positional.push(arg);
+    }
+    const targetDir = positional[0] || "neutron-app";
+    return { targetDir, template, runtime };
+}
+function printUsage() {
+    console.log(`Usage:
+  create-neutron [project-name] [options]
+
+Options:
+  --template <name>     Template to use (default: basic)
+                        ${TEMPLATE_NAMES.join(" | ")}
+  --runtime <mode>      Runtime mode: preact | react-compat (default: preact)
+  -h, --help            Show this help message`);
+}
+function printSuccess(projectName, template, runtime) {
+    console.log(`\nCreated ${projectName} (template: ${template}, runtime: ${runtime})\n`);
+    console.log("Next steps:");
+    console.log(`  cd ${projectName}`);
+    console.log("  pnpm install");
+    console.log("  pnpm dev\n");
+}
+async function ensureTargetDirectory(targetDir) {
+    if (!fs.existsSync(targetDir)) {
+        await fsp.mkdir(targetDir, { recursive: true });
+        return;
+    }
+    const files = await fsp.readdir(targetDir);
+    if (files.length > 0) {
+        throw new Error(`Target directory is not empty: ${targetDir}`);
+    }
+}
+async function copyTemplate(template, targetDir, tokens) {
+    const templateRoot = getTemplateRoot();
+    const sourceDir = path.join(templateRoot, template);
+    if (!fs.existsSync(sourceDir)) {
+        throw new Error(`Template not found: ${template}`);
+    }
+    await copyDirectory(sourceDir, targetDir, tokens);
+}
+async function copyDirectory(sourceDir, targetDir, tokens) {
+    await fsp.mkdir(targetDir, { recursive: true });
+    const entries = await fsp.readdir(sourceDir, { withFileTypes: true });
+    for (const entry of entries) {
+        const sourcePath = path.join(sourceDir, entry.name);
+        const outputName = resolveOutputName(entry.name);
+        const outputPath = path.join(targetDir, outputName);
+        if (entry.isDirectory()) {
+            await copyDirectory(sourcePath, outputPath, tokens);
+            continue;
+        }
+        const source = await fsp.readFile(sourcePath, "utf-8");
+        const rendered = applyTokens(source, tokens);
+        await fsp.writeFile(outputPath, rendered, "utf-8");
+    }
+}
+function resolveOutputName(inputName) {
+    if (inputName === "_gitignore") {
+        return ".gitignore";
+    }
+    return inputName;
+}
+function applyTokens(source, tokens) {
+    let output = source;
+    for (const [key, value] of Object.entries(tokens)) {
+        output = output.replaceAll(`__${key}__`, value);
+    }
+    return output;
+}
+function toPackageName(input) {
+    const normalized = input
+        .toLowerCase()
+        .replace(/[^a-z0-9-]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return normalized || "neutron-app";
+}
+function isTemplateName(value) {
+    return TEMPLATE_NAMES.includes(value);
+}
+function resolveDependencyVersions(targetDir) {
+    const workspaceRoot = findWorkspaceRoot(path.dirname(targetDir));
+    if (!workspaceRoot) {
+        return {
+            neutron: "latest",
+            neutronCli: "latest",
+        };
+    }
+    return {
+        neutron: "workspace:*",
+        neutronCli: "workspace:*",
+    };
+}
+function findWorkspaceRoot(startDir) {
+    let current = path.resolve(startDir);
+    while (true) {
+        const hasWorkspaceConfig = fs.existsSync(path.join(current, "pnpm-workspace.yaml"));
+        const hasNeutronPackage = fs.existsSync(path.join(current, "packages", "neutron"));
+        const hasNeutronCliPackage = fs.existsSync(path.join(current, "packages", "neutron-cli"));
+        if (hasWorkspaceConfig && hasNeutronPackage && hasNeutronCliPackage) {
+            return current;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return null;
+        }
+        current = parent;
+    }
+}
+function getTemplateRoot() {
+    const currentFile = fileURLToPath(import.meta.url);
+    const currentDir = path.dirname(currentFile);
+    return path.resolve(currentDir, "..", "templates");
+}
+main().catch((error) => {
+    console.error("\nFailed to create Neutron app.");
+    console.error(error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

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/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "create-neutron",
+  "version": "0.1.0",
+  "description": "Scaffold a new Neutron project. Run with: npm create neutron@latest",
+  "author": "Tyler",
+  "license": "MIT",
+  "homepage": "https://neutron.build",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/neutron-build/neutron",
+    "directory": "typescript/packages/create-neutron"
+  },
+  "keywords": [
+    "neutron",
+    "create",
+    "scaffold",
+    "starter",
+    "template"
+  ],
+  "type": "module",
+  "bin": {
+    "create-neutron": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.*",
+    "templates"
+  ],
+  "devDependencies": {
+    "@types/node": "^22.10.7",
+    "typescript": "^5.7.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "tsc --noEmit --pretty false",
+    "test": "pnpm run build && node --test --experimental-test-isolation=none dist/index.test.js"
+  }
+}

package/templates/app/_gitignore

@@ -0,0 +1,3 @@
+node_modules
+dist
+.neutron

package/templates/app/index.html

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>__PROJECT_NAME__</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+  </html>

package/templates/app/neutron.config.ts

@@ -0,0 +1,5 @@
+import { defineConfig } from "@neutron-build/core";
+
+export default defineConfig({
+  runtime: "__RUNTIME__",
+});

package/templates/app/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "__PACKAGE_NAME__",
+  "private": true,
+  "version": "0.0.1",
+  "type": "module",
+  "scripts": {
+    "dev": "neutron dev",
+    "build": "neutron build",
+    "build:vercel": "neutron build --preset vercel",
+    "start": "neutron start",
+    "preview": "neutron preview",
+    "release:check": "neutron release-check --preset vercel"
+  },
+  "dependencies": {
+    "@neutron-build/core": "__NEUTRON_VERSION__",
+    "@neutron-build/cli": "__NEUTRON_CLI_VERSION__",
+    "preact": "^10.25.4"
+  },
+  "devDependencies": {
+    "@preact/preset-vite": "^2.9.4",
+    "typescript": "^5.7.2",
+    "vite": "^6.0.7"
+  }
+}

package/templates/app/src/main.tsx

@@ -0,0 +1,5 @@
+import { init, registerRoutes } from "@neutron-build/core/client";
+import { routes } from "virtual:neutron/routes";
+
+registerRoutes(routes);
+void init();

package/templates/app/src/routes/_layout.tsx

@@ -0,0 +1,18 @@
+export default function Layout(props: { children?: unknown }) {
+  return (
+    <div style="max-width: 900px; margin: 0 auto; padding: 2rem; font-family: system-ui, sans-serif;">
+      <header style="margin-bottom: 1.5rem;">
+        <h1 style="margin: 0;">__PROJECT_NAME__</h1>
+        <p style="color: #666;">Neutron SaaS template</p>
+      </header>
+      <nav style="display: flex; gap: 0.75rem; margin-bottom: 1.5rem;">
+        <a href="/">Home</a>
+        <a href="/app/dashboard">Dashboard</a>
+        <a href="/app/settings">Settings</a>
+        <a href="/login">Login</a>
+        <a href="/protected?token=demo">Protected</a>
+      </nav>
+      <main>{props.children}</main>
+    </div>
+  );
+}

package/templates/app/src/routes/api/session/refresh.tsx

@@ -0,0 +1,28 @@
+import type { ActionArgs } from "@neutron-build/core";
+
+export const config = { mode: "app" };
+
+export async function action({ request }: ActionArgs) {
+  const auth = request.headers.get("authorization") || "";
+  const token = auth.replace(/^Bearer\s+/i, "");
+
+  if (token !== "demo") {
+    return Response.json(
+      { refreshed: false, error: "unauthorized" },
+      { status: 401, headers: { "Cache-Control": "no-store" } }
+    );
+  }
+
+  return Response.json(
+    {
+      refreshed: true,
+      refreshedAt: new Date().toISOString(),
+      ttlSec: 3600,
+    },
+    { headers: { "Cache-Control": "no-store" } }
+  );
+}
+
+export default function SessionRefreshRoute() {
+  return null;
+}

package/templates/app/src/routes/app/dashboard.tsx

@@ -0,0 +1,39 @@
+import type { LoaderArgs } from "@neutron-build/core";
+
+export const config = { mode: "app", cache: { maxAge: 30, loaderMaxAge: 10 } };
+
+export async function loader({ request }: LoaderArgs) {
+  const url = new URL(request.url);
+  const workspace = url.searchParams.get("workspace") || "main";
+
+  return {
+    workspace,
+    stats: {
+      users: 12,
+      projects: 4,
+      uptime: "99.99%",
+    },
+    loadedAt: new Date().toISOString(),
+  };
+}
+
+export default function Dashboard(props: {
+  data?: {
+    workspace: string;
+    stats: { users: number; projects: number; uptime: string };
+    loadedAt: string;
+  };
+}) {
+  return (
+    <section>
+      <h2>Dashboard</h2>
+      <p>Workspace: <strong>{props.data?.workspace}</strong></p>
+      <ul>
+        <li>Users: {props.data?.stats.users}</li>
+        <li>Projects: {props.data?.stats.projects}</li>
+        <li>Uptime: {props.data?.stats.uptime}</li>
+      </ul>
+      <p>Loaded at {props.data?.loadedAt}</p>
+    </section>
+  );
+}

package/templates/app/src/routes/app/settings.tsx

@@ -0,0 +1,68 @@
+import { Form } from "@neutron-build/core/client";
+import type { ActionArgs } from "@neutron-build/core";
+
+export const config = { mode: "app" };
+
+export async function loader() {
+  return {
+    currentName: "Acme Inc",
+    currentTheme: "system",
+  };
+}
+
+export async function action({ request }: ActionArgs) {
+  const formData = await request.formData();
+  const name = String(formData.get("name") || "").trim();
+  const theme = String(formData.get("theme") || "system").trim();
+
+  return Response.json({
+    ok: true,
+    saved: {
+      name: name || "Unnamed Workspace",
+      theme,
+    },
+    updatedAt: new Date().toISOString(),
+  });
+}
+
+export default function Settings(props: {
+  data?: { currentName: string; currentTheme: string };
+  actionData?: {
+    ok: boolean;
+    saved: { name: string; theme: string };
+    updatedAt: string;
+  };
+}) {
+  return (
+    <section>
+      <h2>Settings</h2>
+      <Form method="post" style={{ display: "grid", gap: "0.75rem", maxWidth: "420px" }}>
+        <label>
+          Workspace Name
+          <input
+            type="text"
+            name="name"
+            defaultValue={props.data?.currentName}
+            style={{ width: "100%" }}
+          />
+        </label>
+        <label>
+          Theme
+          <select name="theme" defaultValue={props.data?.currentTheme}>
+            <option value="system">System</option>
+            <option value="light">Light</option>
+            <option value="dark">Dark</option>
+          </select>
+        </label>
+        <button type="submit">Save</button>
+      </Form>
+
+      {props.actionData?.ok ? (
+        <p style={{ marginTop: "1rem" }}>
+          Saved <strong>{props.actionData.saved.name}</strong> ({props.actionData.saved.theme}) at{" "}
+          {props.actionData.updatedAt}
+        </p>
+      ) : null}
+    </section>
+  );
+}

package/templates/app/src/routes/index.tsx

@@ -0,0 +1,26 @@
+export const config = { mode: "static" };
+
+export async function loader() {
+  return {
+    title: "__PROJECT_NAME__",
+    generatedAt: new Date().toISOString().slice(0, 19).replace("T", " "),
+  };
+}
+
+export default function Home(props: { data?: { title: string; generatedAt: string } }) {
+  return (
+    <section>
+      <h2>{props.data?.title}</h2>
+      <p>
+        SaaS-oriented starter with app routes, loaders, actions, and auth-ready patterns.
+      </p>
+      <ul>
+        <li><a href="/app/dashboard">Dashboard</a></li>
+        <li><a href="/app/settings">Settings (action + Form)</a></li>
+        <li><a href="/login">Login</a></li>
+        <li><a href="/protected?token=demo">Protected route demo</a></li>
+      </ul>
+      <p>Generated at <strong>{props.data?.generatedAt}</strong>.</p>
+    </section>
+  );
+}

package/templates/app/src/routes/login.tsx

@@ -0,0 +1,14 @@
+export const config = { mode: "app" };
+
+export default function Login() {
+  return (
+    <section>
+      <h2>Login</h2>
+      <p>This template keeps auth logic explicit in routes/middleware.</p>
+      <p>Demo token for local checks: <code>demo</code></p>
+      <p>
+        Try <a href="/protected?token=demo">/protected?token=demo</a>.
+      </p>
+    </section>
+  );
+}

package/templates/app/src/routes/protected.tsx

@@ -0,0 +1,53 @@
+import type { LoaderArgs } from "@neutron-build/core";
+
+export const config = { mode: "app", cache: { maxAge: 10 } };
+
+export async function loader({ request }: LoaderArgs) {
+  const url = new URL(request.url);
+  const tokenFromHeader = request.headers.get("authorization")?.replace(/^Bearer\s+/i, "");
+  const tokenFromQuery = url.searchParams.get("token");
+  const token = tokenFromHeader || tokenFromQuery;
+
+  if (token !== "demo") {
+    return {
+      authorized: false,
+      reason: "Missing or invalid token. Provide ?token=demo for local testing.",
+    };
+  }
+
+  return {
+    authorized: true,
+    account: {
+      id: "acct_demo",
+      plan: "pro",
+    },
+    loadedAt: new Date().toISOString(),
+  };
+}
+
+export default function Protected(props: {
+  data?: {
+    authorized: boolean;
+    reason?: string;
+    account?: { id: string; plan: string };
+    loadedAt?: string;
+  };
+}) {
+  if (!props.data?.authorized) {
+    return (
+      <section>
+        <h2>Protected</h2>
+        <p>{props.data?.reason}</p>
+      </section>
+    );
+  }
+
+  return (
+    <section>
+      <h2>Protected</h2>
+      <p>Account: {props.data?.account?.id}</p>
+      <p>Plan: {props.data?.account?.plan}</p>
+      <p>Loaded at {props.data?.loadedAt}</p>
+    </section>
+  );
+}

package/templates/app/src/routes/users/[id].tsx

@@ -0,0 +1,26 @@
+import type { LoaderArgs } from "@neutron-build/core";
+
+export const config = { mode: "app", cache: { maxAge: 30 } };
+
+export async function loader({ params }: LoaderArgs) {
+  const id = params.id || "1";
+  return {
+    user: {
+      id,
+      name: `User ${id}`,
+      email: `user${id}@example.com`,
+    },
+  };
+}
+
+export default function UserRoute(props: {
+  data?: { user: { id: string; name: string; email: string } };
+}) {
+  return (
+    <section>
+      <h2>{props.data?.user.name}</h2>
+      <p>ID: {props.data?.user.id}</p>
+      <p>Email: {props.data?.user.email}</p>
+    </section>
+  );
+}

package/templates/app/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022", "DOM"],
+    "jsx": "react-jsx",
+    "jsxImportSource": "preact",
+    "strict": true,
+    "skipLibCheck": true,
+    "types": ["vite/client"]
+  },
+  "include": ["src"]
+}