@ai-partner-x/aiko-boot-cli 0.1.4

package/templates/scaffold-default/README.md

@@ -0,0 +1,114 @@
+# Scaffold Monorepo
+
+多项目 monorepo 脚手架，包含 **api**、**admin**、**mobile**、**shared**、**core**（鉴权等通用能力）。
+
+## 快速启动
+
+```bash
+# 1. 进入 scaffold 目录
+cd <your-project>
+
+# 2. 安装依赖（首次或依赖变更后）
+pnpm install
+
+# 3. 初始化数据库（首次）
+pnpm init-db
+
+# 4. 启动 API 服务
+pnpm dev:api
+```
+
+**启动成功后访问：**
+- API 服务: http://localhost:3001
+- API 文档: http://localhost:3001/api
+
+**测试登录：**
+```bash
+curl -X POST http://localhost:3001/api/auth/login \
+  -H "Content-Type: application/json" \
+  -d '{"username":"admin","password":"admin123"}'
+```
+
+## 目录结构
+
+```
+<your-project>/
+├── packages/
+│   ├── api          # 后端 API（aiko-boot，当前实现用户登录）
+│   ├── shared       # 公共常量（API 基地址、存储 key 等）
+│   ├── core         # 通用能力（鉴权 appAuth、defaultAuthProvider、路由中间件等）
+│   ├── admin        # 管理端（Vite + React，鉴权由 @scaffold/core 提供）
+│   └── mobile       # 移动端 H5（Vite + React，鉴权由 @scaffold/core 提供）
+└── package.json
+```
+
+## 只运行这一个项目
+
+可以。scaffold 依赖仓库内的 `@ai-partner-x/*` 等包，因此需要在 **ai-frist-framework 仓库内** 使用，但日常只需操作 scaffold 本身：
+
+1. 在仓库根 **执行一次** `pnpm install`（或进入 scaffold 后执行 `pnpm install`）。
+2. 之后所有开发、构建、启动都在 **scaffold 目录** 下完成，无需运行或构建仓库里其他项目（如 user-crud、其他 examples）。
+
+```bash
+cd <your-project>
+pnpm init-db    # 首次
+pnpm dev        # 并行启动 api + admin + mobile
+```
+
+**测试登录**：mobile / admin 使用 **@scaffold/core** 的 `appAuth` + `defaultAuthProvider`，当前为本地演示（localStorage）；接入真实 API 时替换为自定义 AuthProviderConfig（脚手架不再生成 docs 站点，相关设计请参考框架文档或 `packages/core` 源码）。
+
+## 前置
+
+- Node 18+
+- pnpm
+
+**安装依赖**（在仓库根或 scaffold 目录下执行均可，会使用仓库根 workspace）：
+
+```bash
+cd /path/to/ai-frist-framework
+pnpm install
+# 或在 scaffold 目录下
+cd <your-project> && pnpm install
+```
+
+`init-db` 使用纯 JS 的 sql.js，无需编译。**运行 API 服务**（`pnpm dev:api`）时依赖 better-sqlite3 原生模块；若报错找不到 bindings，在**仓库根**执行（会进入 better-sqlite3 目录执行 `node-gyp rebuild`）：
+
+```bash
+pnpm run rebuild:sqlite
+```
+
+## 开发
+
+依赖在仓库根安装完成后，在 **scaffold 目录** 下执行：
+
+```bash
+cd <your-project>
+pnpm init-db    # 首次运行：初始化 SQLite 数据库
+pnpm dev        # 并行启动 api + admin + mobile
+```
+
+或分别启动：
+
+- `pnpm dev:api`    — API 默认 http://localhost:3001
+- `pnpm dev:admin`  — Admin 管理端（留空）
+- `pnpm dev:mobile` — Mobile 默认 http://localhost:3002
+
+**API 热更新**（与 user-crud 一致）：`pnpm dev:api` 会同时跑 **codegen watch** 与 **HTTP 服务**。修改 `entity/`、`dto/`、`controller/` 后会自动重新生成 `dist/client`，前端可即时引用新类型与接口；改 `src/server.ts` 会触发服务重启。
+
+## 构建
+
+```bash
+pnpm build
+# 或
+pnpm build:api
+pnpm build:admin
+pnpm build:mobile
+```
+
+## API 说明
+
+- **POST /api/auth/login**  
+  请求体：`{ "username": "admin", "password": "admin123" }`  
+  成功返回：`{ "success": true, "data": { "id", "username", "email" } }`
+
+默认测试账号（见 `packages/api` 的 init-db）：`admin` / `admin123`。

package/templates/scaffold-default/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "scaffold-monorepo",
+  "version": "0.1.0",
+  "private": true,
+  "pnpm": {
+    "onlyBuiltDependencies": ["better-sqlite3"]
+  },
+  "scripts": {
+    "dev": "pnpm -r --parallel --filter \"@scaffold/*\" dev",
+    "dev:api": "pnpm -F @scaffold/api dev",
+    "dev:admin": "pnpm -F @scaffold/admin dev",
+    "dev:mobile": "pnpm -F @scaffold/mobile dev",
+    "build": "pnpm -r --filter \"@scaffold/*\" build",
+    "build:api": "pnpm -F @scaffold/api build",
+    "build:admin": "pnpm -F @scaffold/admin build",
+    "build:mobile": "pnpm -F @scaffold/mobile build",
+    "start:api": "pnpm -F @scaffold/api start",
+    "init-db": "pnpm -F @scaffold/api init-db",
+    "rebuild:sqlite": "node ./scripts/rebuild-sqlite.cjs",
+    "lint": "pnpm -r --filter \"@scaffold/*\" lint"
+  },
+  "postinstall": "node ./scripts/postinstall.cjs",
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  }
+}

package/templates/scaffold-default/packages/admin/.env.dev

@@ -0,0 +1 @@
+VITE_APP_LOGIN=/login

package/templates/scaffold-default/packages/admin/.env.prod

@@ -0,0 +1,4 @@
+NODE_ENV=production
+
+# oauth - 配置为后端登录地址
+VITE_APP_LOGIN=http://localhost:3000/login

package/templates/scaffold-default/packages/admin/.env.stage

@@ -0,0 +1,4 @@
+NODE_ENV=production
+
+# oauth - 配置为后端登录地址
+VITE_APP_LOGIN=http://localhost:3000/login

package/templates/scaffold-default/packages/admin/Dockerfile

@@ -0,0 +1,37 @@
+# This Dockerfile uses `serve` npm package to serve the static files with node process.
+# You can find the Dockerfile for nginx in the following link:
+# https://github.com/refinedev/dockerfiles/blob/main/vite/Dockerfile.nginx
+FROM refinedev/node:18 AS base
+
+FROM base as deps
+
+COPY package.json yarn.lock* package-lock.json* pnpm-lock.yaml* .npmrc* ./
+
+RUN \
+  if [ -f yarn.lock ]; then yarn --frozen-lockfile; \
+  elif [ -f package-lock.json ]; then npm ci; \
+  elif [ -f pnpm-lock.yaml ]; then yarn global add pnpm && pnpm i --frozen-lockfile; \
+  else echo "Lockfile not found." && exit 1; \
+  fi
+
+FROM base as builder
+
+ENV NODE_ENV production
+
+COPY --from=deps /app/refine/node_modules ./node_modules
+
+COPY . .
+
+RUN npm run build
+
+FROM base as runner
+
+ENV NODE_ENV production
+
+RUN npm install -g serve
+
+COPY --from=builder /app/refine/dist ./
+
+USER refine
+
+CMD ["serve"]

package/templates/scaffold-default/packages/admin/README.MD

@@ -0,0 +1,27 @@
+# admin
+
+## Getting Started
+
+A React Framework for building internal tools, admin panels, dashboards & B2B apps with unmatched flexibility ✨
+
+
+## Available Scripts
+
+### Running the development server.
+
+```bash
+    pnpm dev
+```
+
+### Building for production.
+
+```bash
+    pnpm build
+```
+
+### Running the production server.
+
+```bash
+    pnpm start
+```
+

package/templates/scaffold-default/packages/admin/components.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "new-york",
+  "rsc": false,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "src/App.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  },
+  "iconLibrary": "lucide"
+}

package/templates/scaffold-default/packages/admin/eslint.config.js

@@ -0,0 +1,28 @@
+import js from "@eslint/js";
+import reactHooks from "eslint-plugin-react-hooks";
+import reactRefresh from "eslint-plugin-react-refresh";
+import globals from "globals";
+import tseslint from "typescript-eslint";
+
+export default tseslint.config(
+  { ignores: ["dist"] },
+  {
+    extends: [js.configs.recommended, ...tseslint.configs.recommended],
+    files: ["**/*.{ts,tsx}"],
+    languageOptions: {
+      ecmaVersion: 2020,
+      globals: globals.browser,
+    },
+    plugins: {
+      "react-hooks": reactHooks,
+      "react-refresh": reactRefresh,
+    },
+    rules: {
+      ...reactHooks.configs.recommended.rules,
+      "react-refresh/only-export-components": [
+        "warn",
+        { allowConstantExport: true },
+      ],
+    },
+  }
+);

package/templates/scaffold-default/packages/admin/index.html

@@ -0,0 +1,50 @@
+<!DOCTYPE html>
+<html lang="zh">
+  <head>
+    <meta charset="utf-8" />
+    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="description" content="Admin application" />
+    <title>Admin</title>
+  </head>
+  <body>
+    <script>
+      (function () {
+        var key = "app-theme";
+        try {
+          var raw = localStorage.getItem(key);
+          if (raw) {
+            var doc = document.documentElement;
+            if (["light", "dark", "system"].indexOf(raw) !== -1) {
+              var appearance = raw === "system"
+                ? (window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light")
+                : raw;
+              doc.classList.add(appearance);
+            } else {
+              var parsed = JSON.parse(raw);
+              var appearance = parsed.appearance === "system"
+                ? (window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light")
+                : (parsed.appearance || "light");
+              var palette = parsed.palette || "fiori";
+              doc.classList.add(appearance);
+              doc.setAttribute("data-palette", palette);
+            }
+          }
+        } catch (e) {}
+      })();
+    </script>
+    <noscript>You need to enable JavaScript to run this app.</noscript>
+    <div id="root"></div>
+    <script type="module" src="/src/index.tsx"></script>
+    <!--
+      This HTML file is a template.
+      If you open it directly in the browser, you will see an empty page.
+
+      You can add webfonts, meta tags, or analytics to this file.
+      The build step will place the bundled scripts into the <body> tag.
+
+      To begin the development, run `npm dev` or `yarn start`.
+      To create a production bundle, use `npm run build` or `yarn build`.
+    -->
+  </body>
+</html>

package/templates/scaffold-default/packages/admin/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "@scaffold/admin",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build --mode prod",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@scaffold/api": "workspace:*",
+    "@scaffold/core": "workspace:*",
+    "@hookform/resolvers": "^5.0.1",
+    "@radix-ui/react-accordion": "^1.2.8",
+    "@radix-ui/react-alert-dialog": "^1.1.11",
+    "@radix-ui/react-aspect-ratio": "^1.1.4",
+    "@radix-ui/react-avatar": "^1.1.7",
+    "@radix-ui/react-checkbox": "^1.2.3",
+    "@radix-ui/react-collapsible": "^1.1.8",
+    "@radix-ui/react-context-menu": "^2.2.12",
+    "@radix-ui/react-dialog": "^1.1.11",
+    "@radix-ui/react-dropdown-menu": "^2.1.12",
+    "@radix-ui/react-hover-card": "^1.1.11",
+    "@radix-ui/react-label": "^2.1.4",
+    "@radix-ui/react-menubar": "^1.1.12",
+    "@radix-ui/react-navigation-menu": "^1.2.10",
+    "@radix-ui/react-popover": "^1.1.11",
+    "@radix-ui/react-progress": "^1.1.4",
+    "@radix-ui/react-radio-group": "^1.3.4",
+    "@radix-ui/react-scroll-area": "^1.2.6",
+    "@radix-ui/react-select": "^2.2.2",
+    "@radix-ui/react-separator": "^1.1.4",
+    "@radix-ui/react-slider": "^1.3.2",
+    "@radix-ui/react-slot": "^1.2.0",
+    "@radix-ui/react-switch": "^1.2.2",
+    "@radix-ui/react-tabs": "^1.1.9",
+    "@radix-ui/react-toggle": "^1.1.6",
+    "@radix-ui/react-toggle-group": "^1.1.7",
+    "@radix-ui/react-tooltip": "^1.2.4",
+    "@tailwindcss/vite": "^4.1.8",
+    "@tanstack/react-table": "^8.2.6",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "cmdk": "^1.1.1",
+    "date-fns": "^4.1.0",
+    "dayjs": "^1.10.7",
+    "embla-carousel-react": "^8.6.0",
+    "i18next": "^24.2.0",
+    "input-otp": "^1.4.2",
+    "lucide-react": "^0.487.0",
+    "next-themes": "^0.4.6",
+    "postcss": "^8.5.3",
+    "react": "19.1.0",
+    "react-day-picker": "8.10.1",
+    "react-dom": "19.1.0",
+    "react-hook-form": "^7.57.0",
+    "react-i18next": "^15.1.0",
+    "react-resizable-panels": "^2.1.8",
+    "react-router": "^7.0.2",
+    "recharts": "^2.15.3",
+    "shadcn": "^2.4.1",
+    "sonner": "^2.0.3",
+    "swr": "^2.4.1",
+    "tailwind-merge": "^3.2.0",
+    "tw-animate-css": "^1.2.5",
+    "vaul": "^1.1.2",
+    "zod": "^3.24.3"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.25.0",
+    "@tailwindcss/postcss": "^4.1.4",
+    "@types/node": "^20",
+    "@types/react": "^19.1.0",
+    "@types/react-dom": "^19.1.0",
+    "@typescript-eslint/eslint-plugin": "^5.57.1",
+    "@typescript-eslint/parser": "^5.57.1",
+    "@vitejs/plugin-react": "^4.4.1",
+    "eslint": "^9.25.0",
+    "eslint-plugin-react-hooks": "^5.2.0",
+    "eslint-plugin-react-refresh": "^0.4.19",
+    "globals": "^16.0.0",
+    "tailwindcss": "^4.1.4",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.30.1",
+    "vite": "^6.3.5"
+  },
+  "browserslist": {
+    "production": [
+      ">0.2%",
+      "not dead",
+      "not op_mini all"
+    ],
+    "development": [
+      "last 1 chrome version",
+      "last 1 firefox version",
+      "last 1 safari version"
+    ]
+  }
+}

package/templates/scaffold-default/packages/admin/public/vite.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>

package/templates/scaffold-default/packages/admin/src/App.css

@@ -0,0 +1,82 @@
+@import "tailwindcss";
+@import "tw-animate-css";
+
+@custom-variant dark (&:is(.dark *));
+
+@theme inline {
+  /* 紧凑布局：基准间距与圆角（可调 --compact-spacing、--radius 控制整体松紧） */
+  --spacing: var(--compact-spacing, 0.2rem);
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --font-sans: var(--font-geist-sans);
+  --font-mono: var(--font-geist-mono);
+  --color-sidebar-ring: var(--sidebar-ring);
+  --color-sidebar-border: var(--sidebar-border);
+  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
+  --color-sidebar-accent: var(--sidebar-accent);
+  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);
+  --color-sidebar-primary: var(--sidebar-primary);
+  --color-sidebar-foreground: var(--sidebar-foreground);
+  --color-sidebar: var(--sidebar);
+  --color-chart-5: var(--chart-5);
+  --color-chart-4: var(--chart-4);
+  --color-chart-3: var(--chart-3);
+  --color-chart-2: var(--chart-2);
+  --color-chart-1: var(--chart-1);
+  --color-ring: var(--ring);
+  --color-input: var(--input);
+  --color-border: var(--border);
+  --color-destructive: var(--destructive);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-accent: var(--accent);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-muted: var(--muted);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-secondary: var(--secondary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-primary: var(--primary);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-popover: var(--popover);
+  --color-card-foreground: var(--card-foreground);
+  --color-card: var(--card);
+  --radius-sm: calc(var(--radius) - 2px);
+  --radius-md: calc(var(--radius) - 1px);
+  --radius-lg: var(--radius);
+  --radius-xl: calc(var(--radius) + 2px);
+
+  --font-sans: "Inter", sans-serif;
+}
+
+:root {
+  /* 基准圆角（紧凑：0.25rem，默认可改为 0.325rem） */
+  --radius: 0.3rem;
+  /* 基准间距单位，Tailwind 间距 = 该值 × 数字（0.2rem 比默认 0.25rem 约小 20%） */
+  --compact-spacing: 0.25rem;
+}
+
+/* Theme palettes (src/theme/*.css) */
+@import "./theme/index.css";
+
+/* 确保 light/dark 下根节点与 body 使用主题背景色，修复 dark 模式背景不正确 */
+html.light,
+html.dark {
+  background-color: var(--background);
+}
+
+@layer base {
+
+  /* 紧凑：基准字号 14px，使所有 rem 比例缩小（1rem=14px），可改为 15px/16px 放宽 */
+  html {
+    font-size: 16px;
+  }
+
+  * {
+    @apply border-border outline-ring/50 antialiased;
+    font-family: var(--font-sans);
+  }
+
+  body {
+    @apply bg-background text-foreground;
+    min-height: 100vh;
+  }
+}

package/templates/scaffold-default/packages/admin/src/App.tsx

@@ -0,0 +1,128 @@
+import { useEffect, useState } from "react"
+import {
+  Navigate,
+  RouterProvider,
+  createBrowserRouter,
+  type RouteObject,
+} from "react-router"
+import { useTranslation } from "react-i18next"
+import { AppConfigProvider } from "./providers/app-config"
+
+import { ThemeProvider } from "./components/admin-ui/theme/theme-provider"
+import { Toaster } from "./components/admin-ui/notification/toaster"
+import { MenuLayout } from "./layouts/menu-layout"
+import { TileLayout } from "./layouts/tile-layout"
+import { HomePage } from "./pages/home-page"
+import { getModulesContext } from "./routes"
+import "./App.css"
+import { SignInForm } from "./components/admin-ui/form/sign-in-form"
+import { appAuth } from "@scaffold/core"
+import { AuthorizationProvider, setAppAuthorizationConfig } from "@scaffold/core"
+import { ErrorComponent } from "./components/admin-ui/layout/error-component"
+import { LOGIN_URL } from "./app.config"
+
+const LAYOUT_STORAGE_KEY = "admin-layout-mode"
+const authorizationConfig = { fallbackUrl: "/not-found" } as const
+
+const defaultTitleIcon = (
+  <svg
+    xmlns="http://www.w3.org/2000/svg"
+    width="24"
+    height="24"
+    viewBox="0 0 24 24"
+    fill="none"
+    stroke="currentColor"
+    strokeWidth="2"
+    strokeLinecap="round"
+    strokeLinejoin="round"
+  >
+    <path d="M3 9l9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z" />
+  </svg>
+)
+
+/** 登录页：根据 auth state 同步渲染，已登录则重定向到首页 */
+function LoginPageRoute() {
+  const result = appAuth.check()
+  if (result.isAuthenticated) {
+    return <Navigate to="/" replace />
+  }
+  return <SignInForm />
+}
+
+/** 根布局：负责 layoutMode 与基础布局切换（菜单 / Tile） */
+function RootLayout() {
+  const [layoutMode, setLayoutMode] = useState<"menu" | "tile">(() => {
+    const saved = localStorage.getItem(LAYOUT_STORAGE_KEY)
+    return (saved === "menu" || saved === "tile" ? saved : "tile") as "menu" | "tile"
+  })
+
+  useEffect(() => {
+    localStorage.setItem(LAYOUT_STORAGE_KEY, layoutMode)
+  }, [layoutMode])
+
+  const handleLayoutModeChange = (mode: "menu" | "tile") => {
+    setLayoutMode(mode)
+  }
+
+  const LayoutWrapper =
+    layoutMode === "menu" ? (
+      <MenuLayout onLayoutModeChange={handleLayoutModeChange} />
+    ) : (
+      <TileLayout onLayoutModeChange={handleLayoutModeChange} />
+    )
+
+  return (
+    <>
+      {LayoutWrapper}
+    </>
+  )
+}
+
+
+function AppShell() {
+  const { t } = useTranslation()
+  const { routes, middlewares } = getModulesContext()
+  const appRoutes: RouteObject[] = [
+    {
+      path: "/",
+      element: <RootLayout />,
+      children: [
+        { index: true, middleware: [middlewares[0]], element: <HomePage /> } as RouteObject,
+        ...(routes as RouteObject[]),
+        { path: "*", element: <ErrorComponent /> },
+      ],
+    },
+  ]
+
+  // When LOGIN_URL is an internal path (e.g. "/login"), we register a local login route.
+  // For external login URLs (e.g. SSO like "https://sso.example.com/login"), routing is handled outside this app.
+  const isExternalLogin = LOGIN_URL.startsWith("http")
+
+  if (!isExternalLogin) {
+    appRoutes.unshift({
+      path: LOGIN_URL,
+      element: <LoginPageRoute />,
+    })
+  }
+
+  const router = createBrowserRouter(appRoutes)
+  useEffect(() => {
+    setAppAuthorizationConfig(authorizationConfig)
+  }, [])
+  return (
+    <ThemeProvider>
+      <AppConfigProvider
+        title={{ icon: defaultTitleIcon, text: t("common.appTitle") }}
+      >
+        <AuthorizationProvider>
+          <RouterProvider router={router} />
+        </AuthorizationProvider>
+        <Toaster />
+      </AppConfigProvider>
+    </ThemeProvider>
+  )
+}
+
+export default function App() {
+  return <AppShell />
+}

package/templates/scaffold-default/packages/admin/src/app.config.ts

@@ -0,0 +1,3 @@
+export const LOGIN_URL = import.meta.env.VITE_APP_LOGIN ?? "/login"
+
+export const USE_GUARD = import.meta.env.VITE_APP_USE_GUARD === "true"