What problem does it solve?
It prevents confusion and inconsistent implementation by giving a single architecture source of truth for how this Vue SSR starter kit is structured, routed, rendered, and extended.
Core Features & Use Cases
- SSR architecture guidance: Explains the server request lifecycle from
server.js through entry-server.js with renderToString, plus what the client does in entry-client.js.
- Locale-prefixed routing conventions: Documents the
/:locale(en|fr)/ route model, how router.js composes localeRoutes, and how useLocalePath() and switchLocale() are expected to be used.
- Layout and naming patterns: Clarifies when to use
public vs minimal vs app layouts, plus conventions for views, components, stores, composables, and SCSS co-location.
- Shared utilities and API endpoint patterns: Provides a catalog of shared modules (db/email/security/api) and a repeatable
setupXRoute(app/router, db) endpoint registration pattern.
- Environment and SSR gotchas: Centralizes the required env vars and common pitfalls (Vuetify SSR behavior, SCSS auto-injection, Helmet CSP being production-conditional).
Quick Start
Ask: "Where should I add a new API endpoint and which file should I edit to wire it into the locale-prefixed SSR routing?"
