welcome tanstack start

[viqueen]

Summary

Rebuilds the template on TanStack Start and turns it into a content-driven
starter: a landing page and an MDX blog, server-rendered and statically
prerendered. The structure mirrors the sibling labset/startup web/apps/site
app and folds in the practices from the "building this site" post.

What's included

• TanStack Start + Router — file-based routing, an __root.tsx document
  shell, and getRouter(); no index.html. Route files stay thin and point at
  dedicated page components.
• MDX content layer — posts live under src/content/posts/YYYY/MM/*.mdx,
  discovered with import.meta.glob, with meta validated at build time and an
  author registry. (No Shiki, by choice.)
• Static prerendering (SSG) — the whole site is crawled from the homepage to
  HTML (crawlLinks), plus an explicit prerendered /404.
• SEO — socialMeta() OG/Twitter tags + self-referencing canonical links,
  per route. SITE_URL lives in src/lib/site.ts.
• Dark mode — pre-paint inline theme script (no flash) + a system-aware
  toggle backed by useSyncExternalStore.
• Canonical shadcn components — the real base-luma button, card, badge,
  sheet, separator (not hand-rolled), each actually used. Fixes an invalid
  type="button" that hand-rolled anchors were emitting.
• Organised components — grouped by domain (ui/, mdx/, layout/,
  home/, blog/) instead of loose files.
• Docs — README rewritten for the template.

Structure

src/
├── components/{ui,mdx,layout,home,blog}/
├── content/            # posts.ts loader + authors.ts + posts/YYYY/MM/*.mdx
├── providers/theme/    # context, provider, hook
├── lib/                # site.ts (SITE_URL + socialMeta), utils.ts
├── routes/             # __root, index, 404, blog/{index,$slug}
└── router.tsx, index.css, mdx-env.d.ts

Tooling

• src/routeTree.gen.ts is gitignored; build is vite build && tsc -b so the
  tree is generated before the type-check.
• ESLint relaxes react-refresh/only-export-components only for ui/**.

Testing

• pnpm build — passes, prerenders 8 static pages (home, /blog, 3 posts,
  /404, /#features)
• tsc -b — passes
• pnpm lint — passes

Notes

• Set SITE_URL in src/lib/site.ts (currently https://example.com) to
  your deployed origin before shipping — it drives canonical + OG URLs.
• Deploy dist/client/ for a static host.

🤖 Generated with Claude Code