create-lacspace-app 2.4.0 → 2.5.0

package/README.md

@@ -20,6 +20,12 @@ npx create-lacspace-app my-app --template saas --fullstack
 
 You choose the *kind* of site you're building. It writes a **real Next.js 15 + React 19 + Tailwind v4 app** — not a hello-world, but a genuinely **polished, modern site**: a fluid `clamp()` type scale, tight display headings, a refined light **and** dark palette, glass chrome, soft layered shadows, a smooth logo marquee, animated counters, scroll reveals and a shimmering primary CTA — every page filled in, an SEO stack wired end-to-end, and a **26-component UI kit** you can drop in anywhere.
 
+> **New in v2.5 — more prebuilt add-ons.** The `--with` catalog grows beyond AI:
+> - **`content`** — a Markdown content section (`/updates`) for *any* template, with an auto-generated **RSS feed** and **`llms.txt`**. Drop `.md` files in, get pages.
+> - **`search`** — **instant, keyless full-text search** (BM25) over your Markdown — a search box, a `/search` page and an API route. No API key, no service, no Ollama required.
+>
+> More add-ons (auth, payments, email, analytics…) are on the way — same rules: additive, keyless, free-first.
+
 > **New in v2.4 — static *or* full-stack.** Now the interactive prompt (after you pick a template) asks what *kind* of app you want:
 > - **Static / frontend only** *(default)* — today's single Next.js app, unchanged.
 > - **Dynamic / full-stack** (`--fullstack`) — an npm-workspaces **monorepo**: a `frontend/` Next.js app **+** a `backend/` **Node · Express · MongoDB · Redis · TypeScript** API **+** a shared `types/` package the two both import (so the API contract can't drift), plus a root `docker-compose.yml` (Mongo + Redis) and **one** `npm install` / `npm run dev` for the whole thing.

package/dist/index.js

@@ -2117,6 +2117,51 @@ var FEATURES = [
       "Run `npm run dev` and open http://localhost:3000/ask."
     ],
     learn: "https://developer.lacspace.com/packages/rag"
+  },
+  {
+    key: "content",
+    label: "Content / blog",
+    description: "A markdown content section (/updates) for any template \u2014 plus an RSS feed and an llms.txt. Drop in .md files, get pages.",
+    deps: {
+      "@lacspace/markdown": "^1.1.0",
+      "@lacspace/rss": "^1.4.0",
+      "@lacspace/llms-txt": "^1.4.0"
+    },
+    files: (ctx) => ({
+      "content/updates/welcome.md": contentSampleWelcome(ctx),
+      "content/updates/building-in-public.md": contentSampleSecond(),
+      "lib/content.ts": contentLib(),
+      "app/updates/page.tsx": updatesListPage(),
+      "app/updates/[slug]/page.tsx": updatePostPage(),
+      "app/feed.xml/route.ts": feedRoute(),
+      "app/llms.txt/route.ts": llmsRoute()
+    }),
+    nextSteps: [
+      "Add markdown files to content/updates/ \u2014 each becomes a page at /updates/<name>.",
+      "Run `npm run dev` and open http://localhost:3000/updates, /feed.xml and /llms.txt.",
+      "Set NEXT_PUBLIC_SITE_URL in .env so the feed and llms.txt links are absolute."
+    ],
+    learn: "https://developer.lacspace.com/packages/markdown"
+  },
+  {
+    key: "search",
+    label: "Search",
+    description: "Instant, keyless full-text search (BM25) over your markdown content \u2014 a search box + /search page + API route. No key, no service.",
+    deps: {
+      "@lacspace/rerank": "^1.0.0",
+      "@lacspace/markdown": "^1.1.0"
+    },
+    files: () => ({
+      "app/api/search/route.ts": searchRoute(),
+      "components/search.tsx": searchBox(),
+      "app/search/page.tsx": searchPage()
+    }),
+    nextSteps: [
+      "Add markdown to content/ (e.g. the `content` add-on's content/updates/) \u2014 search indexes it automatically.",
+      "Run `npm run dev` and open http://localhost:3000/search, or drop <Search /> into your header.",
+      "Want semantic search? Upgrade to @lacspace/embeddings + @lacspace/vector (keyless-local via Ollama)."
+    ],
+    learn: "https://developer.lacspace.com/packages/rerank"
   }
 ];
 var aiChatRoute = (_ctx) => `import { resolveConfig } from "@lacspace/providers";
@@ -5095,6 +5140,278 @@ var faqSection = (ctx) => {
         </div>
       </section>`;
 };
+var contentLib = () => `import fs from "node:fs";
+import path from "node:path";
+import { parseFrontmatter, markdownToHtml, excerpt } from "@lacspace/markdown";
+
+// how this works: every .md file in content/updates/ becomes a post. Frontmatter
+// (title/date/description) is read with @lacspace/markdown; the body is rendered to
+// safe HTML (raw HTML in the source is escaped, so this is XSS-safe by construction).
+const DIR = path.join(process.cwd(), "content/updates");
+
+export interface PostMeta { slug: string; title: string; date: string; description: string; }
+export interface Post extends PostMeta { html: string; }
+
+function read(slug: string): Post | null {
+  const file = path.join(DIR, slug + ".md");
+  if (!fs.existsSync(file)) return null;
+  const { data, content } = parseFrontmatter(fs.readFileSync(file, "utf8"));
+  return {
+    slug,
+    title: String(data.title ?? slug),
+    date: String(data.date ?? ""),
+    description: String(data.description ?? excerpt(content, { length: 160 })),
+    html: markdownToHtml(content, { headingIds: true, openLinksInNewTab: true }),
+  };
+}
+
+export function getAllPosts(): PostMeta[] {
+  if (!fs.existsSync(DIR)) return [];
+  return fs.readdirSync(DIR)
+    .filter((f) => f.endsWith(".md"))
+    .map((f) => read(f.replace(/\\.md$/, ""))!)
+    .filter(Boolean)
+    .sort((a, b) => (a.date < b.date ? 1 : -1));
+}
+
+export function getPost(slug: string): Post | null {
+  return read(slug);
+}
+`;
+var updatesListPage = () => `import Link from "next/link";
+import { site } from "@/lib/site";
+import { getAllPosts } from "@/lib/content";
+
+export const metadata = site.meta({ title: "Updates", path: "/updates" });
+
+export default function UpdatesPage() {
+  const posts = getAllPosts();
+  return (
+    <main className="mx-auto max-w-3xl px-6 py-16">
+      <h1 className="text-3xl font-bold">Updates</h1>
+      <p className="mt-2 text-muted">News, notes and posts. <a href="/feed.xml" className="underline">RSS</a></p>
+      {posts.length === 0 && (
+        <p className="mt-8 text-muted">No posts yet \u2014 add a markdown file in <code>content/updates/</code>.</p>
+      )}
+      <ul className="mt-8 space-y-6">
+        {posts.map((p) => (
+          <li key={p.slug} className="border-b border-hairline pb-6">
+            <Link href={\`/updates/\${p.slug}\`} className="text-xl font-semibold hover:underline">{p.title}</Link>
+            {p.date && <p className="mt-1 text-sm text-muted">{p.date}</p>}
+            <p className="mt-2 text-muted">{p.description}</p>
+          </li>
+        ))}
+      </ul>
+    </main>
+  );
+}
+`;
+var updatePostPage = () => `import Link from "next/link";
+import { notFound } from "next/navigation";
+import { site } from "@/lib/site";
+import { getAllPosts, getPost } from "@/lib/content";
+
+export function generateStaticParams() {
+  return getAllPosts().map((p) => ({ slug: p.slug }));
+}
+
+export async function generateMetadata({ params }: { params: Promise<{ slug: string }> }) {
+  const { slug } = await params;
+  const post = getPost(slug);
+  return site.meta({ title: post?.title ?? "Updates", path: \`/updates/\${slug}\` });
+}
+
+export default async function PostPage({ params }: { params: Promise<{ slug: string }> }) {
+  const { slug } = await params;
+  const post = getPost(slug);
+  if (!post) notFound();
+  return (
+    <main className="mx-auto max-w-2xl px-6 py-16">
+      <Link href="/updates" className="text-sm text-muted hover:underline">\u2190 Updates</Link>
+      <h1 className="mt-4 text-3xl font-bold">{post.title}</h1>
+      {post.date && <p className="mt-1 text-sm text-muted">{post.date}</p>}
+      <article
+        className="mt-8 leading-7 [&_h2]:mt-8 [&_h2]:text-2xl [&_h2]:font-bold [&_h3]:mt-6 [&_h3]:text-xl [&_h3]:font-semibold [&_p]:mt-4 [&_p]:text-muted [&_a]:underline [&_ul]:mt-4 [&_ul]:list-disc [&_ul]:pl-6 [&_li]:mt-1 [&_pre]:mt-4 [&_pre]:overflow-x-auto [&_pre]:rounded-xl [&_pre]:bg-surface [&_pre]:p-4 [&_pre]:text-sm [&_code]:text-sm"
+        dangerouslySetInnerHTML={{ __html: post.html }}
+      />
+    </main>
+  );
+}
+`;
+var feedRoute = () => `import { rssResponse } from "@lacspace/rss";
+import { getAllPosts } from "@/lib/content";
+
+export const dynamic = "force-static";
+
+export function GET() {
+  const base = process.env.NEXT_PUBLIC_SITE_URL ?? "http://localhost:3000";
+  const items = getAllPosts().map((p) => ({
+    title: p.title,
+    link: base + "/updates/" + p.slug,
+    description: p.description,
+    // Only pass a date the feed can parse (rfc822Date throws on bad input).
+    date: p.date && !Number.isNaN(Date.parse(p.date)) ? p.date : undefined,
+  }));
+  return rssResponse(
+    { title: "Updates", link: base, description: "The latest posts and updates.", feedUrl: base + "/feed.xml" },
+    items,
+  );
+}
+`;
+var llmsRoute = () => `import { llmsTxtFromPages } from "@lacspace/llms-txt";
+import { getAllPosts } from "@/lib/content";
+
+export const dynamic = "force-static";
+
+export function GET() {
+  const base = process.env.NEXT_PUBLIC_SITE_URL ?? "http://localhost:3000";
+  const txt = llmsTxtFromPages(
+    getAllPosts().map((p) => ({ title: p.title, url: base + "/updates/" + p.slug, content: p.description, section: "Updates" })),
+    { title: "Updates", summary: "A content index for large language models." },
+  );
+  return new Response(txt, { headers: { "content-type": "text/plain; charset=utf-8" } });
+}
+`;
+var contentSampleWelcome = (ctx) => `---
+title: Welcome to ${ctx.template.siteName}'s content section
+date: 2026-01-15
+description: This markdown file became a page automatically \u2014 here's how it works.
+---
+
+## It just works
+
+Drop any \\\`.md\\\` file into \\\`content/updates/\\\` and it becomes a page at \\\`/updates/<filename>\\\`, listed on \\\`/updates\\\`, and included in \\\`/feed.xml\\\` and \\\`/llms.txt\\\`.
+
+- Frontmatter \\\`title\\\`, \\\`date\\\` and \\\`description\\\` are read automatically.
+- The body is rendered safely with \\\`@lacspace/markdown\\\` \u2014 raw HTML is escaped, so it's XSS-safe.
+- Delete this file when you're ready to write your own.
+`;
+var contentSampleSecond = () => `---
+title: Building in public
+date: 2026-01-10
+description: A second example post so the list and feed have something to show.
+---
+
+## Why a content section?
+
+Every product needs a place for changelog posts, announcements and notes. This one is
+Markdown-powered, needs no database, and ships an RSS feed and an \\\`llms.txt\\\` for free.
+
+### Add your own
+
+1. Create \\\`content/updates/my-post.md\\\`.
+2. Add frontmatter (\\\`title\\\`, \\\`date\\\`, \\\`description\\\`).
+3. Write. That's it \u2014 it appears at \\\`/updates/my-post\\\`.
+`;
+var searchRoute = () => `import fs from "node:fs";
+import path from "node:path";
+import { parseFrontmatter, toPlainText, excerpt } from "@lacspace/markdown";
+import { rerank } from "@lacspace/rerank";
+
+// how this works: full-text search with BM25 ranking \u2014 no external service, no API
+// key, no Ollama. It scans your markdown at request time and ranks matches. (For a
+// big site, precompute the corpus at build time and cache it instead.)
+export const runtime = "nodejs";
+export const dynamic = "force-dynamic";
+
+const ROOT = path.join(process.cwd(), "content");
+// Map a content/<dir>/ to the route it renders under.
+const SECTION: Record<string, string> = { updates: "/updates", posts: "/blog", docs: "/docs" };
+
+interface Entry { id: string; title: string; url: string; text: string; }
+
+function corpus(): Entry[] {
+  if (!fs.existsSync(ROOT)) return [];
+  const out: Entry[] = [];
+  for (const dir of fs.readdirSync(ROOT)) {
+    const full = path.join(ROOT, dir);
+    if (!fs.statSync(full).isDirectory()) continue;
+    const base = SECTION[dir] ?? "/" + dir;
+    for (const file of fs.readdirSync(full)) {
+      if (!file.endsWith(".md")) continue;
+      const slug = file.replace(/\\.md$/, "");
+      const { data, content } = parseFrontmatter(fs.readFileSync(path.join(full, file), "utf8"));
+      out.push({ id: dir + "/" + slug, title: String(data.title ?? slug), url: base + "/" + slug, text: toPlainText(content) });
+    }
+  }
+  return out;
+}
+
+export async function GET(req: Request) {
+  const q = new URL(req.url).searchParams.get("q")?.trim() ?? "";
+  if (!q) return Response.json([]);
+  const docs = corpus().map((e) => ({ id: e.id, text: e.title + "\\n" + e.text, metadata: { title: e.title, url: e.url } }));
+  const hits = await rerank(q, docs, { method: "bm25", k: 8 });
+  return Response.json(hits.map((h) => ({
+    title: String(h.metadata?.title ?? ""),
+    url: String(h.metadata?.url ?? "#"),
+    snippet: excerpt(h.text.split("\\n").slice(1).join(" "), { length: 140 }),
+  })));
+}
+`;
+var searchBox = () => `"use client";
+import { useState, useEffect, useRef } from "react";
+
+interface Result { title: string; url: string; snippet: string; }
+
+export function Search() {
+  const [q, setQ] = useState("");
+  const [results, setResults] = useState<Result[]>([]);
+  const [open, setOpen] = useState(false);
+  const timer = useRef<ReturnType<typeof setTimeout> | null>(null);
+
+  useEffect(() => {
+    if (timer.current) clearTimeout(timer.current);
+    if (!q.trim()) { setResults([]); return; }
+    timer.current = setTimeout(async () => {
+      const res = await fetch("/api/search?q=" + encodeURIComponent(q));
+      setResults(await res.json());
+      setOpen(true);
+    }, 200);
+    return () => { if (timer.current) clearTimeout(timer.current); };
+  }, [q]);
+
+  return (
+    <div className="relative w-full max-w-md">
+      <input
+        value={q}
+        onChange={(e) => setQ(e.target.value)}
+        onFocus={() => { if (results.length) setOpen(true); }}
+        onBlur={() => setTimeout(() => setOpen(false), 150)}
+        placeholder="Search\u2026"
+        className="w-full rounded-xl border border-hairline bg-surface px-4 py-2 outline-none"
+      />
+      {open && results.length > 0 && (
+        <ul className="absolute z-20 mt-2 w-full overflow-hidden rounded-xl border border-hairline bg-app shadow-lg">
+          {results.map((r) => (
+            <li key={r.url}>
+              <a href={r.url} className="block px-4 py-3 transition hover:bg-surface">
+                <p className="font-medium">{r.title}</p>
+                <p className="mt-0.5 text-sm text-muted">{r.snippet}</p>
+              </a>
+            </li>
+          ))}
+        </ul>
+      )}
+    </div>
+  );
+}
+`;
+var searchPage = () => `import { site } from "@/lib/site";
+import { Search } from "@/components/search";
+
+export const metadata = site.meta({ title: "Search", path: "/search" });
+
+export default function SearchPage() {
+  return (
+    <main className="mx-auto max-w-2xl px-6 py-16">
+      <h1 className="text-3xl font-bold">Search</h1>
+      <p className="mt-2 text-muted">Instant, keyless full-text search over your content.</p>
+      <div className="mt-8"><Search /></div>
+    </main>
+  );
+}
+`;
 var scope = (ctx) => `@${ctx.name}`;
 var typesPkgJson = (ctx) => JSON.stringify({
   name: `${scope(ctx)}/types`,

package/dist/lib.cjs

@@ -2121,6 +2121,51 @@ var FEATURES = [
       "Run `npm run dev` and open http://localhost:3000/ask."
     ],
     learn: "https://developer.lacspace.com/packages/rag"
+  },
+  {
+    key: "content",
+    label: "Content / blog",
+    description: "A markdown content section (/updates) for any template \u2014 plus an RSS feed and an llms.txt. Drop in .md files, get pages.",
+    deps: {
+      "@lacspace/markdown": "^1.1.0",
+      "@lacspace/rss": "^1.4.0",
+      "@lacspace/llms-txt": "^1.4.0"
+    },
+    files: (ctx) => ({
+      "content/updates/welcome.md": contentSampleWelcome(ctx),
+      "content/updates/building-in-public.md": contentSampleSecond(),
+      "lib/content.ts": contentLib(),
+      "app/updates/page.tsx": updatesListPage(),
+      "app/updates/[slug]/page.tsx": updatePostPage(),
+      "app/feed.xml/route.ts": feedRoute(),
+      "app/llms.txt/route.ts": llmsRoute()
+    }),
+    nextSteps: [
+      "Add markdown files to content/updates/ \u2014 each becomes a page at /updates/<name>.",
+      "Run `npm run dev` and open http://localhost:3000/updates, /feed.xml and /llms.txt.",
+      "Set NEXT_PUBLIC_SITE_URL in .env so the feed and llms.txt links are absolute."
+    ],
+    learn: "https://developer.lacspace.com/packages/markdown"
+  },
+  {
+    key: "search",
+    label: "Search",
+    description: "Instant, keyless full-text search (BM25) over your markdown content \u2014 a search box + /search page + API route. No key, no service.",
+    deps: {
+      "@lacspace/rerank": "^1.0.0",
+      "@lacspace/markdown": "^1.1.0"
+    },
+    files: () => ({
+      "app/api/search/route.ts": searchRoute(),
+      "components/search.tsx": searchBox(),
+      "app/search/page.tsx": searchPage()
+    }),
+    nextSteps: [
+      "Add markdown to content/ (e.g. the `content` add-on's content/updates/) \u2014 search indexes it automatically.",
+      "Run `npm run dev` and open http://localhost:3000/search, or drop <Search /> into your header.",
+      "Want semantic search? Upgrade to @lacspace/embeddings + @lacspace/vector (keyless-local via Ollama)."
+    ],
+    learn: "https://developer.lacspace.com/packages/rerank"
   }
 ];
 var aiChatRoute = (_ctx) => `import { resolveConfig } from "@lacspace/providers";
@@ -5099,6 +5144,278 @@ var faqSection = (ctx) => {
         </div>
       </section>`;
 };
+var contentLib = () => `import fs from "node:fs";
+import path from "node:path";
+import { parseFrontmatter, markdownToHtml, excerpt } from "@lacspace/markdown";
+
+// how this works: every .md file in content/updates/ becomes a post. Frontmatter
+// (title/date/description) is read with @lacspace/markdown; the body is rendered to
+// safe HTML (raw HTML in the source is escaped, so this is XSS-safe by construction).
+const DIR = path.join(process.cwd(), "content/updates");
+
+export interface PostMeta { slug: string; title: string; date: string; description: string; }
+export interface Post extends PostMeta { html: string; }
+
+function read(slug: string): Post | null {
+  const file = path.join(DIR, slug + ".md");
+  if (!fs.existsSync(file)) return null;
+  const { data, content } = parseFrontmatter(fs.readFileSync(file, "utf8"));
+  return {
+    slug,
+    title: String(data.title ?? slug),
+    date: String(data.date ?? ""),
+    description: String(data.description ?? excerpt(content, { length: 160 })),
+    html: markdownToHtml(content, { headingIds: true, openLinksInNewTab: true }),
+  };
+}
+
+export function getAllPosts(): PostMeta[] {
+  if (!fs.existsSync(DIR)) return [];
+  return fs.readdirSync(DIR)
+    .filter((f) => f.endsWith(".md"))
+    .map((f) => read(f.replace(/\\.md$/, ""))!)
+    .filter(Boolean)
+    .sort((a, b) => (a.date < b.date ? 1 : -1));
+}
+
+export function getPost(slug: string): Post | null {
+  return read(slug);
+}
+`;
+var updatesListPage = () => `import Link from "next/link";
+import { site } from "@/lib/site";
+import { getAllPosts } from "@/lib/content";
+
+export const metadata = site.meta({ title: "Updates", path: "/updates" });
+
+export default function UpdatesPage() {
+  const posts = getAllPosts();
+  return (
+    <main className="mx-auto max-w-3xl px-6 py-16">
+      <h1 className="text-3xl font-bold">Updates</h1>
+      <p className="mt-2 text-muted">News, notes and posts. <a href="/feed.xml" className="underline">RSS</a></p>
+      {posts.length === 0 && (
+        <p className="mt-8 text-muted">No posts yet \u2014 add a markdown file in <code>content/updates/</code>.</p>
+      )}
+      <ul className="mt-8 space-y-6">
+        {posts.map((p) => (
+          <li key={p.slug} className="border-b border-hairline pb-6">
+            <Link href={\`/updates/\${p.slug}\`} className="text-xl font-semibold hover:underline">{p.title}</Link>
+            {p.date && <p className="mt-1 text-sm text-muted">{p.date}</p>}
+            <p className="mt-2 text-muted">{p.description}</p>
+          </li>
+        ))}
+      </ul>
+    </main>
+  );
+}
+`;
+var updatePostPage = () => `import Link from "next/link";
+import { notFound } from "next/navigation";
+import { site } from "@/lib/site";
+import { getAllPosts, getPost } from "@/lib/content";
+
+export function generateStaticParams() {
+  return getAllPosts().map((p) => ({ slug: p.slug }));
+}
+
+export async function generateMetadata({ params }: { params: Promise<{ slug: string }> }) {
+  const { slug } = await params;
+  const post = getPost(slug);
+  return site.meta({ title: post?.title ?? "Updates", path: \`/updates/\${slug}\` });
+}
+
+export default async function PostPage({ params }: { params: Promise<{ slug: string }> }) {
+  const { slug } = await params;
+  const post = getPost(slug);
+  if (!post) notFound();
+  return (
+    <main className="mx-auto max-w-2xl px-6 py-16">
+      <Link href="/updates" className="text-sm text-muted hover:underline">\u2190 Updates</Link>
+      <h1 className="mt-4 text-3xl font-bold">{post.title}</h1>
+      {post.date && <p className="mt-1 text-sm text-muted">{post.date}</p>}
+      <article
+        className="mt-8 leading-7 [&_h2]:mt-8 [&_h2]:text-2xl [&_h2]:font-bold [&_h3]:mt-6 [&_h3]:text-xl [&_h3]:font-semibold [&_p]:mt-4 [&_p]:text-muted [&_a]:underline [&_ul]:mt-4 [&_ul]:list-disc [&_ul]:pl-6 [&_li]:mt-1 [&_pre]:mt-4 [&_pre]:overflow-x-auto [&_pre]:rounded-xl [&_pre]:bg-surface [&_pre]:p-4 [&_pre]:text-sm [&_code]:text-sm"
+        dangerouslySetInnerHTML={{ __html: post.html }}
+      />
+    </main>
+  );
+}
+`;
+var feedRoute = () => `import { rssResponse } from "@lacspace/rss";
+import { getAllPosts } from "@/lib/content";
+
+export const dynamic = "force-static";
+
+export function GET() {
+  const base = process.env.NEXT_PUBLIC_SITE_URL ?? "http://localhost:3000";
+  const items = getAllPosts().map((p) => ({
+    title: p.title,
+    link: base + "/updates/" + p.slug,
+    description: p.description,
+    // Only pass a date the feed can parse (rfc822Date throws on bad input).
+    date: p.date && !Number.isNaN(Date.parse(p.date)) ? p.date : undefined,
+  }));
+  return rssResponse(
+    { title: "Updates", link: base, description: "The latest posts and updates.", feedUrl: base + "/feed.xml" },
+    items,
+  );
+}
+`;
+var llmsRoute = () => `import { llmsTxtFromPages } from "@lacspace/llms-txt";
+import { getAllPosts } from "@/lib/content";
+
+export const dynamic = "force-static";
+
+export function GET() {
+  const base = process.env.NEXT_PUBLIC_SITE_URL ?? "http://localhost:3000";
+  const txt = llmsTxtFromPages(
+    getAllPosts().map((p) => ({ title: p.title, url: base + "/updates/" + p.slug, content: p.description, section: "Updates" })),
+    { title: "Updates", summary: "A content index for large language models." },
+  );
+  return new Response(txt, { headers: { "content-type": "text/plain; charset=utf-8" } });
+}
+`;
+var contentSampleWelcome = (ctx) => `---
+title: Welcome to ${ctx.template.siteName}'s content section
+date: 2026-01-15
+description: This markdown file became a page automatically \u2014 here's how it works.
+---
+
+## It just works
+
+Drop any \\\`.md\\\` file into \\\`content/updates/\\\` and it becomes a page at \\\`/updates/<filename>\\\`, listed on \\\`/updates\\\`, and included in \\\`/feed.xml\\\` and \\\`/llms.txt\\\`.
+
+- Frontmatter \\\`title\\\`, \\\`date\\\` and \\\`description\\\` are read automatically.
+- The body is rendered safely with \\\`@lacspace/markdown\\\` \u2014 raw HTML is escaped, so it's XSS-safe.
+- Delete this file when you're ready to write your own.
+`;
+var contentSampleSecond = () => `---
+title: Building in public
+date: 2026-01-10
+description: A second example post so the list and feed have something to show.
+---
+
+## Why a content section?
+
+Every product needs a place for changelog posts, announcements and notes. This one is
+Markdown-powered, needs no database, and ships an RSS feed and an \\\`llms.txt\\\` for free.
+
+### Add your own
+
+1. Create \\\`content/updates/my-post.md\\\`.
+2. Add frontmatter (\\\`title\\\`, \\\`date\\\`, \\\`description\\\`).
+3. Write. That's it \u2014 it appears at \\\`/updates/my-post\\\`.
+`;
+var searchRoute = () => `import fs from "node:fs";
+import path from "node:path";
+import { parseFrontmatter, toPlainText, excerpt } from "@lacspace/markdown";
+import { rerank } from "@lacspace/rerank";
+
+// how this works: full-text search with BM25 ranking \u2014 no external service, no API
+// key, no Ollama. It scans your markdown at request time and ranks matches. (For a
+// big site, precompute the corpus at build time and cache it instead.)
+export const runtime = "nodejs";
+export const dynamic = "force-dynamic";
+
+const ROOT = path.join(process.cwd(), "content");
+// Map a content/<dir>/ to the route it renders under.
+const SECTION: Record<string, string> = { updates: "/updates", posts: "/blog", docs: "/docs" };
+
+interface Entry { id: string; title: string; url: string; text: string; }
+
+function corpus(): Entry[] {
+  if (!fs.existsSync(ROOT)) return [];
+  const out: Entry[] = [];
+  for (const dir of fs.readdirSync(ROOT)) {
+    const full = path.join(ROOT, dir);
+    if (!fs.statSync(full).isDirectory()) continue;
+    const base = SECTION[dir] ?? "/" + dir;
+    for (const file of fs.readdirSync(full)) {
+      if (!file.endsWith(".md")) continue;
+      const slug = file.replace(/\\.md$/, "");
+      const { data, content } = parseFrontmatter(fs.readFileSync(path.join(full, file), "utf8"));
+      out.push({ id: dir + "/" + slug, title: String(data.title ?? slug), url: base + "/" + slug, text: toPlainText(content) });
+    }
+  }
+  return out;
+}
+
+export async function GET(req: Request) {
+  const q = new URL(req.url).searchParams.get("q")?.trim() ?? "";
+  if (!q) return Response.json([]);
+  const docs = corpus().map((e) => ({ id: e.id, text: e.title + "\\n" + e.text, metadata: { title: e.title, url: e.url } }));
+  const hits = await rerank(q, docs, { method: "bm25", k: 8 });
+  return Response.json(hits.map((h) => ({
+    title: String(h.metadata?.title ?? ""),
+    url: String(h.metadata?.url ?? "#"),
+    snippet: excerpt(h.text.split("\\n").slice(1).join(" "), { length: 140 }),
+  })));
+}
+`;
+var searchBox = () => `"use client";
+import { useState, useEffect, useRef } from "react";
+
+interface Result { title: string; url: string; snippet: string; }
+
+export function Search() {
+  const [q, setQ] = useState("");
+  const [results, setResults] = useState<Result[]>([]);
+  const [open, setOpen] = useState(false);
+  const timer = useRef<ReturnType<typeof setTimeout> | null>(null);
+
+  useEffect(() => {
+    if (timer.current) clearTimeout(timer.current);
+    if (!q.trim()) { setResults([]); return; }
+    timer.current = setTimeout(async () => {
+      const res = await fetch("/api/search?q=" + encodeURIComponent(q));
+      setResults(await res.json());
+      setOpen(true);
+    }, 200);
+    return () => { if (timer.current) clearTimeout(timer.current); };
+  }, [q]);
+
+  return (
+    <div className="relative w-full max-w-md">
+      <input
+        value={q}
+        onChange={(e) => setQ(e.target.value)}
+        onFocus={() => { if (results.length) setOpen(true); }}
+        onBlur={() => setTimeout(() => setOpen(false), 150)}
+        placeholder="Search\u2026"
+        className="w-full rounded-xl border border-hairline bg-surface px-4 py-2 outline-none"
+      />
+      {open && results.length > 0 && (
+        <ul className="absolute z-20 mt-2 w-full overflow-hidden rounded-xl border border-hairline bg-app shadow-lg">
+          {results.map((r) => (
+            <li key={r.url}>
+              <a href={r.url} className="block px-4 py-3 transition hover:bg-surface">
+                <p className="font-medium">{r.title}</p>
+                <p className="mt-0.5 text-sm text-muted">{r.snippet}</p>
+              </a>
+            </li>
+          ))}
+        </ul>
+      )}
+    </div>
+  );
+}
+`;
+var searchPage = () => `import { site } from "@/lib/site";
+import { Search } from "@/components/search";
+
+export const metadata = site.meta({ title: "Search", path: "/search" });
+
+export default function SearchPage() {
+  return (
+    <main className="mx-auto max-w-2xl px-6 py-16">
+      <h1 className="text-3xl font-bold">Search</h1>
+      <p className="mt-2 text-muted">Instant, keyless full-text search over your content.</p>
+      <div className="mt-8"><Search /></div>
+    </main>
+  );
+}
+`;
 var scope = (ctx) => `@${ctx.name}`;
 var typesPkgJson = (ctx) => JSON.stringify({
   name: `${scope(ctx)}/types`,

package/dist/lib.js

@@ -2118,6 +2118,51 @@ var FEATURES = [
       "Run `npm run dev` and open http://localhost:3000/ask."
     ],
     learn: "https://developer.lacspace.com/packages/rag"
+  },
+  {
+    key: "content",
+    label: "Content / blog",
+    description: "A markdown content section (/updates) for any template \u2014 plus an RSS feed and an llms.txt. Drop in .md files, get pages.",
+    deps: {
+      "@lacspace/markdown": "^1.1.0",
+      "@lacspace/rss": "^1.4.0",
+      "@lacspace/llms-txt": "^1.4.0"
+    },
+    files: (ctx) => ({
+      "content/updates/welcome.md": contentSampleWelcome(ctx),
+      "content/updates/building-in-public.md": contentSampleSecond(),
+      "lib/content.ts": contentLib(),
+      "app/updates/page.tsx": updatesListPage(),
+      "app/updates/[slug]/page.tsx": updatePostPage(),
+      "app/feed.xml/route.ts": feedRoute(),
+      "app/llms.txt/route.ts": llmsRoute()
+    }),
+    nextSteps: [
+      "Add markdown files to content/updates/ \u2014 each becomes a page at /updates/<name>.",
+      "Run `npm run dev` and open http://localhost:3000/updates, /feed.xml and /llms.txt.",
+      "Set NEXT_PUBLIC_SITE_URL in .env so the feed and llms.txt links are absolute."
+    ],
+    learn: "https://developer.lacspace.com/packages/markdown"
+  },
+  {
+    key: "search",
+    label: "Search",
+    description: "Instant, keyless full-text search (BM25) over your markdown content \u2014 a search box + /search page + API route. No key, no service.",
+    deps: {
+      "@lacspace/rerank": "^1.0.0",
+      "@lacspace/markdown": "^1.1.0"
+    },
+    files: () => ({
+      "app/api/search/route.ts": searchRoute(),
+      "components/search.tsx": searchBox(),
+      "app/search/page.tsx": searchPage()
+    }),
+    nextSteps: [
+      "Add markdown to content/ (e.g. the `content` add-on's content/updates/) \u2014 search indexes it automatically.",
+      "Run `npm run dev` and open http://localhost:3000/search, or drop <Search /> into your header.",
+      "Want semantic search? Upgrade to @lacspace/embeddings + @lacspace/vector (keyless-local via Ollama)."
+    ],
+    learn: "https://developer.lacspace.com/packages/rerank"
   }
 ];
 var aiChatRoute = (_ctx) => `import { resolveConfig } from "@lacspace/providers";
@@ -5096,6 +5141,278 @@ var faqSection = (ctx) => {
         </div>
       </section>`;
 };
+var contentLib = () => `import fs from "node:fs";
+import path from "node:path";
+import { parseFrontmatter, markdownToHtml, excerpt } from "@lacspace/markdown";
+
+// how this works: every .md file in content/updates/ becomes a post. Frontmatter
+// (title/date/description) is read with @lacspace/markdown; the body is rendered to
+// safe HTML (raw HTML in the source is escaped, so this is XSS-safe by construction).
+const DIR = path.join(process.cwd(), "content/updates");
+
+export interface PostMeta { slug: string; title: string; date: string; description: string; }
+export interface Post extends PostMeta { html: string; }
+
+function read(slug: string): Post | null {
+  const file = path.join(DIR, slug + ".md");
+  if (!fs.existsSync(file)) return null;
+  const { data, content } = parseFrontmatter(fs.readFileSync(file, "utf8"));
+  return {
+    slug,
+    title: String(data.title ?? slug),
+    date: String(data.date ?? ""),
+    description: String(data.description ?? excerpt(content, { length: 160 })),
+    html: markdownToHtml(content, { headingIds: true, openLinksInNewTab: true }),
+  };
+}
+
+export function getAllPosts(): PostMeta[] {
+  if (!fs.existsSync(DIR)) return [];
+  return fs.readdirSync(DIR)
+    .filter((f) => f.endsWith(".md"))
+    .map((f) => read(f.replace(/\\.md$/, ""))!)
+    .filter(Boolean)
+    .sort((a, b) => (a.date < b.date ? 1 : -1));
+}
+
+export function getPost(slug: string): Post | null {
+  return read(slug);
+}
+`;
+var updatesListPage = () => `import Link from "next/link";
+import { site } from "@/lib/site";
+import { getAllPosts } from "@/lib/content";
+
+export const metadata = site.meta({ title: "Updates", path: "/updates" });
+
+export default function UpdatesPage() {
+  const posts = getAllPosts();
+  return (
+    <main className="mx-auto max-w-3xl px-6 py-16">
+      <h1 className="text-3xl font-bold">Updates</h1>
+      <p className="mt-2 text-muted">News, notes and posts. <a href="/feed.xml" className="underline">RSS</a></p>
+      {posts.length === 0 && (
+        <p className="mt-8 text-muted">No posts yet \u2014 add a markdown file in <code>content/updates/</code>.</p>
+      )}
+      <ul className="mt-8 space-y-6">
+        {posts.map((p) => (
+          <li key={p.slug} className="border-b border-hairline pb-6">
+            <Link href={\`/updates/\${p.slug}\`} className="text-xl font-semibold hover:underline">{p.title}</Link>
+            {p.date && <p className="mt-1 text-sm text-muted">{p.date}</p>}
+            <p className="mt-2 text-muted">{p.description}</p>
+          </li>
+        ))}
+      </ul>
+    </main>
+  );
+}
+`;
+var updatePostPage = () => `import Link from "next/link";
+import { notFound } from "next/navigation";
+import { site } from "@/lib/site";
+import { getAllPosts, getPost } from "@/lib/content";
+
+export function generateStaticParams() {
+  return getAllPosts().map((p) => ({ slug: p.slug }));
+}
+
+export async function generateMetadata({ params }: { params: Promise<{ slug: string }> }) {
+  const { slug } = await params;
+  const post = getPost(slug);
+  return site.meta({ title: post?.title ?? "Updates", path: \`/updates/\${slug}\` });
+}
+
+export default async function PostPage({ params }: { params: Promise<{ slug: string }> }) {
+  const { slug } = await params;
+  const post = getPost(slug);
+  if (!post) notFound();
+  return (
+    <main className="mx-auto max-w-2xl px-6 py-16">
+      <Link href="/updates" className="text-sm text-muted hover:underline">\u2190 Updates</Link>
+      <h1 className="mt-4 text-3xl font-bold">{post.title}</h1>
+      {post.date && <p className="mt-1 text-sm text-muted">{post.date}</p>}
+      <article
+        className="mt-8 leading-7 [&_h2]:mt-8 [&_h2]:text-2xl [&_h2]:font-bold [&_h3]:mt-6 [&_h3]:text-xl [&_h3]:font-semibold [&_p]:mt-4 [&_p]:text-muted [&_a]:underline [&_ul]:mt-4 [&_ul]:list-disc [&_ul]:pl-6 [&_li]:mt-1 [&_pre]:mt-4 [&_pre]:overflow-x-auto [&_pre]:rounded-xl [&_pre]:bg-surface [&_pre]:p-4 [&_pre]:text-sm [&_code]:text-sm"
+        dangerouslySetInnerHTML={{ __html: post.html }}
+      />
+    </main>
+  );
+}
+`;
+var feedRoute = () => `import { rssResponse } from "@lacspace/rss";
+import { getAllPosts } from "@/lib/content";
+
+export const dynamic = "force-static";
+
+export function GET() {
+  const base = process.env.NEXT_PUBLIC_SITE_URL ?? "http://localhost:3000";
+  const items = getAllPosts().map((p) => ({
+    title: p.title,
+    link: base + "/updates/" + p.slug,
+    description: p.description,
+    // Only pass a date the feed can parse (rfc822Date throws on bad input).
+    date: p.date && !Number.isNaN(Date.parse(p.date)) ? p.date : undefined,
+  }));
+  return rssResponse(
+    { title: "Updates", link: base, description: "The latest posts and updates.", feedUrl: base + "/feed.xml" },
+    items,
+  );
+}
+`;
+var llmsRoute = () => `import { llmsTxtFromPages } from "@lacspace/llms-txt";
+import { getAllPosts } from "@/lib/content";
+
+export const dynamic = "force-static";
+
+export function GET() {
+  const base = process.env.NEXT_PUBLIC_SITE_URL ?? "http://localhost:3000";
+  const txt = llmsTxtFromPages(
+    getAllPosts().map((p) => ({ title: p.title, url: base + "/updates/" + p.slug, content: p.description, section: "Updates" })),
+    { title: "Updates", summary: "A content index for large language models." },
+  );
+  return new Response(txt, { headers: { "content-type": "text/plain; charset=utf-8" } });
+}
+`;
+var contentSampleWelcome = (ctx) => `---
+title: Welcome to ${ctx.template.siteName}'s content section
+date: 2026-01-15
+description: This markdown file became a page automatically \u2014 here's how it works.
+---
+
+## It just works
+
+Drop any \\\`.md\\\` file into \\\`content/updates/\\\` and it becomes a page at \\\`/updates/<filename>\\\`, listed on \\\`/updates\\\`, and included in \\\`/feed.xml\\\` and \\\`/llms.txt\\\`.
+
+- Frontmatter \\\`title\\\`, \\\`date\\\` and \\\`description\\\` are read automatically.
+- The body is rendered safely with \\\`@lacspace/markdown\\\` \u2014 raw HTML is escaped, so it's XSS-safe.
+- Delete this file when you're ready to write your own.
+`;
+var contentSampleSecond = () => `---
+title: Building in public
+date: 2026-01-10
+description: A second example post so the list and feed have something to show.
+---
+
+## Why a content section?
+
+Every product needs a place for changelog posts, announcements and notes. This one is
+Markdown-powered, needs no database, and ships an RSS feed and an \\\`llms.txt\\\` for free.
+
+### Add your own
+
+1. Create \\\`content/updates/my-post.md\\\`.
+2. Add frontmatter (\\\`title\\\`, \\\`date\\\`, \\\`description\\\`).
+3. Write. That's it \u2014 it appears at \\\`/updates/my-post\\\`.
+`;
+var searchRoute = () => `import fs from "node:fs";
+import path from "node:path";
+import { parseFrontmatter, toPlainText, excerpt } from "@lacspace/markdown";
+import { rerank } from "@lacspace/rerank";
+
+// how this works: full-text search with BM25 ranking \u2014 no external service, no API
+// key, no Ollama. It scans your markdown at request time and ranks matches. (For a
+// big site, precompute the corpus at build time and cache it instead.)
+export const runtime = "nodejs";
+export const dynamic = "force-dynamic";
+
+const ROOT = path.join(process.cwd(), "content");
+// Map a content/<dir>/ to the route it renders under.
+const SECTION: Record<string, string> = { updates: "/updates", posts: "/blog", docs: "/docs" };
+
+interface Entry { id: string; title: string; url: string; text: string; }
+
+function corpus(): Entry[] {
+  if (!fs.existsSync(ROOT)) return [];
+  const out: Entry[] = [];
+  for (const dir of fs.readdirSync(ROOT)) {
+    const full = path.join(ROOT, dir);
+    if (!fs.statSync(full).isDirectory()) continue;
+    const base = SECTION[dir] ?? "/" + dir;
+    for (const file of fs.readdirSync(full)) {
+      if (!file.endsWith(".md")) continue;
+      const slug = file.replace(/\\.md$/, "");
+      const { data, content } = parseFrontmatter(fs.readFileSync(path.join(full, file), "utf8"));
+      out.push({ id: dir + "/" + slug, title: String(data.title ?? slug), url: base + "/" + slug, text: toPlainText(content) });
+    }
+  }
+  return out;
+}
+
+export async function GET(req: Request) {
+  const q = new URL(req.url).searchParams.get("q")?.trim() ?? "";
+  if (!q) return Response.json([]);
+  const docs = corpus().map((e) => ({ id: e.id, text: e.title + "\\n" + e.text, metadata: { title: e.title, url: e.url } }));
+  const hits = await rerank(q, docs, { method: "bm25", k: 8 });
+  return Response.json(hits.map((h) => ({
+    title: String(h.metadata?.title ?? ""),
+    url: String(h.metadata?.url ?? "#"),
+    snippet: excerpt(h.text.split("\\n").slice(1).join(" "), { length: 140 }),
+  })));
+}
+`;
+var searchBox = () => `"use client";
+import { useState, useEffect, useRef } from "react";
+
+interface Result { title: string; url: string; snippet: string; }
+
+export function Search() {
+  const [q, setQ] = useState("");
+  const [results, setResults] = useState<Result[]>([]);
+  const [open, setOpen] = useState(false);
+  const timer = useRef<ReturnType<typeof setTimeout> | null>(null);
+
+  useEffect(() => {
+    if (timer.current) clearTimeout(timer.current);
+    if (!q.trim()) { setResults([]); return; }
+    timer.current = setTimeout(async () => {
+      const res = await fetch("/api/search?q=" + encodeURIComponent(q));
+      setResults(await res.json());
+      setOpen(true);
+    }, 200);
+    return () => { if (timer.current) clearTimeout(timer.current); };
+  }, [q]);
+
+  return (
+    <div className="relative w-full max-w-md">
+      <input
+        value={q}
+        onChange={(e) => setQ(e.target.value)}
+        onFocus={() => { if (results.length) setOpen(true); }}
+        onBlur={() => setTimeout(() => setOpen(false), 150)}
+        placeholder="Search\u2026"
+        className="w-full rounded-xl border border-hairline bg-surface px-4 py-2 outline-none"
+      />
+      {open && results.length > 0 && (
+        <ul className="absolute z-20 mt-2 w-full overflow-hidden rounded-xl border border-hairline bg-app shadow-lg">
+          {results.map((r) => (
+            <li key={r.url}>
+              <a href={r.url} className="block px-4 py-3 transition hover:bg-surface">
+                <p className="font-medium">{r.title}</p>
+                <p className="mt-0.5 text-sm text-muted">{r.snippet}</p>
+              </a>
+            </li>
+          ))}
+        </ul>
+      )}
+    </div>
+  );
+}
+`;
+var searchPage = () => `import { site } from "@/lib/site";
+import { Search } from "@/components/search";
+
+export const metadata = site.meta({ title: "Search", path: "/search" });
+
+export default function SearchPage() {
+  return (
+    <main className="mx-auto max-w-2xl px-6 py-16">
+      <h1 className="text-3xl font-bold">Search</h1>
+      <p className="mt-2 text-muted">Instant, keyless full-text search over your content.</p>
+      <div className="mt-8"><Search /></div>
+    </main>
+  );
+}
+`;
 var scope = (ctx) => `@${ctx.name}`;
 var typesPkgJson = (ctx) => JSON.stringify({
   name: `${scope(ctx)}/types`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-lacspace-app",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "Scaffold a beautiful, production-ready Next.js app from a Lacspace template — portfolio, business, e-commerce, SaaS, blog, docs, dashboard, restaurant or marketplace — pre-wired with SEO, security headers, sitemap and robots. Use it as a CLI (like create-next-app, but you start gorgeous) or import it as a library to generate projects programmatically.",
   "type": "module",
   "bin": {