Captures hard-won lessons from forking the first site (chateau du
faune) off this boilerplate so future sessions don't relitigate them:
- Default to shadcn-vue primitives over hand-rolled UI. Lists the
installed family (Button, Card, Badge, NavigationMenu, Sheet, Alert)
and the as-child pattern for wrapping RouterLink / anchor.
- Prefer semantic theme tokens (bg-background, text-foreground,
border-border, …) over colour literals so site retheming is one
CSS variable edit instead of a global class sweep.
- Document the shadcn-vue CLI / nix-corepack conflict and the
registry-JSON workaround.
- Two consistent fixes when mirroring from the registry: lucide
imports (lucide-vue-next → @lucide/vue) and Tailwind v4 CSS
variable wrapping (h-[--name] → h-[var(--name)]), the latter
filed upstream as unovue/shadcn-vue#1853.
- tsconfig + components.json setup for when the CLI does work
(baseUrl + paths in both tsconfigs, ignoreDeprecations 6.0, no
framework key, no empty tailwind.config).
- Asset / hero / frosted-glass nav patterns we use and reuse.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
