vue-ssr-architecture

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?"