create-lacspace-app 1.0.0

package/LICENSE

@@ -0,0 +1,51 @@
+Lacspace Free Licence
+Version 1.0, August 2026
+
+Copyright (c) 2026 Lacspace
+
+PREAMBLE
+
+This software is published by Lacspace under the Lacspace Free Licence — a free,
+permissive licence that lets you use this software for any purpose, including in
+commercial products and services, at no cost. It grants the same freedoms as
+common permissive open-source licences; the only condition is that this notice
+travels with the software. The canonical, always-current text of this licence is
+maintained at https://lacspace.com/licenses/lacspace-free-1.0
+
+GRANT OF RIGHTS
+
+Permission is hereby granted, free of charge, to any person or organisation
+obtaining a copy of this software and its associated documentation and data 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 conditions below. These rights are
+granted for any purpose, personal or commercial, and are perpetual, worldwide,
+non-exclusive, and royalty-free.
+
+CONDITIONS
+
+The above copyright notice, this permission notice, and the name of this licence
+("Lacspace Free Licence") shall be included in all copies or substantial portions
+of the Software.
+
+TRADEMARKS
+
+This licence does not grant permission to use the trade names, trademarks, service
+marks, logos, or product names of Lacspace, except as required to reproduce the
+notice above or to describe the origin of the Software in a truthful manner.
+
+DISCLAIMER OF WARRANTY AND LIMITATION OF LIABILITY
+
+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.
+
+---
+
+The Lacspace Free Licence is a source-available, permissive licence and is not (as
+of this version) an OSI-approved licence. In substance it grants the same freedoms
+as the MIT Licence. Learn more at https://lacspace.com/licenses

package/README.md

@@ -0,0 +1,67 @@
+<div align="center">
+
+# create-lacspace-app
+
+**Scaffold a beautiful, production-ready Next.js app in one command — pick a template, start gorgeous.**
+
+[![npm version](https://img.shields.io/npm/v/create-lacspace-app?color=%2316a34a&label=npm)](https://www.npmjs.com/package/create-lacspace-app)
+[![license](https://img.shields.io/npm/l/create-lacspace-app?color=green)](https://github.com/lacspace/npm-packages/blob/main/LICENSE)
+
+</div>
+
+> `create-next-app` gives you a blank page. This gives you a **finished-looking app** — a polished template, styled with Tailwind, already wired with the Lacspace libraries (SEO metadata + JSON-LD, security headers, sitemap & robots). Choose your kind of site and you're running in seconds.
+
+## Use it
+
+```bash
+npm create lacspace-app@latest my-app
+# or
+npx create-lacspace-app my-app --template business
+```
+
+It asks for a project name and a template, scaffolds the project, installs dependencies and initialises git.
+
+## Templates
+
+| Key | What you get |
+| --- | --- |
+| **personal** | A sleek personal / developer portfolio with a projects grid |
+| **business** | A professional company / agency site with services + CTA |
+| **ecommerce** | A modern storefront home with a featured product grid |
+| **saas** | A high-converting SaaS landing page with features + pricing |
+
+Every template is a real Next.js 15 App Router + Tailwind v4 project — dark, modern, responsive, with a gradient accent you can theme.
+
+## Batteries already wired
+
+- **`lib/site.ts`** — one [`@lacspace/seo`](https://www.npmjs.com/package/@lacspace/seo) `defineSite()` config drives your `<title>`, canonical, Open Graph, Twitter card and JSON-LD
+- **`next.config.mjs`** — hardened security headers via [`@lacspace/headers`](https://www.npmjs.com/package/@lacspace/headers)
+- **`app/robots.txt` + `app/sitemap.xml`** — generated from your site config with [`@lacspace/robots`](https://www.npmjs.com/package/@lacspace/robots) & [`@lacspace/sitemap`](https://www.npmjs.com/package/@lacspace/sitemap)
+
+Edit `lib/site.ts` and `app/page.tsx` and you're off.
+
+## Options
+
+| Flag | Meaning |
+| --- | --- |
+| `-t, --template <key>` | `personal` \| `business` \| `ecommerce` \| `saas` |
+| `--pm <npm\|pnpm\|yarn\|bun>` | package manager (default npm) |
+| `--no-install` | skip installing dependencies |
+| `--no-git` | skip git init |
+| `-y, --yes` | accept defaults (needs a project name) |
+
+## Licensing
+
+Free under the **[Lacspace Free Licence](https://lacspace.com/licenses/lacspace-free-1.0)** — MIT-equivalent freedoms. Use it in personal and commercial projects at no cost; just keep the notice. The apps you generate are yours. See the **[Lacspace Licence Centre](https://lacspace.com/licenses)**.
+
+---
+
+<div align="center">
+
+**Part of the Lacspace ecosystem — zero-dependency, isomorphic TypeScript packages.**
+
+[All packages ↗](https://lacspace.com/packages) · [npm org ↗](https://www.npmjs.com/org/lacspace) · [Licence Centre ↗](https://lacspace.com/licenses) · [GitHub ↗](https://github.com/lacspace/npm-packages)
+
+</div>
+
+<div align="center"><sub>Built with care by <a href="https://lacspace.com">Lacspace</a> · Lacspace Free Licence · <a href="https://github.com/lacspace/npm-packages">source</a></sub></div>

package/dist/index.js

@@ -0,0 +1,456 @@
+#!/usr/bin/env node
+import { existsSync, readdirSync, mkdirSync, writeFileSync } from 'fs';
+import { resolve, basename, join, dirname } from 'path';
+import { createInterface } from 'readline/promises';
+import { stdout, exit, argv, stdin, cwd } from 'process';
+import { spawnSync } from 'child_process';
+
+var C = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  dim: "\x1B[2m",
+  green: "\x1B[32m",
+  cyan: "\x1B[36m",
+  yellow: "\x1B[33m",
+  red: "\x1B[31m",
+  magenta: "\x1B[35m"
+};
+var c = (k, s) => `${C[k]}${s}${C.reset}`;
+var TEMPLATES = [
+  { key: "personal", label: "Personal portfolio", description: "A sleek personal / developer portfolio with projects and contact.", accent: ["#6366f1", "#a855f7"], siteName: "Your Name", siteDescription: "Developer, designer & maker. Selected work and writing." },
+  { key: "business", label: "Business site", description: "A professional company / agency site with services and a CTA.", accent: ["#2563eb", "#06b6d4"], siteName: "Acme Studio", siteDescription: "We design and build digital products that grow businesses." },
+  { key: "ecommerce", label: "E-commerce storefront", description: "A modern product storefront home with a featured grid.", accent: ["#0d9488", "#84cc16"], siteName: "Acme Store", siteDescription: "Beautiful things, thoughtfully made. Free shipping worldwide." },
+  { key: "saas", label: "SaaS landing", description: "A high-converting SaaS landing page with features and pricing.", accent: ["#7c3aed", "#ec4899"], siteName: "Acme Cloud", siteDescription: "The all-in-one platform your team will love. Ship faster." }
+];
+var pkgJson = (ctx) => JSON.stringify({
+  name: ctx.name,
+  version: "0.1.0",
+  private: true,
+  scripts: { dev: "next dev", build: "next build", start: "next start", lint: "next lint" },
+  dependencies: {
+    next: "^15.1.0",
+    react: "^19.0.0",
+    "react-dom": "^19.0.0",
+    "@lacspace/seo": "^1.5.0",
+    "@lacspace/headers": "^1.1.1",
+    "@lacspace/robots": "^1.2.0",
+    "@lacspace/sitemap": "^1.1.0"
+  },
+  devDependencies: {
+    typescript: "^5.7.0",
+    "@types/node": "^22.10.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    tailwindcss: "^4.0.0",
+    "@tailwindcss/postcss": "^4.0.0",
+    postcss: "^8.4.49"
+  }
+}, null, 2) + "\n";
+var tsconfig = () => JSON.stringify({
+  compilerOptions: {
+    target: "ES2022",
+    lib: ["dom", "dom.iterable", "esnext"],
+    allowJs: true,
+    skipLibCheck: true,
+    strict: true,
+    noEmit: true,
+    esModuleInterop: true,
+    module: "esnext",
+    moduleResolution: "bundler",
+    resolveJsonModule: true,
+    isolatedModules: true,
+    jsx: "preserve",
+    incremental: true,
+    plugins: [{ name: "next" }],
+    paths: { "@/*": ["./*"] }
+  },
+  include: ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  exclude: ["node_modules"]
+}, null, 2) + "\n";
+var nextConfig = () => `import { toNextHeaders } from "@lacspace/headers";
+
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  async headers() {
+    // Hardened security headers (HSTS, CSP, X-Frame-Options, \u2026) from @lacspace/headers
+    return toNextHeaders();
+  },
+};
+
+export default nextConfig;
+`;
+var postcss = () => `export default {
+  plugins: { "@tailwindcss/postcss": {} },
+};
+`;
+var gitignore = () => `node_modules
+.next
+out
+.env*
+!.env.example
+*.log
+.DS_Store
+`;
+var globalsCss = (ctx) => `@import "tailwindcss";
+
+:root {
+  --accent-from: ${ctx.template.accent[0]};
+  --accent-to: ${ctx.template.accent[1]};
+}
+
+html { scroll-behavior: smooth; }
+body { background: #0a0a0f; color: #e5e7eb; -webkit-font-smoothing: antialiased; }
+
+.gradient-text {
+  background: linear-gradient(120deg, var(--accent-from), var(--accent-to));
+  -webkit-background-clip: text; background-clip: text; color: transparent;
+}
+.gradient-bg { background: linear-gradient(120deg, var(--accent-from), var(--accent-to)); }
+`;
+var siteTs = (ctx) => `import { defineSite } from "@lacspace/seo";
+
+/** Your site's SEO configuration \u2014 set once, used everywhere. */
+export const site = defineSite({
+  name: ${JSON.stringify(ctx.template.siteName)},
+  url: "https://example.com",
+  description: ${JSON.stringify(ctx.template.siteDescription)},
+  // twitter: "yourhandle",
+  // ogImage: "/og",
+});
+`;
+var layout = (ctx) => `import type { Metadata } from "next";
+import { site } from "@/lib/site";
+import "./globals.css";
+
+export const metadata: Metadata = site.meta({ title: ${JSON.stringify(ctx.template.siteName)} });
+
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en">
+      <body>
+        {children}
+        <script
+          type="application/ld+json"
+          dangerouslySetInnerHTML={{ __html: JSON.stringify(site.rootJsonLd()) }}
+        />
+      </body>
+    </html>
+  );
+}
+`;
+var robotsTs = () => `import { robotsForSite } from "@lacspace/robots";
+import { site } from "@/lib/site";
+
+export function GET() {
+  return new Response(robotsForSite(site.config), { headers: { "content-type": "text/plain" } });
+}
+`;
+var sitemapTs = () => `import { sitemapForSite } from "@lacspace/sitemap";
+import { site } from "@/lib/site";
+
+export function GET() {
+  const xml = sitemapForSite(site.config, ["/", "/about", "/contact"]);
+  return new Response(xml, { headers: { "content-type": "application/xml" } });
+}
+`;
+var readme = (ctx) => `# ${ctx.name}
+
+A Next.js app scaffolded with [create-lacspace-app](https://www.npmjs.com/package/create-lacspace-app) \u2014 template: **${ctx.template.label}**.
+
+Pre-wired with the Lacspace libraries:
+- [\`@lacspace/seo\`](https://www.npmjs.com/package/@lacspace/seo) \u2014 metadata + JSON-LD via \`lib/site.ts\` (edit it once, it flows everywhere)
+- [\`@lacspace/headers\`](https://www.npmjs.com/package/@lacspace/headers) \u2014 security headers in \`next.config.mjs\`
+- [\`@lacspace/robots\`](https://www.npmjs.com/package/@lacspace/robots) + [\`@lacspace/sitemap\`](https://www.npmjs.com/package/@lacspace/sitemap) \u2014 \`app/robots.txt\` & \`app/sitemap.xml\`
+
+## Getting started
+
+\`\`\`bash
+npm install
+npm run dev
+\`\`\`
+
+Open [http://localhost:3000](http://localhost:3000). Edit \`app/page.tsx\` and \`lib/site.ts\`.
+
+Built with [Lacspace](https://lacspace.com/packages).
+`;
+var NAV = (name, links) => `<header className="sticky top-0 z-40 backdrop-blur border-b border-white/10">
+        <nav className="mx-auto flex max-w-6xl items-center justify-between px-6 py-4">
+          <span className="text-lg font-black gradient-text">${name}</span>
+          <div className="hidden gap-8 text-sm text-white/60 sm:flex">
+            ${links.map((l) => `<a href="#${l.toLowerCase()}" className="hover:text-white">${l}</a>`).join("\n            ")}
+          </div>
+        </nav>
+      </header>`;
+var FOOTER = (name) => `<footer className="border-t border-white/10 py-10 text-center text-sm text-white/40">
+        \xA9 {new Date().getFullYear()} ${name}. Built with{" "}
+        <a href="https://lacspace.com/packages" className="text-white/70 hover:text-white">Lacspace</a>.
+      </footer>`;
+function homePage(ctx) {
+  const n = ctx.template.siteName;
+  const shell = (inner) => `export default function Home() {
+  return (
+    <main className="min-h-screen">
+      ${inner}
+    </main>
+  );
+}
+`;
+  if (ctx.template.key === "personal") {
+    return shell(`${NAV(n, ["Work", "About", "Contact"])}
+      <section className="mx-auto max-w-3xl px-6 py-28 text-center">
+        <p className="mb-4 text-sm font-semibold uppercase tracking-widest text-white/40">Portfolio</p>
+        <h1 className="text-5xl font-black leading-tight sm:text-7xl">Hi, I'm <span className="gradient-text">${n}</span>.</h1>
+        <p className="mx-auto mt-6 max-w-xl text-lg text-white/60">${ctx.template.siteDescription}</p>
+        <div className="mt-10 flex justify-center gap-4">
+          <a href="#work" className="gradient-bg rounded-full px-6 py-3 font-semibold text-black">View my work</a>
+          <a href="#contact" className="rounded-full border border-white/20 px-6 py-3 font-semibold hover:bg-white/5">Get in touch</a>
+        </div>
+      </section>
+      <section id="work" className="mx-auto max-w-6xl px-6 py-16">
+        <h2 className="mb-10 text-3xl font-bold">Selected work</h2>
+        <div className="grid gap-6 sm:grid-cols-2 lg:grid-cols-3">
+          {[1, 2, 3, 4, 5, 6].map((i) => (
+            <div key={i} className="group rounded-2xl border border-white/10 bg-white/[0.02] p-6 transition hover:-translate-y-1 hover:border-white/20">
+              <div className="mb-4 h-32 rounded-xl gradient-bg opacity-80" />
+              <h3 className="font-semibold">Project {i}</h3>
+              <p className="mt-1 text-sm text-white/50">A short description of what you built and the impact it had.</p>
+            </div>
+          ))}
+        </div>
+      </section>
+      ${FOOTER(n)}`);
+  }
+  if (ctx.template.key === "business") {
+    return shell(`${NAV(n, ["Services", "Work", "Contact"])}
+      <section className="mx-auto max-w-4xl px-6 py-28 text-center">
+        <h1 className="text-5xl font-black leading-tight sm:text-6xl">We build products <span className="gradient-text">that grow businesses</span>.</h1>
+        <p className="mx-auto mt-6 max-w-2xl text-lg text-white/60">${ctx.template.siteDescription}</p>
+        <a href="#contact" className="mt-10 inline-block gradient-bg rounded-full px-8 py-3 font-semibold text-black">Start a project</a>
+      </section>
+      <section id="services" className="mx-auto max-w-6xl px-6 py-16">
+        <h2 className="mb-10 text-center text-3xl font-bold">What we do</h2>
+        <div className="grid gap-6 md:grid-cols-3">
+          {[
+            { t: "Strategy", d: "Positioning, research and a roadmap that ships." },
+            { t: "Design", d: "Brand and product design that people remember." },
+            { t: "Engineering", d: "Fast, reliable software built to last." },
+          ].map((s) => (
+            <div key={s.t} className="rounded-2xl border border-white/10 bg-white/[0.02] p-8">
+              <h3 className="text-xl font-bold gradient-text">{s.t}</h3>
+              <p className="mt-2 text-white/60">{s.d}</p>
+            </div>
+          ))}
+        </div>
+      </section>
+      <section id="contact" className="mx-auto max-w-3xl px-6 py-24 text-center">
+        <h2 className="text-3xl font-bold">Let's work together</h2>
+        <p className="mt-3 text-white/60">Tell us about your project and we'll get back within a day.</p>
+        <a href="mailto:hello@example.com" className="mt-8 inline-block rounded-full border border-white/20 px-8 py-3 font-semibold hover:bg-white/5">hello@example.com</a>
+      </section>
+      ${FOOTER(n)}`);
+  }
+  if (ctx.template.key === "ecommerce") {
+    return shell(`${NAV(n, ["Shop", "About", "Cart"])}
+      <section className="mx-auto max-w-5xl px-6 py-24 text-center">
+        <h1 className="text-5xl font-black leading-tight sm:text-6xl"><span className="gradient-text">${n}</span></h1>
+        <p className="mx-auto mt-6 max-w-xl text-lg text-white/60">${ctx.template.siteDescription}</p>
+        <a href="#shop" className="mt-10 inline-block gradient-bg rounded-full px-8 py-3 font-semibold text-black">Shop the collection</a>
+      </section>
+      <section id="shop" className="mx-auto max-w-6xl px-6 py-16">
+        <h2 className="mb-10 text-3xl font-bold">Featured</h2>
+        <div className="grid gap-6 sm:grid-cols-2 lg:grid-cols-4">
+          {[
+            { n: "Aurora Lamp", p: "$89" }, { n: "Terra Mug", p: "$24" },
+            { n: "Linen Throw", p: "$65" }, { n: "Oak Stand", p: "$120" },
+          ].map((prod) => (
+            <div key={prod.n} className="group rounded-2xl border border-white/10 bg-white/[0.02] p-4 transition hover:-translate-y-1">
+              <div className="mb-4 aspect-square rounded-xl gradient-bg opacity-80" />
+              <div className="flex items-center justify-between">
+                <h3 className="font-semibold">{prod.n}</h3>
+                <span className="text-white/60">{prod.p}</span>
+              </div>
+              <button className="mt-3 w-full rounded-lg border border-white/15 py-2 text-sm font-medium hover:bg-white/5">Add to cart</button>
+            </div>
+          ))}
+        </div>
+      </section>
+      ${FOOTER(n)}`);
+  }
+  return shell(`${NAV(n, ["Features", "Pricing", "Sign in"])}
+      <section className="mx-auto max-w-4xl px-6 py-28 text-center">
+        <p className="mb-4 inline-block rounded-full border border-white/15 px-4 py-1 text-xs font-semibold text-white/60">New \xB7 v1.0</p>
+        <h1 className="text-5xl font-black leading-tight sm:text-6xl">Ship faster with <span className="gradient-text">${n}</span></h1>
+        <p className="mx-auto mt-6 max-w-2xl text-lg text-white/60">${ctx.template.siteDescription}</p>
+        <div className="mt-10 flex justify-center gap-4">
+          <a href="#pricing" className="gradient-bg rounded-full px-8 py-3 font-semibold text-black">Start free</a>
+          <a href="#features" className="rounded-full border border-white/20 px-8 py-3 font-semibold hover:bg-white/5">See features</a>
+        </div>
+      </section>
+      <section id="features" className="mx-auto max-w-6xl px-6 py-16">
+        <div className="grid gap-6 md:grid-cols-3">
+          {[
+            { t: "Fast", d: "Built on the edge \u2014 global by default." },
+            { t: "Secure", d: "Hardened headers and auth out of the box." },
+            { t: "Scalable", d: "From your first user to your millionth." },
+          ].map((f) => (
+            <div key={f.t} className="rounded-2xl border border-white/10 bg-white/[0.02] p-8">
+              <h3 className="text-xl font-bold gradient-text">{f.t}</h3>
+              <p className="mt-2 text-white/60">{f.d}</p>
+            </div>
+          ))}
+        </div>
+      </section>
+      <section id="pricing" className="mx-auto max-w-md px-6 py-24 text-center">
+        <div className="rounded-3xl border border-white/10 bg-white/[0.02] p-10">
+          <h2 className="text-3xl font-bold">Pro</h2>
+          <p className="mt-2 text-5xl font-black gradient-text">$29<span className="text-lg text-white/40">/mo</span></p>
+          <a href="#" className="mt-8 inline-block w-full gradient-bg rounded-full px-8 py-3 font-semibold text-black">Get started</a>
+        </div>
+      </section>
+      ${FOOTER(n)}`);
+}
+function buildFiles(ctx) {
+  return {
+    "package.json": pkgJson(ctx),
+    "tsconfig.json": tsconfig(),
+    "next.config.mjs": nextConfig(),
+    "postcss.config.mjs": postcss(),
+    ".gitignore": gitignore(),
+    "README.md": readme(ctx),
+    "lib/site.ts": siteTs(ctx),
+    "app/layout.tsx": layout(ctx),
+    "app/globals.css": globalsCss(ctx),
+    "app/page.tsx": homePage(ctx),
+    "app/robots.txt/route.ts": robotsTs(),
+    "app/sitemap.xml/route.ts": sitemapTs()
+  };
+}
+function parseArgs(list) {
+  const a = { yes: false, install: true, git: true, pm: "npm", help: false };
+  for (let i = 0; i < list.length; i++) {
+    const arg = list[i];
+    const next = () => list[++i] ?? "";
+    if (arg === "-t" || arg === "--template") a.template = next();
+    else if (arg === "-y" || arg === "--yes") a.yes = true;
+    else if (arg === "--no-install") a.install = false;
+    else if (arg === "--no-git") a.git = false;
+    else if (arg === "--pm") a.pm = next();
+    else if (arg === "-h" || arg === "--help") a.help = true;
+    else if (arg.startsWith("--template=")) a.template = arg.slice(11);
+    else if (!arg.startsWith("-") && !a.name) a.name = arg;
+  }
+  return a;
+}
+var HELP = `
+${c("bold", "create-lacspace-app")} \u2014 scaffold a beautiful Next.js app, Lacspace-wired
+
+${c("bold", "Usage")}
+  npm create lacspace-app@latest <name> [options]
+  npx create-lacspace-app <name> --template <key>
+
+${c("bold", "Templates")}
+${TEMPLATES.map((t) => `  ${t.key.padEnd(10)} ${t.description}`).join("\n")}
+
+${c("bold", "Options")}
+  -t, --template <key>   Template (${TEMPLATES.map((t) => t.key).join(" | ")})
+  --pm <npm|pnpm|yarn|bun>  Package manager (default npm)
+  --no-install           Skip installing dependencies
+  --no-git               Skip git init
+  -y, --yes              Accept defaults (needs <name>)
+  -h, --help             Show this help
+`;
+async function main() {
+  const args = parseArgs(argv.slice(2));
+  if (args.help) {
+    stdout.write(HELP + "\n");
+    return;
+  }
+  stdout.write(`
+${c("bold", c("magenta", "\u25C6 create-lacspace-app"))} ${c("dim", "\u2014 a gorgeous Next.js starter, batteries wired")}
+
+`);
+  let name = args.name;
+  let templateKey = args.template;
+  if (!args.yes) {
+    const rl = createInterface({ input: stdin, output: stdout });
+    try {
+      if (!name) name = (await rl.question(`${c("green", "?")} Project name ${c("dim", "(my-app)")}: `)).trim() || "my-app";
+      if (!templateKey) {
+        stdout.write(`
+  Choose a template:
+`);
+        TEMPLATES.forEach((t, i) => stdout.write(`   ${c("cyan", String(i + 1))}. ${c("bold", t.label)} ${c("dim", "\u2014 " + t.description)}
+`));
+        const ans = (await rl.question(`
+${c("green", "?")} Template ${c("dim", "(1)")}: `)).trim() || "1";
+        const idx = /^\d+$/.test(ans) ? parseInt(ans, 10) - 1 : TEMPLATES.findIndex((t) => t.key === ans);
+        templateKey = TEMPLATES[idx]?.key ?? "personal";
+      }
+    } finally {
+      rl.close();
+    }
+  }
+  name = name ?? "my-app";
+  const template = TEMPLATES.find((t) => t.key === templateKey) ?? TEMPLATES[0];
+  const dir = resolve(cwd(), name);
+  const projectName = basename(dir).toLowerCase().replace(/[^a-z0-9-_]/g, "-");
+  if (existsSync(dir) && readdirSync(dir).length > 0) {
+    stdout.write(c("red", `
+\u2717 Directory "${name}" already exists and is not empty.
+
+`));
+    exit(1);
+    return;
+  }
+  const files = buildFiles({ name: projectName, template });
+  for (const [rel, content] of Object.entries(files)) {
+    const full = join(dir, rel);
+    mkdirSync(dirname(full), { recursive: true });
+    writeFileSync(full, content);
+  }
+  stdout.write(`
+  ${c("green", "\u2714")} Created ${c("bold", name)} ${c("dim", `(${template.label})`)}
+`);
+  for (const rel of Object.keys(files)) stdout.write(`    ${c("dim", "+ " + rel)}
+`);
+  if (args.git) {
+    const r = spawnSync("git", ["init", "-q"], { cwd: dir, stdio: "ignore" });
+    if (r.status === 0) stdout.write(`
+  ${c("green", "\u2714")} Initialised git
+`);
+  }
+  if (args.install) {
+    stdout.write(`
+  ${c("cyan", "\u25F7")} Installing dependencies with ${args.pm}\u2026
+`);
+    const install = args.pm === "yarn" ? [] : ["install"];
+    const r = spawnSync(args.pm, install, { cwd: dir, stdio: "inherit" });
+    if (r.status !== 0) stdout.write(c("yellow", `
+  ! Install failed \u2014 run "${args.pm} install" yourself.
+`));
+  }
+  const run = args.pm === "npm" ? "npm run dev" : `${args.pm} dev`;
+  stdout.write(`
+${c("bold", "Done! Next steps")}
+`);
+  stdout.write(`  ${c("cyan", `cd ${name}`)}
+`);
+  if (!args.install) stdout.write(`  ${c("cyan", `${args.pm} install`)}
+`);
+  stdout.write(`  ${c("cyan", run)}
+`);
+  stdout.write(`
+  Edit ${c("cyan", "lib/site.ts")} (your SEO config) and ${c("cyan", "app/page.tsx")}.
+`);
+  stdout.write(`
+  ${c("green", "Happy building!")} ${c("dim", "https://lacspace.com/packages")}
+
+`);
+}
+main().catch((err) => {
+  stdout.write(c("red", `
+\u2717 ${err instanceof Error ? err.message : String(err)}
+
+`));
+  exit(1);
+});

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "create-lacspace-app",
+  "version": "1.0.0",
+  "description": "Scaffold a beautiful, production-ready Next.js app from a Lacspace template — personal portfolio, business site, e-commerce or SaaS landing — pre-wired with SEO metadata + JSON-LD, security headers, sitemap and robots. Like create-next-app, but you start gorgeous.",
+  "type": "module",
+  "bin": { "create-lacspace-app": "./dist/index.js" },
+  "files": ["dist"],
+  "scripts": { "build": "tsup", "prepublishOnly": "npm run build" },
+  "keywords": ["create-lacspace-app", "nextjs", "next-app", "starter", "template", "scaffold", "boilerplate", "portfolio-template", "ecommerce-template", "saas-template", "cli", "create-next-app-alternative", "typescript"],
+  "author": "Lacspace <contact@lacspace.com>",
+  "license": "SEE LICENSE IN LICENSE",
+  "homepage": "https://lacspace.com/packages",
+  "repository": { "type": "git", "url": "git+https://github.com/lacspace/npm-packages.git", "directory": "create-lacspace-app" },
+  "bugs": { "url": "https://github.com/lacspace/npm-packages/issues" },
+  "engines": { "node": ">=18" },
+  "publishConfig": { "access": "public" }
+}