create-saasicat-admin 0.22.2 → 0.24.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-saasicat-admin",
-  "version": "0.22.2",
+  "version": "0.24.0",
   "description": "Scaffolding CLI for SuperAdmin frontend projects (Vue 3 + Quasar + Vite). Generates a minimal working admin app built on @saasicat/ui-vue. Usage: `pnpm create saasicat-admin <dir>`.",
   "type": "module",
   "bin": {

package/templates/src/main.ts.tpl

@@ -4,7 +4,7 @@ import 'quasar/src/css/index.sass';
 import '@quasar/extras/material-icons/material-icons.css';
 // Platform page styles (sa-* classes + CSS variables). Without it the
 // standard pages render unstyled.
-import '@saasicat/ui-vue/sa-theme.css';
+import '@saasicat/ui-vue/theme.css';
 
 import { createSuperAdminApp } from '@saasicat/ui-vue/quasar';
 import App from './App.vue';
@@ -37,7 +37,7 @@ const handle = createSuperAdminApp({
     extensions: {},
     // Starting UI language — the shell's header switcher lets the user change
     // it from there and remembers the pick. `overrides` replaces individual
-    // strings (handbook §8.6).
+    // strings (handbook §8.7).
     i18n: { locale: 'de' },
 });
 

package/templates/src/styles/theme.scss.tpl

@@ -1,8 +1,30 @@
 // Quasar theme variables — override your branding here.
-$primary: #1e40af;
+//
+// `$primary` is the ONE place your admin's brand colour is decided. SaaSiCat has
+// no palette of its own for it: `--sa-color-accent` reads Quasar's `--q-primary`,
+// which Quasar publishes from this variable. Change it and the hero, the buttons,
+// the focus ring, the tinted surfaces, Quasar's own components and the
+// tenant-facing pages all follow — there is no second switch.
+//
+// The four status colours are NOT read from here, and that is deliberate: each
+// SaaSiCat status tone is a family of six contrast-tuned values (solid, strong,
+// text, two tints, border), and a single Quasar variable cannot say which rung it
+// is — `$warning` is a bright graphic amber, while warning TEXT has to be dark
+// enough to read on it. They are set below to the values the platform's own roles
+// use, so Quasar's components and the admin pages agree out of the box. To change
+// them, override the `--sa-color-<tone>*` roles as a set.
+//
+// The defaults are SaaSiCat's own, so a freshly scaffolded admin looks like the
+// documentation until you decide otherwise.
+// One caveat if you pick a LIGHT brand: text on accent-filled controls is white
+// by default, and CSS cannot work out that white on a light amber is 2.15:1. Set
+// `--sa-color-fg-on-accent` to a dark colour in your own CSS if so — in both
+// themes, like any role.
+$primary: #3f6bff;
 $secondary: #475569;
 $accent: #0ea5e9;
 
-$positive: #16a34a;
+$positive: #047857;
 $negative: #dc2626;
-$warning: #d97706;
+$warning: #f59e0b;
+$info: #2563eb;

package/templates/vite.config.ts.tpl

@@ -13,6 +13,27 @@ export default defineConfig({
             sassVariables: fileURLToPath(new URL('./src/styles/theme.scss', import.meta.url)),
         }),
     ],
+    // Exactly one copy of each of these, always.
+    //
+    // `createSuperAdminApp()` CREATES the router, the Pinia instance and the
+    // Quasar plugin; this app's own pages then consume them through
+    // `useRoute()`, `useRouter()` and store hooks. Those APIs work by module
+    // identity — `provide`/`inject` with a key that is a module-level symbol —
+    // so two copies of the library do not share one, and the lookup silently
+    // returns `undefined`.
+    //
+    // The platform ships its pages as `.vue` SOURCE (decision E3), so their
+    // `import … from 'vue-router'` resolves relative to the platform package,
+    // while this app's own files resolve relative to here. Without dedupe the
+    // bundle ends up with both, and every consumer page that reads a route
+    // param throws `Cannot read properties of undefined (reading 'params')` —
+    // the shell renders, the content area is blank.
+    //
+    // The list is `@saasicat/ui-vue`'s peerDependencies: a peer is precisely a
+    // dependency the host is expected to own exactly one of.
+    resolve: {
+        dedupe: ['vue', 'vue-router', 'pinia', 'quasar'],
+    },
     server: {
         port: __DEV_PORT__,
         proxy: {