@lambertkeith/spec-go 0.2.4

package/templates/fastapi/pyproject.toml

@@ -0,0 +1,21 @@
+[project]
+name = "{{projectName}}"
+version = "0.1.0"
+description = "FastAPI project"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "fastapi>=0.115.0",
+    "uvicorn[standard]>=0.34.0",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.uv]
+dev-dependencies = [
+    "pytest>=8.0.0",
+    "httpx>=0.27.0",
+    "ruff>=0.8.0",
+]

package/templates/fastapi/src/project_name/__init__.py

@@ -0,0 +1 @@
+"""{{projectName}} - FastAPI application"""

package/templates/fastapi/src/project_name/main.py

@@ -0,0 +1,20 @@
+from fastapi import FastAPI
+from .routes import router
+
+app = FastAPI(
+    title="{{projectName}}",
+    description="FastAPI application",
+    version="0.1.0"
+)
+
+app.include_router(router, prefix="/api")
+
+
+@app.get("/")
+async def root():
+    return {"message": "Welcome to {{projectName}}"}
+
+
+@app.get("/health")
+async def health():
+    return {"status": "ok"}

package/templates/fastapi/src/project_name/routes/__init__.py

@@ -0,0 +1,8 @@
+from fastapi import APIRouter
+
+router = APIRouter()
+
+
+@router.get("/hello")
+async def hello():
+    return {"message": "Hello, World!"}

package/templates/flask/README.md

@@ -0,0 +1,15 @@
+# {{projectName}}
+
+Flask 项目
+
+## 开发
+
+```bash
+uv run flask --app src/{{projectName}}/app run --debug
+```
+
+## 测试
+
+```bash
+uv run pytest
+```

package/templates/flask/_gitignore

@@ -0,0 +1,17 @@
+__pycache__/
+*.py[cod]
+*$py.class
+.Python
+.venv/
+venv/
+env/
+.env
+.env.local
+*.egg-info/
+dist/
+build/
+.pytest_cache/
+.ruff_cache/
+.DS_Store
+*.log
+instance/

package/templates/flask/_template.json

@@ -0,0 +1,14 @@
+{
+  "description": "Flask 项目模板",
+  "packageManager": "uv",
+  "postInit": [
+    {
+      "command": "uv sync",
+      "description": "安装依赖"
+    }
+  ],
+  "fileRenames": {
+    "_gitignore": ".gitignore",
+    "project_name": "{{projectName}}"
+  }
+}

package/templates/flask/pyproject.toml

@@ -0,0 +1,19 @@
+[project]
+name = "{{projectName}}"
+version = "0.1.0"
+description = "Flask project"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "flask>=3.0.0",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.uv]
+dev-dependencies = [
+    "pytest>=8.0.0",
+    "ruff>=0.8.0",
+]

package/templates/flask/src/project_name/__init__.py

@@ -0,0 +1 @@
+"""{{projectName}} - Flask application"""

package/templates/flask/src/project_name/app.py

@@ -0,0 +1,15 @@
+from flask import Flask
+from .routes import bp
+
+app = Flask(__name__)
+app.register_blueprint(bp, url_prefix='/api')
+
+
+@app.route('/')
+def index():
+    return {'message': 'Welcome to {{projectName}}'}
+
+
+@app.route('/health')
+def health():
+    return {'status': 'ok'}

package/templates/flask/src/project_name/routes/__init__.py

@@ -0,0 +1,8 @@
+from flask import Blueprint
+
+bp = Blueprint('api', __name__)
+
+
+@bp.route('/hello')
+def hello():
+    return {'message': 'Hello, World!'}

package/templates/fullstack-react-node/README.md

@@ -0,0 +1,35 @@
+# {{projectName}}
+
+React + Node.js 全栈项目 (pnpm workspace)
+
+## 项目结构
+
+```
+{{projectName}}/
+├── frontend/    # React 前端 (Vite)
+├── backend/     # Express 后端
+└── package.json # Workspace 根配置
+```
+
+## 开发
+
+同时启动前后端开发服务器:
+
+```bash
+pnpm dev
+```
+
+- 前端: http://localhost:5173
+- 后端: http://localhost:3001
+
+## 构建
+
+```bash
+pnpm build
+```
+
+## 测试
+
+```bash
+pnpm test
+```

package/templates/fullstack-react-node/_gitignore

@@ -0,0 +1,7 @@
+node_modules/
+dist/
+*.log
+.DS_Store
+.env
+.env.local
+coverage/

package/templates/fullstack-react-node/_template.json

@@ -0,0 +1,14 @@
+{
+  "description": "React + Node.js 全栈项目模板",
+  "packageManager": "pnpm",
+  "type": "workspace",
+  "postInit": [
+    {
+      "command": "pnpm install",
+      "description": "安装依赖"
+    }
+  ],
+  "fileRenames": {
+    "_gitignore": ".gitignore"
+  }
+}

package/templates/fullstack-react-node/backend/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "{{projectName}}-backend",
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsup",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "cors": "^2.8.5",
+    "express": "^4.21.2"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.17",
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.10.7",
+    "tsup": "^8.3.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3"
+  }
+}

package/templates/fullstack-react-node/backend/src/index.ts

@@ -0,0 +1,20 @@
+import express from 'express'
+import cors from 'cors'
+
+const app = express()
+const PORT = process.env.PORT || 3001
+
+app.use(cors())
+app.use(express.json())
+
+app.get('/api/health', (_req, res) => {
+  res.json({ status: 'ok' })
+})
+
+app.get('/api/hello', (_req, res) => {
+  res.json({ message: 'Hello from {{projectName}} backend!' })
+})
+
+app.listen(PORT, () => {
+  console.log(`Backend server is running on http://localhost:${PORT}`)
+})

package/templates/fullstack-react-node/backend/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/fullstack-react-node/backend/tsup.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'tsup'
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm'],
+  target: 'node18',
+  clean: true,
+  dts: true
+})

package/templates/fullstack-react-node/frontend/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{{projectName}}</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/templates/fullstack-react-node/frontend/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "{{projectName}}-frontend",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.18",
+    "@types/react-dom": "^18.3.5",
+    "@vitejs/plugin-react": "^4.3.4",
+    "typescript": "^5.7.3",
+    "vite": "^6.0.7"
+  }
+}

package/templates/fullstack-react-node/frontend/src/App.css

@@ -0,0 +1,16 @@
+.app {
+  max-width: 800px;
+  margin: 0 auto;
+  padding: 2rem;
+  text-align: center;
+}
+
+h1 {
+  font-size: 2.5rem;
+  color: #333;
+}
+
+p {
+  font-size: 1.2rem;
+  color: #666;
+}

package/templates/fullstack-react-node/frontend/src/App.tsx

@@ -0,0 +1,22 @@
+import { useState, useEffect } from 'react'
+import './App.css'
+
+function App() {
+  const [message, setMessage] = useState<string>('')
+
+  useEffect(() => {
+    fetch('/api/hello')
+      .then(res => res.json())
+      .then(data => setMessage(data.message))
+      .catch(err => console.error(err))
+  }, [])
+
+  return (
+    <div className="app">
+      <h1>{{projectName}}</h1>
+      <p>来自后端的消息: {message || '加载中...'}</p>
+    </div>
+  )
+}
+
+export default App

package/templates/fullstack-react-node/frontend/src/main.tsx

@@ -0,0 +1,9 @@
+import { StrictMode } from 'react'
+import { createRoot } from 'react-dom/client'
+import App from './App.tsx'
+
+createRoot(document.getElementById('root')!).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+)

package/templates/fullstack-react-node/frontend/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true
+  },
+  "include": ["src"]
+}

package/templates/fullstack-react-node/frontend/vite.config.ts

@@ -0,0 +1,14 @@
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+
+export default defineConfig({
+  plugins: [react()],
+  server: {
+    proxy: {
+      '/api': {
+        target: 'http://localhost:3001',
+        changeOrigin: true
+      }
+    }
+  }
+})

package/templates/fullstack-react-node/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "{{projectName}}",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "pnpm -r --parallel dev",
+    "build": "pnpm -r build",
+    "test": "pnpm -r test"
+  }
+}

package/templates/fullstack-react-node/pnpm-workspace.yaml

@@ -0,0 +1,3 @@
+packages:
+  - 'frontend'
+  - 'backend'

package/templates/fullstack-react-python/Makefile

@@ -0,0 +1,35 @@
+.PHONY: install dev build test clean
+
+# 安装所有依赖
+install:
+	cd frontend && pnpm install
+	cd backend && uv sync
+
+# 开发模式（并行启动前后端）
+dev:
+	@echo "Starting development servers..."
+	@(cd backend && uv run uvicorn {{projectName}}.main:app --reload --port 8000) & \
+	(cd frontend && pnpm dev) & \
+	wait
+
+# 仅启动后端
+dev-backend:
+	cd backend && uv run uvicorn {{projectName}}.main:app --reload --port 8000
+
+# 仅启动前端
+dev-frontend:
+	cd frontend && pnpm dev
+
+# 构建
+build:
+	cd frontend && pnpm build
+
+# 测试
+test:
+	cd backend && uv run pytest
+	cd frontend && pnpm test 2>/dev/null || true
+
+# 清理
+clean:
+	rm -rf frontend/node_modules frontend/dist
+	rm -rf backend/.venv backend/__pycache__

package/templates/fullstack-react-python/README.md

@@ -0,0 +1,43 @@
+# {{projectName}}
+
+React + Python (FastAPI) 全栈项目
+
+## 项目结构
+
+```
+{{projectName}}/
+├── frontend/    # React 前端 (Vite + pnpm)
+├── backend/     # FastAPI 后端 (uv)
+├── Makefile     # 统一命令入口
+└── README.md
+```
+
+## 开发
+
+同时启动前后端开发服务器:
+
+```bash
+make dev
+```
+
+- 前端: http://localhost:5173
+- 后端: http://localhost:8000
+- API 文档: http://localhost:8000/docs
+
+## 安装依赖
+
+```bash
+make install
+```
+
+## 构建
+
+```bash
+make build
+```
+
+## 测试
+
+```bash
+make test
+```

package/templates/fullstack-react-python/_gitignore

@@ -0,0 +1,18 @@
+node_modules/
+dist/
+*.log
+.DS_Store
+.env
+.env.local
+coverage/
+__pycache__/
+*.py[cod]
+*$py.class
+.Python
+.venv/
+venv/
+env/
+*.egg-info/
+build/
+.pytest_cache/
+.ruff_cache/

package/templates/fullstack-react-python/_template.json

@@ -0,0 +1,25 @@
+{
+  "description": "React + Python (FastAPI) 全栈项目模板",
+  "packageManager": "pnpm",
+  "type": "workspace",
+  "postInit": [
+    {
+      "command": "make install",
+      "description": "安装依赖"
+    }
+  ],
+  "workspaces": [
+    {
+      "name": "frontend",
+      "packageManager": "pnpm"
+    },
+    {
+      "name": "backend",
+      "packageManager": "uv"
+    }
+  ],
+  "fileRenames": {
+    "_gitignore": ".gitignore",
+    "project_name": "{{projectName}}"
+  }
+}

package/templates/fullstack-react-python/backend/pyproject.toml

@@ -0,0 +1,21 @@
+[project]
+name = "{{projectName}}"
+version = "0.1.0"
+description = "FastAPI backend for {{projectName}}"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "fastapi>=0.115.0",
+    "uvicorn[standard]>=0.34.0",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.uv]
+dev-dependencies = [
+    "pytest>=8.0.0",
+    "httpx>=0.27.0",
+    "ruff>=0.8.0",
+]

package/templates/fullstack-react-python/backend/src/project_name/__init__.py

@@ -0,0 +1 @@
+"""{{projectName}} - FastAPI backend"""

package/templates/fullstack-react-python/backend/src/project_name/main.py

@@ -0,0 +1,29 @@
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+from .routes import router
+
+app = FastAPI(
+    title="{{projectName}}",
+    description="FastAPI backend for {{projectName}}",
+    version="0.1.0"
+)
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["http://localhost:5173"],
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+app.include_router(router, prefix="/api")
+
+
+@app.get("/")
+async def root():
+    return {"message": "Welcome to {{projectName}} API"}
+
+
+@app.get("/health")
+async def health():
+    return {"status": "ok"}

package/templates/fullstack-react-python/backend/src/project_name/routes/__init__.py

@@ -0,0 +1,8 @@
+from fastapi import APIRouter
+
+router = APIRouter()
+
+
+@router.get("/hello")
+async def hello():
+    return {"message": "Hello from {{projectName}} FastAPI backend!"}

package/templates/fullstack-react-python/frontend/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{{projectName}}</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/templates/fullstack-react-python/frontend/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "{{projectName}}-frontend",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.18",
+    "@types/react-dom": "^18.3.5",
+    "@vitejs/plugin-react": "^4.3.4",
+    "typescript": "^5.7.3",
+    "vite": "^6.0.7"
+  }
+}