create-lacspace-app 1.15.0 → 1.16.1

package/README.md

@@ -99,23 +99,41 @@ Every template is Next.js 15 App Router + React 19 + Tailwind v4 — dark, moder
 | Flag | Meaning |
 | --- | --- |
 | `-t, --template <key>` | `personal` · `business` · `ecommerce` · `saas` · `blog` · `docs` · `dashboard` · `restaurant` |
+| `--theme <name\|hex>` | accent gradient — a preset, a `"#hex"`, or `"from,to"` (see below) |
 | `--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) |
 
+### 🎨 Themes
+
+Recolour the whole app — gradient, OG images, favicon and PWA theme colour — at scaffold time with `--theme`:
+
+```bash
+npx create-lacspace-app my-app --template saas --theme lacspace   # a named preset
+npx create-lacspace-app my-app --theme "#ff6a00"                   # one colour → auto gradient
+npx create-lacspace-app my-app --theme "#0bb9d9,#7c3aed"           # an exact from → to pair
+```
+
+**Presets:** `lacspace` · `violet` · `indigo` · `blue` · `cyan` · `sky` · `teal` · `emerald` · `green` · `lime` · `amber` · `orange` · `red` · `rose` · `pink` · `fuchsia` · `purple` · `slate` · `sunset` · `ocean` · `forest` · `aurora` · `gold`. Give a single hex and the CLI derives a matching second stop for you.
+
 ## 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; the apps you generate are entirely yours.
+Free under the **[Lacspace Free Licence](https://lacspace.com/licenses/lacspace-free-1.0)** — permissive freedoms. Use it in personal and commercial projects at no cost; the apps you generate are entirely yours.
+
+<!-- LACSPACE-DEV-PLATFORM -->
 
 ---
 
-<div align="center">
+## The Lacspace Developer Platform
 
-**Part of the Lacspace ecosystem — 60+ zero-dependency, isomorphic TypeScript packages.**
+`create-lacspace-app` is part of **63 zero-dependency, isomorphic TypeScript packages** — one standard library for the modern web. Explore the ecosystem:
 
-[All packages ↗](https://lacspace.com/packages) · [Docs ↗](https://lacspace.com/docs) · [npm org ↗](https://www.npmjs.com/org/lacspace) · [GitHub ↗](https://github.com/lacspace/npm-packages)
+- 🗂️ **All 63 packages** — https://developer.lacspace.com/packages
+- 🧭 **Developer handbook** — guides & runnable recipes — https://developer.lacspace.com/handbook
+- 🧪 **Live playground** — run any package in your browser — https://developer.lacspace.com/playground
+- 🖥️ **Finished app templates** — https://templates.lacspace.com
+- 🚀 **Scaffold a full app** — `npm create lacspace-app@latest`
 
-</div>
+Free under the **[Lacspace Free Licence](https://lacspace.com/licenses/lacspace-free-1.0)** — a permissive, free-to-use licence.
 
-<div align="center"><sub>Built with care by <a href="https://lacspace.com">Lacspace</a> · Lacspace Free Licence</sub></div>

package/dist/index.js

@@ -35,11 +35,11 @@ var pkgJson = (ctx) => JSON.stringify({
     next: "^15.1.0",
     react: "^19.0.0",
     "react-dom": "^19.0.0",
-    "@lacspace/seo": "^1.6.2",
+    "@lacspace/seo": "^1.7.0",
     "@lacspace/headers": "^1.1.2",
-    "@lacspace/robots": "^1.2.1",
-    "@lacspace/sitemap": "^1.1.1",
-    "@lacspace/og": "^1.0.1",
+    "@lacspace/robots": "^1.3.0",
+    "@lacspace/sitemap": "^1.2.0",
+    "@lacspace/og": "^1.1.0",
     "@lacspace/ui": "^1.0.1",
     "@lacspace/form": "^1.0.1",
     "@lacspace/validate": "^1.0.1",
@@ -3450,12 +3450,92 @@ function parseArgs(list) {
     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 === "--theme" || arg === "--accent") a.theme = next();
     else if (arg === "-h" || arg === "--help") a.help = true;
     else if (arg.startsWith("--template=")) a.template = arg.slice(11);
+    else if (arg.startsWith("--theme=")) a.theme = arg.slice(8);
+    else if (arg.startsWith("--accent=")) a.theme = arg.slice(9);
     else if (!arg.startsWith("-") && !a.name) a.name = arg;
   }
   return a;
 }
+var THEMES = {
+  lacspace: ["#0bb9d9", "#7c3aed"],
+  violet: ["#7c3aed", "#ec4899"],
+  indigo: ["#6366f1", "#a855f7"],
+  blue: ["#2563eb", "#06b6d4"],
+  cyan: ["#0891b2", "#22d3ee"],
+  sky: ["#0ea5e9", "#38bdf8"],
+  teal: ["#0d9488", "#22c55e"],
+  emerald: ["#10b981", "#14b8a6"],
+  green: ["#16a34a", "#4ade80"],
+  lime: ["#65a30d", "#a3e635"],
+  amber: ["#f59e0b", "#f97316"],
+  orange: ["#ea580c", "#f59e0b"],
+  red: ["#dc2626", "#f97316"],
+  rose: ["#e11d48", "#fb7185"],
+  pink: ["#db2777", "#f472b6"],
+  fuchsia: ["#c026d3", "#f0abfc"],
+  purple: ["#9333ea", "#d946ef"],
+  slate: ["#475569", "#94a3b8"],
+  sunset: ["#f97316", "#db2777"],
+  ocean: ["#0ea5e9", "#6366f1"],
+  forest: ["#16a34a", "#65a30d"],
+  aurora: ["#22d3ee", "#a855f7"],
+  gold: ["#d97706", "#facc15"]
+};
+var normHex = (h) => {
+  let s = h.trim().replace(/^#/, "");
+  if (/^[0-9a-fA-F]{3}$/.test(s)) s = s.split("").map((ch) => ch + ch).join("");
+  return /^[0-9a-fA-F]{6}$/.test(s) ? "#" + s.toLowerCase() : null;
+};
+var hexToRgb = (h) => {
+  const n = parseInt(h.slice(1), 16);
+  return [n >> 16 & 255, n >> 8 & 255, n & 255];
+};
+var rgbToHex = (r, g, b) => "#" + [r, g, b].map((x) => Math.max(0, Math.min(255, Math.round(x))).toString(16).padStart(2, "0")).join("");
+var rgbToHsl = (r, g, b) => {
+  r /= 255;
+  g /= 255;
+  b /= 255;
+  const max = Math.max(r, g, b), min = Math.min(r, g, b);
+  let h = 0, s = 0;
+  const l = (max + min) / 2;
+  if (max !== min) {
+    const d = max - min;
+    s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+    h = max === r ? (g - b) / d + (g < b ? 6 : 0) : max === g ? (b - r) / d + 2 : (r - g) / d + 4;
+    h /= 6;
+  }
+  return [h * 360, s, l];
+};
+var hslToRgb = (h, s, l) => {
+  h = (h % 360 + 360) % 360 / 360;
+  const q = l < 0.5 ? l * (1 + s) : l + s - l * s, p = 2 * l - q;
+  const hue = (t) => {
+    t = (t + 1) % 1;
+    return t < 1 / 6 ? p + (q - p) * 6 * t : t < 1 / 2 ? q : t < 2 / 3 ? p + (q - p) * (2 / 3 - t) * 6 : p;
+  };
+  return [hue(h + 1 / 3) * 255, hue(h) * 255, hue(h - 1 / 3) * 255];
+};
+var hexPair = (hex) => {
+  const [h, s, l] = rgbToHsl(...hexToRgb(hex));
+  const [r2, g2, b2] = hslToRgb(h + 28, Math.min(1, s + 0.05), Math.min(0.72, l + 0.1));
+  return [hex, rgbToHex(r2, g2, b2)];
+};
+function resolveAccent(theme) {
+  if (!theme) return null;
+  const key = theme.toLowerCase().trim();
+  if (THEMES[key]) return THEMES[key];
+  if (key.includes(",")) {
+    const [a, b] = key.split(",").map((p) => normHex(p));
+    if (a && b) return [a, b];
+    if (a) return hexPair(a);
+    return null;
+  }
+  const one = normHex(key);
+  return one ? hexPair(one) : null;
+}
 var HELP = `
 ${c("bold", "create-lacspace-app")} \u2014 scaffold a beautiful Next.js app, Lacspace-wired
 
@@ -3469,12 +3549,17 @@ ${TEMPLATES.map((t) => `  ${t.key.padEnd(10)} ${t.description}`).join("\n")}
 
 ${c("bold", "Options")}
   -t, --template <key>   Template (${TEMPLATES.map((t) => t.key).join(" | ")})
+  --theme <name|hex>     Accent: a preset, a "#hex", or "from,to" (e.g. --theme lacspace)
   --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
 
+${c("bold", "Themes")} ${c("dim", "(--theme)")}
+  ${Object.keys(THEMES).join(" \xB7 ")}
+  ${c("dim", 'or a custom colour: --theme "#ff6a00"  \xB7  --theme "#0bb9d9,#7c3aed"')}
+
 ${c("bold", "Add sections to an existing app")}
   npx create-lacspace-app add pricing faq testimonials
   ${c("dim", "Drops prebuilt, themed sections into components/sections/ (and the UI kit if missing).")}
@@ -3770,7 +3855,15 @@ ${c("green", "?")} Template ${c("dim", "(1)")}: `)).trim() || "1";
     }
   }
   name = name ?? "my-app";
-  const template = TEMPLATES.find((t) => t.key === templateKey) ?? TEMPLATES[0];
+  const base = TEMPLATES.find((t) => t.key === templateKey) ?? TEMPLATES[0];
+  const accent = resolveAccent(args.theme);
+  if (args.theme && !accent) {
+    stdout.write(c("yellow", `  ! Unknown theme "${args.theme}" \u2014 using the ${base.key} default. Try a preset (${Object.keys(THEMES).slice(0, 6).join(", ")}\u2026) or a hex like "#ff6a00".
+`));
+  }
+  const template = accent ? { ...base, accent } : base;
+  if (accent) stdout.write(`  ${c("dim", "theme")} ${c("bold", args.theme)} ${c("dim", `\u2192 ${accent[0]} \u2192 ${accent[1]}`)}
+`);
   const dir = resolve(cwd(), name);
   const projectName = basename(dir).toLowerCase().replace(/[^a-z0-9-_]/g, "-");
   if (existsSync(dir) && readdirSync(dir).length > 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-lacspace-app",
-  "version": "1.15.0",
+  "version": "1.16.1",
   "description": "Scaffold a beautiful, production-ready Next.js app from a Lacspace template — portfolio, business, e-commerce, SaaS, blog, docs, dashboard or restaurant — pre-wired with SEO, security headers, sitemap and robots. Like create-next-app, but you start gorgeous.",
   "type": "module",
   "bin": {
@@ -34,7 +34,7 @@
   ],
   "author": "Lacspace <contact@lacspace.com>",
   "license": "SEE LICENSE IN LICENSE",
-  "homepage": "https://lacspace.com/packages",
+  "homepage": "https://templates.lacspace.com",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/lacspace/npm-packages.git",