create-fullstack-scaffold 0.1.1 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-fullstack-scaffold",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "type": "module",
   "bin": {
     "create-fullstack-scaffold": "dist/cli/index.js"
@@ -9,6 +9,12 @@
     "dist/cli",
     "template"
   ],
+  "workspaces": [
+    "template",
+    "packages/core",
+    "packages/infrastructure",
+    "packages/domain-plugin"
+  ],
   "publishConfig": {
     "access": "public"
   },
@@ -73,7 +79,12 @@
     "dev:guide": "node --import tsx/esm lint-scripts/dev-guide-generator.ts",
     "ai:context": "node --import tsx/esm lint-scripts/ai-context-generator.ts",
     "validate:template": "npm run typecheck:template && npm run lint:template",
-    "test:template": "cd template && npx vitest run"
+    "test:template": "cd template && npx vitest run",
+    "turbo:build": "turbo build",
+    "turbo:test": "turbo test",
+    "turbo:lint": "turbo lint",
+    "turbo:typecheck": "turbo typecheck",
+    "turbo:all": "turbo lint typecheck test build"
   },
   "dependencies": {
     "@hono/node-server": "^1.14.4",
@@ -86,7 +97,7 @@
     "dotenv": "^16.5.0",
     "drizzle-orm": "^0.45.1",
     "fs-extra": "^11.3.5",
-    "hono": "^4.12.16",
+    "hono": "4.12.16",
     "jsonwebtoken": "^9.0.3",
     "lucide-react": "^0.576.0",
     "ora": "^9.4.0",
@@ -154,12 +165,6 @@
     ],
     "*.{json,md,css}": [
       "prettier --write"
-    ],
-    "src/server/**/*routes*.ts": [
-      "npm run validate:all"
-    ],
-    "src/client/**/*.{ts,tsx}": [
-      "npm run validate:all"
     ]
   },
   "engines": {
@@ -167,5 +172,6 @@
   },
   "overrides": {
     "esbuild": "^0.25.0"
-  }
+  },
+  "packageManager": "npm@11.6.2"
 }

package/template/.husky/pre-commit

@@ -13,7 +13,7 @@ npm run check:refs
 echo "Checking framework modifications..."
 npm run framework:check
 
-npx lint-staged
+npx lint-staged --concurrent false
 
 echo "Running smart tests for changed files..."
 npm run test:smart:staged

package/template/modules.config.ts

@@ -11,7 +11,7 @@ export const TEMPLATE_PRESETS: TemplatePreset[] = [
     id: 'fullstack-admin',
     name: 'Full Admin (Recommended)',
     description:
-      'Complete fullstack app with all modules: todos, chat, notifications, admin panel, RBAC, orders, tickets, disputes, content management, file upload, and CAPTCHA',
+      'Complete fullstack app with all modules: todos, chat, notifications, admin panel, RBAC, auth, plugin marketplace, orders, tickets, disputes, content management, file upload, and CAPTCHA',
     modules: [
       // Core (no dependencies)
       'todos',
@@ -22,6 +22,8 @@ export const TEMPLATE_PRESETS: TemplatePreset[] = [
       // System (permission first, then dependents)
       'permission',
       'admin',
+      'auth',
+      'plugin',
       // Business (all depend on permission)
       'order',
       'ticket',
@@ -33,7 +35,7 @@ export const TEMPLATE_PRESETS: TemplatePreset[] = [
     id: 'todo-app',
     name: 'Todo App',
     description: 'Simple todo app with chat and notifications — great starting point for learning',
-    modules: ['todos', 'chat', 'notifications'],
+    modules: ['todos', 'chat', 'notifications', 'auth'],
   },
   {
     id: 'ecommerce',
@@ -52,6 +54,31 @@ export const TEMPLATE_PRESETS: TemplatePreset[] = [
       'content',
     ],
   },
+  {
+    id: 'xbrowser-marketplace',
+    name: 'Plugin Marketplace',
+    description:
+      'xbrowser plugin marketplace with developer auth, plugin CRUD, reviews, categories, admin management, and CLI support',
+    modules: [
+      'notifications',
+      'file',
+      'captcha',
+      'auth',
+      'permission',
+      'admin',
+      'plugin',
+      'order',
+      'ticket',
+      'dispute',
+      'content',
+    ],
+  },
+  {
+    id: 'cli-only',
+    name: 'CLI Agent',
+    description: 'CLI + Server only, no web client. For AI agent automation — no browser UI needed',
+    modules: ['todos', 'chat', 'notifications', 'auth'],
+  },
   {
     id: 'minimal',
     name: 'Minimal',

package/template/package.json

@@ -8,6 +8,11 @@
   },
   "scripts": {
     "dev": "vite",
+    "dev:todo": "VITE_PRESET=todo vite",
+    "dev:plugin": "VITE_PRESET=plugin vite",
+    "dev:ecommerce": "VITE_PRESET=ecommerce vite",
+    "dev:community": "VITE_PRESET=community vite",
+    "dev:saas": "VITE_PRESET=saas vite",
     "build": "npm run build:client && npm run build:server",
     "build:client": "vite build",
     "build:server": "tsup",
@@ -20,7 +25,7 @@
     "start:dev": "NODE_ENV=development node --import tsx src/server/entries/node.ts",
     "dev:cf": "wrangler dev",
     "deploy:cf": "npm run build:cloudflare && wrangler deploy",
-    "typecheck": "tsc --noEmit && eslint . --max-warnings=0",
+    "typecheck": "tsc --noEmit",
     "test": "vitest",
     "test:smart": "node --import tsx/esm lint-scripts/smart-test.ts",
     "test:smart:staged": "node --import tsx/esm lint-scripts/smart-test.ts --staged",
@@ -48,8 +53,6 @@
     "validate:modules": "npx tsx src/server/core/module-loader.ts",
     "check:refs": "node --import tsx/esm lint-scripts/check-refs.ts",
     "create:module": "node --import tsx/esm scripts/create-template.ts",
-    "postinstall": "patch-package",
-    "prepare": "husky",
     "db:generate": "drizzle-kit generate",
     "db:migrate": "drizzle-kit migrate",
     "db:push": "drizzle-kit push",
@@ -59,19 +62,22 @@
     "framework:check": "node --import tsx/esm lint-scripts/framework/check-modify.ts",
     "dev:context": "node --import tsx/esm lint-scripts/dev-context-analyzer.ts",
     "dev:guide": "node --import tsx/esm lint-scripts/dev-guide-generator.ts",
-    "ai:context": "node --import tsx/esm lint-scripts/ai-context-generator.ts"
+    "ai:context": "node --import tsx/esm lint-scripts/ai-context-generator.ts",
+    "postinstall": "node -e \"process.exit(require('fs').existsSync('node_modules/hono')?0:1)\" && patch-package || true",
+    "prepare": "husky",
+    "typecheck:full": "tsc --noEmit && eslint . --max-warnings=0"
   },
   "dependencies": {
+    "@dyyz1993/xcli-core": "^0.7.4",
     "@hono/node-server": "^1.14.4",
     "@hono/zod-openapi": "1.2.2",
     "@hono/zod-validator": "0.7.6",
     "@libsql/client": "^0.17.0",
     "antd": "^5.24.0",
     "bcryptjs": "^3.0.3",
-    "commander": "^12.0.0",
     "dotenv": "^16.5.0",
     "drizzle-orm": "^0.45.1",
-    "hono": "^4.12.16",
+    "hono": "4.12.16",
     "jsonwebtoken": "^9.0.3",
     "lucide-react": "^0.576.0",
     "pino": "^9.7.0",
@@ -141,12 +147,6 @@
     ],
     "*.{json,md,css}": [
       "prettier --write"
-    ],
-    "src/server/**/*routes*.ts": [
-      "npm run validate:all"
-    ],
-    "src/client/**/*.{ts,tsx}": [
-      "npm run validate:all"
     ]
   },
   "engines": {

package/template/patches/{typescript+5.8.3.patch → typescript+5.9.3.patch}

@@ -1,8 +1,7 @@
 diff --git a/node_modules/typescript/lib/_tsc.js b/node_modules/typescript/lib/_tsc.js
-index ae2f844..7355946 100644
 --- a/node_modules/typescript/lib/_tsc.js
 +++ b/node_modules/typescript/lib/_tsc.js
-@@ -62701,7 +62701,7 @@ function createTypeChecker(host) {
+@@ -63591,7 +63591,7 @@ function createTypeChecker(host) {
      if (!couldContainTypeVariables(type)) {
        return type;
      }
@@ -12,10 +11,9 @@ index ae2f844..7355946 100644
        error(currentNode, Diagnostics.Type_instantiation_is_excessively_deep_and_possibly_infinite);
        return errorType;
 diff --git a/node_modules/typescript/lib/typescript.js b/node_modules/typescript/lib/typescript.js
-index 927ce9..01fcfa 100644
 --- a/node_modules/typescript/lib/typescript.js
 +++ b/node_modules/typescript/lib/typescript.js
-@@ -67311,7 +67311,7 @@ function createTypeChecker(host) {
+@@ -68202,7 +68202,7 @@ function createTypeChecker(host) {
      if (!couldContainTypeVariables(type)) {
        return type;
      }

package/template/playwright.config.ts

@@ -14,7 +14,13 @@ export default defineConfig({
   testDir: './tests/e2e',
   testMatch: '**/*.spec.ts',
   timeout: 30 * 1000,
-  expect: { timeout: 5 * 1000 },
+  expect: {
+    timeout: 5 * 1000,
+    toHaveScreenshot: {
+      maxDiffPixelRatio: 0.1,
+      animations: 'disabled',
+    },
+  },
   forbidOnly: !!process.env.CI,
   retries: process.env.CI ? 2 : 0,
   workers: 3,

package/template/src/admin/App.tsx

@@ -15,7 +15,7 @@ import { DisputesPage } from './pages/DisputesPage'
 import { ContentPage } from './pages/ContentPage'
 import { ProtectedRoute, CaptchaModal } from './components'
 
-export const App: React.FC = () => {
+export const App: React.FC<{ basePath?: string }> = ({ basePath = '/admin' }) => {
   return (
     <ConfigProvider
       theme={{
@@ -24,7 +24,7 @@ export const App: React.FC = () => {
         },
       }}
     >
-      <BrowserRouter basename="/admin">
+      <BrowserRouter basename={basePath}>
         <Routes>
           <Route path="/login" element={<LoginPage />} />
           <Route path="/register" element={<RegisterPage />} />

package/template/src/admin/components/CaptchaModal.tsx

@@ -2,6 +2,7 @@ import { Modal, Input, Button, message } from 'antd'
 import { ReloadOutlined } from '@ant-design/icons'
 import { useState, useEffect } from 'react'
 import { useCaptchaStore } from '../stores/captchaStore'
+import { apiClient } from '../services/apiClient'
 import type { CaptchaResponse } from '@shared/modules/captcha'
 
 export const CaptchaModal: React.FC = () => {
@@ -14,8 +15,8 @@ export const CaptchaModal: React.FC = () => {
   const fetchCaptcha = async () => {
     setRefreshing(true)
     try {
-      const response = await window.fetch('/api/captcha')
-      const result = (await response.json()) as { success: boolean; data?: CaptchaResponse }
+      const response = await apiClient.api.captcha.$get()
+      const result = await response.json()
 
       if (result.success && result.data) {
         setCaptchaData(result.data)
@@ -53,16 +54,13 @@ export const CaptchaModal: React.FC = () => {
 
     setLoading(true)
     try {
-      const response = await window.fetch('/api/verify-captcha', {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({
+      const response = await apiClient.api['verify-captcha'].$post({
+        json: {
           id: captchaData.id,
           code,
-        }),
+        },
       })
-
-      const result = (await response.json()) as { success: boolean; error?: string }
+      const result = await response.json()
 
       if (result.success) {
         message.success('验证成功')

package/template/src/admin/layouts/Header.tsx

@@ -1,7 +1,8 @@
-import { Menu, User, LogOut } from 'lucide-react'
-import { useNavigate } from 'react-router-dom'
-import { Dropdown, Avatar } from 'antd'
+import { MenuFoldOutlined, MenuUnfoldOutlined } from '@ant-design/icons'
+import { Breadcrumb, Select, Avatar, Dropdown, Layout as AntLayout, theme } from 'antd'
 import type { MenuProps } from 'antd'
+import { User, LogOut, Settings } from 'lucide-react'
+import { useNavigate } from 'react-router-dom'
 import { useAdminStore } from '../stores/adminStore'
 import { useAdminNotifications } from '../hooks/useAdminNotifications'
 import { NotificationDrawer, NotificationBell } from '../components/NotificationDrawer'
@@ -9,10 +10,17 @@ import { AccountSwitcher } from '../components/AccountSwitcher'
 import { useEffect, useState } from 'react'
 
 interface HeaderProps {
-  onToggleSidebar: () => void
+  collapsed: boolean
+  onToggle: () => void
 }
 
-export const Header: React.FC<HeaderProps> = ({ onToggleSidebar }) => {
+const ROLE_OPTIONS = [
+  { label: 'Super Admin', value: 'super_admin' },
+  { label: 'Moderator', value: 'moderator' },
+  { label: 'Operator', value: 'operator' },
+]
+
+export const Header: React.FC<HeaderProps> = ({ collapsed, onToggle }) => {
   const navigate = useNavigate()
   const { user, logout } = useAdminStore()
   const [drawerOpen, setDrawerOpen] = useState(false)
@@ -30,7 +38,7 @@ export const Header: React.FC<HeaderProps> = ({ onToggleSidebar }) => {
     navigate('/login')
   }
 
-  const menuItems: MenuProps['items'] = [
+  const userMenuItems: MenuProps['items'] = [
     {
       key: 'profile',
       label: 'Profile',
@@ -39,11 +47,10 @@ export const Header: React.FC<HeaderProps> = ({ onToggleSidebar }) => {
     {
       key: 'settings',
       label: 'Settings',
+      icon: <Settings className="w-4 h-4" />,
       onClick: () => navigate('/settings'),
     },
-    {
-      type: 'divider',
-    },
+    { type: 'divider' },
     {
       key: 'logout',
       label: 'Logout',
@@ -53,31 +60,58 @@ export const Header: React.FC<HeaderProps> = ({ onToggleSidebar }) => {
     },
   ]
 
+  const { token } = theme.useToken()
+
   return (
     <>
-      <header className="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
-        <button
-          onClick={onToggleSidebar}
-          className="p-2 rounded-lg hover:bg-gray-100 transition-colors"
-          data-testid="toggle-sidebar-button"
-        >
-          <Menu className="w-5 h-5 text-gray-600" />
-        </button>
-
+      <AntLayout.Header
+        className="flex items-center justify-between px-6 bg-white border-b border-gray-200"
+        style={{
+          paddingInline: 24,
+          height: 64,
+          lineHeight: '64px',
+          backgroundColor: token.colorBgContainer,
+          borderBottom: `1px solid ${token.colorBorderSecondary}`,
+        }}
+        data-testid="admin-header"
+      >
         <div className="flex items-center gap-4">
+          <button
+            onClick={onToggle}
+            className="p-2 rounded-lg hover:bg-gray-100 transition-colors cursor-pointer border-none bg-transparent"
+            data-testid="toggle-sidebar-button"
+          >
+            {collapsed ? <MenuUnfoldOutlined /> : <MenuFoldOutlined />}
+          </button>
+
+          <Breadcrumb
+            items={[{ title: 'Home' }, { title: 'Dashboard' }]}
+            style={{ fontSize: 14 }}
+          />
+        </div>
+
+        <div className="flex items-center gap-3">
+          <Select
+            size="small"
+            defaultValue="super_admin"
+            options={ROLE_OPTIONS}
+            style={{ width: 130 }}
+            data-testid="role-switcher"
+          />
+
           <NotificationBell unreadCount={unreadCount} onClick={() => setDrawerOpen(true)} />
           <AccountSwitcher />
-          <Dropdown menu={{ items: menuItems }} placement="bottomRight" trigger={['click']}>
-            <button className="flex items-center gap-2 p-2 rounded-lg hover:bg-gray-100 transition-colors cursor-pointer">
+          <Dropdown menu={{ items: userMenuItems }} placement="bottomRight" trigger={['click']}>
+            <button className="flex items-center gap-2 p-1.5 rounded-lg hover:bg-gray-100 transition-colors cursor-pointer border-none bg-transparent">
               <Avatar
-                size="small"
+                size={32}
                 src={user?.avatar}
                 icon={!user?.avatar && <User className="w-4 h-4" />}
               />
             </button>
           </Dropdown>
         </div>
-      </header>
+      </AntLayout.Header>
 
       <NotificationDrawer
         open={drawerOpen}

package/template/src/admin/layouts/Layout.tsx

@@ -1,4 +1,5 @@
 import { ReactNode, useState } from 'react'
+import { Layout as AntLayout } from 'antd'
 import { Sidebar } from './Sidebar'
 import { Header } from './Header'
 
@@ -7,17 +8,21 @@ interface LayoutProps {
 }
 
 export const Layout: React.FC<LayoutProps> = ({ children }) => {
-  const [sidebarOpen, setSidebarOpen] = useState(true)
+  const [collapsed, setCollapsed] = useState(false)
 
   return (
-    <div className="flex h-screen bg-gray-100">
-      <Sidebar isOpen={sidebarOpen} />
-      <div className="flex-1 flex flex-col overflow-hidden">
-        <Header onToggleSidebar={() => setSidebarOpen(!sidebarOpen)} />
-        <main className="flex-1 overflow-y-auto p-6" data-testid="admin-main">
+    <AntLayout className="min-h-screen" data-testid="admin-layout">
+      <Sidebar collapsed={collapsed} onCollapse={setCollapsed} />
+      <AntLayout>
+        <Header collapsed={collapsed} onToggle={() => setCollapsed(!collapsed)} />
+        <AntLayout.Content
+          className="m-6 p-6 bg-white rounded-lg shadow-sm"
+          style={{ minHeight: 'calc(100vh - 64px - 48px)' }}
+          data-testid="admin-main"
+        >
           {children}
-        </main>
-      </div>
-    </div>
+        </AntLayout.Content>
+      </AntLayout>
+    </AntLayout>
   )
 }