create-saasicat-admin 0.2.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,61 @@
+# create-saasicat-admin
+
+Scaffolding CLI for SuperAdmin frontend projects. Generates a runnable
+Vue 3 + Quasar + Vite project that builds on `@saasicat/ui-vue` and ships
+all standard pages.
+
+## Usage
+
+```bash
+pnpm create saasicat-admin <dir> \
+  --project-key notesapp \
+  --brand-name NotesApp \
+  --logo-text NA \
+  --api-base /api/v1/admin
+```
+
+Generates this directory structure:
+
+```
+<dir>/
+├── package.json
+├── vite.config.ts
+├── index.html
+├── tsconfig.json
+├── src/
+│   ├── main.ts                       (calls createSuperAdminApp)
+│   ├── App.vue                       (<router-view />)
+│   ├── services/http.ts              (HTTP client + adminLogin stub)
+│   ├── router/routes.ts              (all standard pages)
+│   └── styles/theme.scss
+└── README.md
+```
+
+Afterwards:
+
+```bash
+cd <dir>
+pnpm install
+pnpm dev   # http://localhost:9100/admin/login
+```
+
+## Options
+
+| Flag             | Default         | Purpose                                            |
+| ---------------- | --------------- | -------------------------------------------------- |
+| `--project-key`  | `app`           | used as prefix in storage keys + tokens            |
+| `--brand-name`   | `App`           | shown in the AdminLayout header                    |
+| `--logo-text`    | `AP`            | two-letter badge in the logo                       |
+| `--api-base`     | `/api/v1/admin` | backend endpoint prefix                            |
+| `--dev-port`     | `9100`          | Vite dev server port                               |
+| `--backend-port` | `3000`          | backend port for the Vite proxy                    |
+| `--no-install`   | false           | only generate files, skip the final `pnpm install` |
+
+## What is left to do afterwards
+
+1. `src/services/http.ts` → adapt `adminLogin()` to your auth flow.
+2. Check the platform dependency versions in `package.json` — the templates
+   reference the `@saasicat/*` packages via semver from npm.
+3. Adapt the Vite proxy in `vite.config.ts` to your backend port.
+
+Everything else comes from `@saasicat/ui-vue`.

package/bin/create.js

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+// `pnpm create saasicat-admin <dir>` — scaffold.
+//
+// Reads all `*.tpl` files from `../templates/`, replaces `__KEY__` tokens, writes
+// into `<dir>/`. Tokens come from argv flags + defaults.
+//
+// Spec: handoff/superadmin/QUICKSTART_SIMPLIFICATIONS.md §P6.
+
+import { fileURLToPath } from 'node:url';
+import { dirname, join, resolve, relative } from 'node:path';
+import { existsSync, readFileSync } from 'node:fs';
+import { mkdir, readdir, readFile, writeFile, stat } from 'node:fs/promises';
+
+// The scaffolded project must depend on the platform packages that match this
+// scaffolder. All packages are released in lockstep, so our own version is the
+// correct range — deriving it here keeps the template from drifting out of
+// date on every release (a hardcoded `^0.1.0` would not match `0.2.0`, because
+// caret pins the minor for 0.x versions).
+const OWN_VERSION = JSON.parse(
+    readFileSync(new URL('../package.json', import.meta.url), 'utf8'),
+).version;
+
+export const DEFAULT_TOKENS = {
+    PROJECT_KEY: 'app',
+    BRAND_NAME: 'App',
+    LOGO_TEXT: 'AP',
+    API_BASE: '/api/v1/admin',
+    DEV_PORT: '9100',
+    BACKEND_PORT: '3000',
+    PLATFORM_VERSION: `^${OWN_VERSION}`,
+};
+
+const TOKEN_FLAGS = {
+    'project-key': 'PROJECT_KEY',
+    'brand-name': 'BRAND_NAME',
+    'logo-text': 'LOGO_TEXT',
+    'api-base': 'API_BASE',
+    'dev-port': 'DEV_PORT',
+    'backend-port': 'BACKEND_PORT',
+};
+
+export function parseArgs(argv) {
+    const positionals = [];
+    const flags = { dryRun: false, noInstall: false };
+    const tokens = { ...DEFAULT_TOKENS };
+    for (const arg of argv) {
+        if (arg === '--dry-run') {
+            flags.dryRun = true;
+            continue;
+        }
+        if (arg === '--no-install') {
+            flags.noInstall = true;
+            continue;
+        }
+        if (arg.startsWith('--')) {
+            const [key, value] = arg.slice(2).split('=');
+            if (TOKEN_FLAGS[key]) {
+                tokens[TOKEN_FLAGS[key]] = value ?? '';
+            }
+            continue;
+        }
+        positionals.push(arg);
+    }
+    return { positionals, flags, tokens };
+}
+
+export function applyTokens(content, tokens) {
+    return content.replace(/__([A-Z_]+)__/g, (full, key) => {
+        const value = tokens[key];
+        return value === undefined ? full : value;
+    });
+}
+
+export async function walkTemplates(root) {
+    const out = [];
+    async function recurse(dir) {
+        const entries = await readdir(dir);
+        for (const entry of entries) {
+            const full = join(dir, entry);
+            const st = await stat(full);
+            if (st.isDirectory()) {
+                await recurse(full);
+            } else if (entry.endsWith('.tpl')) {
+                const rel = relative(root, full).replace(/\.tpl$/, '');
+                out.push({ relPath: rel, absPath: full });
+            }
+        }
+    }
+    await recurse(root);
+    return out.sort((a, b) => a.relPath.localeCompare(b.relPath));
+}
+
+export async function scaffold({ targetDir, templatesDir, tokens, dryRun = false }) {
+    const files = await walkTemplates(templatesDir);
+    // Merge over the defaults so intrinsic tokens (PLATFORM_VERSION) are always
+    // present — a caller passing only the user-facing tokens must not end up
+    // with an unsubstituted dependency range in the generated package.json.
+    const effectiveTokens = { ...DEFAULT_TOKENS, ...tokens };
+    const writes = [];
+    for (const { relPath, absPath } of files) {
+        const raw = await readFile(absPath, 'utf8');
+        const rendered = applyTokens(raw, effectiveTokens);
+        const dest = join(targetDir, relPath);
+        writes.push({ relPath, dest, rendered });
+    }
+    if (dryRun) return writes;
+    await mkdir(targetDir, { recursive: true });
+    for (const w of writes) {
+        await mkdir(dirname(w.dest), { recursive: true });
+        await writeFile(w.dest, w.rendered, 'utf8');
+    }
+    return writes;
+}
+
+async function main() {
+    const argv = process.argv.slice(2);
+    const { positionals, flags, tokens } = parseArgs(argv);
+
+    if (positionals.length === 0 || positionals[0] === '--help' || positionals[0] === '-h') {
+        console.log('Usage: pnpm create saasicat-admin <dir> [flags]');
+        console.log('');
+        console.log('Flags:');
+        console.log('  --project-key=app           storage key prefix');
+        console.log('  --brand-name=App            brand name in the header');
+        console.log('  --logo-text=AP              two-letter badge');
+        console.log('  --api-base=/api/v1/admin    backend prefix');
+        console.log('  --dev-port=9100             Vite port');
+        console.log('  --backend-port=3000         backend port (Vite proxy)');
+        console.log('  --dry-run                   only list what would be created');
+        console.log('  --no-install                stop after generating, skip pnpm install');
+        process.exit(0);
+    }
+
+    const targetDir = resolve(positionals[0]);
+    if (existsSync(targetDir) && !flags.dryRun) {
+        const contents = await readdir(targetDir).catch(() => []);
+        if (contents.length > 0) {
+            console.error(`✗ Target directory ${targetDir} is not empty. Aborting.`);
+            process.exit(1);
+        }
+    }
+
+    const templatesDir = resolve(dirname(fileURLToPath(import.meta.url)), '..', 'templates');
+    if (!existsSync(templatesDir)) {
+        console.error(`✗ Templates not found: ${templatesDir}`);
+        process.exit(99);
+    }
+
+    const writes = await scaffold({
+        targetDir,
+        templatesDir,
+        tokens,
+        dryRun: flags.dryRun,
+    });
+
+    if (flags.dryRun) {
+        console.log(`(--dry-run) Would create in ${targetDir}:`);
+        for (const w of writes) console.log(`    ${w.relPath}`);
+        return;
+    }
+
+    console.log(`✓ Created ${writes.length} file(s) in ${targetDir}`);
+    for (const w of writes) console.log(`    ${w.relPath}`);
+
+    console.log('');
+    console.log('Next steps:');
+    console.log(`  cd ${relative(process.cwd(), targetDir) || '.'}`);
+    console.log('  pnpm install');
+    console.log('  pnpm dev');
+    console.log('');
+    console.log(`Adapt the login adapter (\`src/services/http.ts#adminLogin\`) to your backend.`);
+}
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main().catch((err) => {
+        console.error('✗ ' + (err?.message ?? String(err)));
+        process.exit(99);
+    });
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "create-saasicat-admin",
+  "version": "0.2.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": {
+    "create-saasicat-admin": "./bin/create.js"
+  },
+  "files": [
+    "bin",
+    "templates"
+  ],
+  "devDependencies": {
+    "@types/node": "^25.6.0"
+  },
+  "license": "Apache-2.0",
+  "author": "Taci Uelker",
+  "homepage": "https://github.com/uelker70/saasicat",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/uelker70/saasicat.git",
+    "directory": "packages/create-saasicat-admin"
+  },
+  "bugs": {
+    "url": "https://github.com/uelker70/saasicat/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "node --test tests/**/*.test.js"
+  }
+}

package/templates/README.md.tpl

@@ -0,0 +1,24 @@
+# __BRAND_NAME__ Admin
+
+SuperAdmin frontend for __BRAND_NAME__, generated with
+`create-saasicat-admin`.
+
+## Setup
+
+```bash
+pnpm install
+pnpm dev
+```
+
+Reachable at `http://localhost:__DEV_PORT__/admin/login`.
+
+The backend must listen on `http://localhost:__BACKEND_PORT__` and
+serve `__API_BASE__/manifest`.
+
+## TODO
+
+- Adapt `src/services/http.ts#adminLogin` to your backend auth.
+- Add your own project pages in `src/router/routes.ts` (with
+  `createProjectPageHostRoute()` as a catch-all).
+- Register KPI cards, tenant actions and project pages in your backend
+  manifest (see `docs/saas-platform.md §6.6` in the saasicat repo).

package/templates/index.html.tpl

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="de">
+    <head>
+        <meta charset="UTF-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+        <title>__BRAND_NAME__ SuperAdmin</title>
+    </head>
+    <body>
+        <div id="app"></div>
+        <script type="module" src="/src/main.ts"></script>
+    </body>
+</html>

package/templates/package.json.tpl

@@ -0,0 +1,29 @@
+{
+    "name": "__PROJECT_KEY__-admin",
+    "version": "0.0.1",
+    "private": true,
+    "type": "module",
+    "scripts": {
+        "dev": "vite",
+        "build": "vue-tsc -b && vite build",
+        "preview": "vite preview"
+    },
+    "dependencies": {
+        "@quasar/extras": "^1.16.0",
+        "@saasicat/types": "__PLATFORM_VERSION__",
+        "@saasicat/ui-vue": "__PLATFORM_VERSION__",
+        "axios": "^1.15.0",
+        "pinia": "^3.0.0",
+        "quasar": "^2.18.0",
+        "vue": "^3.5.0",
+        "vue-router": "^4.5.0"
+    },
+    "devDependencies": {
+        "@quasar/vite-plugin": "^1.10.0",
+        "@vitejs/plugin-vue": "^6.0.0",
+        "sass": "^1.83.0",
+        "typescript": "^5.7.0",
+        "vite": "^7.0.0",
+        "vue-tsc": "^2.2.0"
+    }
+}

package/templates/src/App.vue.tpl

@@ -0,0 +1,3 @@
+<template>
+    <router-view />
+</template>

package/templates/src/main.ts.tpl

@@ -0,0 +1,28 @@
+// Bootstrap. createSuperAdminApp erledigt Quasar+Pinia+Router+Guards.
+
+import 'quasar/src/css/index.sass';
+import '@quasar/extras/material-icons/material-icons.css';
+
+import { createSuperAdminApp } from '@saasicat/ui-vue';
+import App from './App.vue';
+import { appRoutes } from './router/routes';
+import { adminLogin, isAuthenticated } from './services/http';
+
+const handle = createSuperAdminApp({
+    rootComponent: App,
+    brand: { logoText: '__LOGO_TEXT__', name: '__BRAND_NAME__' },
+    endpoints: { apiBase: '__API_BASE__' },
+    appRoutes,
+    loginAdapter: { login: adminLogin },
+    authGuard: {
+        isAuthenticated,
+        onUnauthenticated: () => '/login',
+    },
+    manifestGuard: {
+        errorRoute: '/admin-error',
+    },
+    actions: {},
+    extensions: {},
+});
+
+handle.mount('#app');

package/templates/src/router/routes.ts.tpl

@@ -0,0 +1,31 @@
+import type { RouteRecordRaw } from 'vue-router';
+import SuperAdminLoginPage from '@saasicat/ui-vue/pages/SuperAdminLoginPage.vue';
+import AdminLayout from '@saasicat/ui-vue/pages/AdminLayout.vue';
+import AdminManifestErrorPage from '@saasicat/ui-vue/pages/AdminManifestErrorPage.vue';
+import DashboardPage from '@saasicat/ui-vue/pages/DashboardPage.vue';
+import TenantsPage from '@saasicat/ui-vue/pages/TenantsPage.vue';
+import PlansPage from '@saasicat/ui-vue/pages/PlansPage.vue';
+import DiscoveryPage from '@saasicat/ui-vue/pages/DiscoveryPage.vue';
+
+// Standard platform pages. Your own project pages are mounted via
+// `createProjectPageHostRoute()` as a catch-all at the end.
+
+export const appRoutes: RouteRecordRaw[] = [
+    { path: '/login', component: SuperAdminLoginPage, meta: { public: true } },
+    {
+        path: '/admin-error',
+        component: AdminManifestErrorPage,
+        meta: { public: true },
+    },
+    {
+        path: '/admin',
+        component: AdminLayout,
+        children: [
+            { path: '', redirect: '/admin/dashboard' },
+            { path: 'dashboard', component: DashboardPage },
+            { path: 'tenants', component: TenantsPage },
+            { path: 'plans', component: PlansPage },
+            { path: 'discovery', component: DiscoveryPage },
+        ],
+    },
+];

package/templates/src/services/http.ts.tpl

@@ -0,0 +1,59 @@
+// HTTP client + login adapter for `createSuperAdminApp`.
+//
+// TODO: adapt `adminLogin` to your backend auth — POST body and token
+// storage are app-specific.
+
+import axios from 'axios';
+import type { HttpClient, HttpResponse } from '@saasicat/ui-vue';
+
+const TOKEN_KEY = '__PROJECT_KEY__-admin-token';
+
+export const api = axios.create({ baseURL: '/api/v1' });
+api.interceptors.request.use((cfg) => {
+    const t = localStorage.getItem(TOKEN_KEY);
+    if (t) cfg.headers.Authorization = `Bearer ${t}`;
+    return cfg;
+});
+
+export const platformHttp: HttpClient = async (url, init) => {
+    const stripped = url.startsWith('/api/v1') ? url.slice(7) : url;
+    const r = await api.request({
+        url: stripped,
+        method: (init?.method ?? 'GET') as 'GET' | 'POST',
+        headers: init?.headers,
+        data: init?.body,
+        validateStatus: (s) => s < 500,
+    });
+    const res: HttpResponse = {
+        status: r.status,
+        headers: {
+            get: (n) => {
+                const v = r.headers[n.toLowerCase()];
+                return v == null ? null : String(v);
+            },
+        },
+        json: async () => r.data,
+        text: async () =>
+            typeof r.data === 'string' ? r.data : JSON.stringify(r.data),
+    };
+    return res;
+};
+
+export async function adminLogin(email: string, password: string) {
+    try {
+        // TODO: replace the endpoint with your auth backend.
+        const r = await api.post('/auth/admin-login', { email, password });
+        localStorage.setItem(TOKEN_KEY, r.data.token);
+        return { ok: true as const };
+    } catch (e) {
+        const status = (e as { response?: { status?: number } })?.response?.status;
+        return {
+            ok: false as const,
+            code: status === 401 ? 'BAD_CREDENTIALS' : 'unknown',
+        };
+    }
+}
+
+export function isAuthenticated(): boolean {
+    return !!localStorage.getItem(TOKEN_KEY);
+}

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

@@ -0,0 +1,8 @@
+// Quasar theme variables — override your branding here.
+$primary: #1e40af;
+$secondary: #475569;
+$accent: #0ea5e9;
+
+$positive: #16a34a;
+$negative: #dc2626;
+$warning: #d97706;

package/templates/tsconfig.json.tpl

@@ -0,0 +1,17 @@
+{
+    "compilerOptions": {
+        "target": "ES2022",
+        "module": "ESNext",
+        "moduleResolution": "bundler",
+        "strict": true,
+        "lib": ["ES2023", "DOM"],
+        "types": ["vite/client"],
+        "skipLibCheck": true,
+        "jsx": "preserve",
+        "esModuleInterop": true,
+        "isolatedModules": true,
+        "noEmit": true,
+        "useDefineForClassFields": true
+    },
+    "include": ["src"]
+}

package/templates/vite.config.ts.tpl

@@ -0,0 +1,17 @@
+import { defineConfig } from 'vite';
+import vue from '@vitejs/plugin-vue';
+import { quasar } from '@quasar/vite-plugin';
+
+export default defineConfig({
+    base: '/admin/',
+    plugins: [vue(), quasar({ sassVariables: 'src/styles/theme.scss' })],
+    server: {
+        port: __DEV_PORT__,
+        proxy: {
+            '/api': {
+                target: 'http://localhost:__BACKEND_PORT__',
+                changeOrigin: true,
+            },
+        },
+    },
+});