@lark-apaas/coding-templates 0.1.3 → 0.1.4

package/template-nextjs-fullstack/README.md

@@ -1,169 +0,0 @@
-# Next.js 全栈模板
-
-Next.js App Router + Drizzle ORM + PostgreSQL 全栈模板，支持 Server Actions、SSR、API Routes。
-
-## 快速开始
-
-```bash
-# 1. 安装依赖
-npm install
-
-# 2. 配置数据库（修改 .env.local 中的 DATABASE_URL）
-cp .env.local.example .env.local
-
-# 3. 初始化数据库表
-npm run db:push
-
-# 4. 启动开发服务器
-npm run dev
-```
-
-打开 http://localhost:3000 查看效果。
-
-## 命令
-
-| 命令 | 说明 |
-|---|---|
-| `npm run dev` | 启动开发服务器 |
-| `npm run build` | 生产构建 |
-| `npm run start` | 启动生产服务 |
-| `npm run lint` | 运行 ESLint |
-| `npm run db:generate` | 生成 Drizzle 迁移文件 |
-| `npm run db:migrate` | 执行数据库迁移 |
-| `npm run db:push` | 推送 schema 到数据库（开发用） |
-| `npm run db:studio` | 打开 Drizzle Studio |
-
-## 独立部署（Docker / FaaS 容器模式）
-
-### 1. 开启 standalone 模式
-
-```ts
-// next.config.ts
-import type { NextConfig } from "next";
-
-const nextConfig: NextConfig = {
-  output: "standalone",
-  assetPrefix: "https://cdn.example.com", // 静态资源 CDN 地址
-};
-
-export default nextConfig;
-```
-
-### 2. 构建
-
-```bash
-npm run build
-```
-
-产出 `.next/standalone/` 目录，包含：
-- `server.js` — 服务入口，`node server.js` 直接启动
-- `node_modules/` — 仅运行时依赖（tree-shaking 后，远小于完整 node_modules）
-- `.next/server/` — SSR 产物
-
-### 3. Dockerfile
-
-```dockerfile
-FROM node:20-alpine
-WORKDIR /app
-
-# 复制 standalone 产出
-COPY .next/standalone ./
-# 静态资源（如果不走 CDN 则需要复制）
-COPY .next/static ./.next/static
-COPY public ./public
-
-ENV NODE_ENV=production
-ENV PORT=3000
-EXPOSE 3000
-
-CMD ["node", "server.js"]
-```
-
-```bash
-docker build -t my-app .
-docker run -p 3000:3000 \
-  -e DATABASE_URL="postgresql://user:pass@host:5432/db" \
-  my-app
-```
-
-镜像体积约 100-150MB，启动时间 1-2 秒。
-
-### 4. 部署架构
-
-```
-┌─────────────┐     ┌──────────────────┐     ┌─────────────┐
-│   浏览器     │────→│  Nginx / 网关     │────→│  FaaS 容器   │
-│             │     │                  │     │  server.js  │
-│             │     │  路由分发：        │     │  (standalone)│
-│             │     │  /*.html → 容器   │     │             │
-│             │     │                  │     │     ↓       │
-│             │     └──────────────────┘     │  PostgreSQL  │
-│             │              │               └─────────────┘
-│             │              │
-│             │     ┌────────↓─────────┐
-│             │←────│      CDN         │
-│             │     │  _next/static/*  │
-│             │     │  (JS/CSS/字体)    │
-│             │     └──────────────────┘
-│             │
-│             │     ┌──────────────────┐
-│             │←────│      TOS         │
-│             │     │  图片资源         │
-│             │     │  (独立权限控制)    │
-│             │     └──────────────────┘
-```
-
-| 资源类型 | 部署位置 | 说明 |
-|---|---|---|
-| HTML / SSR / API | FaaS 容器 | standalone server.js 处理 |
-| JS / CSS / 字体 | CDN | 通过 `assetPrefix` 配置 |
-| 图片 | TOS | 通过自定义 Image Loader |
-| 数据库 | PostgreSQL | 通过 `DATABASE_URL` 环境变量 |
-
-### 5. 图片走 TOS（可选）
-
-如果图片需要部署到独立的 TOS（对象存储），配置自定义 Image Loader：
-
-```ts
-// next.config.ts
-const nextConfig: NextConfig = {
-  output: "standalone",
-  assetPrefix: "https://cdn.example.com",
-  images: {
-    loader: "custom",
-    loaderFile: "./src/lib/image-loader.ts",
-  },
-};
-```
-
-```ts
-// src/lib/image-loader.ts
-export default function tosLoader({
-  src,
-  width,
-  quality,
-}: {
-  src: string;
-  width: number;
-  quality?: number;
-}) {
-  return `https://tos.example.com${src}?w=${width}&q=${quality || 75}`;
-}
-```
-
-### 6. 环境变量
-
-| 变量 | 说明 | 示例 |
-|---|---|---|
-| `DATABASE_URL` | PostgreSQL 连接地址 | `postgresql://user:pass@host:5432/db` |
-| `PORT` | 服务端口（默认 3000） | `3000` |
-| `HOSTNAME` | 监听地址（容器中建议 0.0.0.0） | `0.0.0.0` |
-
-## 技术栈
-
-- Next.js 16（App Router、SSR、Server Actions）
-- React 19、TypeScript 5
-- Tailwind CSS 4 + shadcn/ui（base-nova 风格、lucide 图标）
-- Drizzle ORM + PostgreSQL
-- Zod（数据校验）
-- next-themes（暗色模式）

package/template-nextjs-fullstack/_env.local.example

@@ -1 +0,0 @@
-DATABASE_URL=postgresql://postgres:postgres@localhost:5432/openclaw

package/template-nextjs-fullstack/_gitignore

@@ -1,41 +0,0 @@
-# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
-
-# dependencies
-/node_modules
-/.pnp
-.pnp.*
-.yarn/*
-!.yarn/patches
-!.yarn/plugins
-!.yarn/releases
-!.yarn/versions
-
-# testing
-/coverage
-
-# next.js
-/.next/
-/out/
-
-# production
-/build
-
-# misc
-.DS_Store
-*.pem
-
-# debug
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-.pnpm-debug.log*
-
-# env files (can opt-in for committing if needed)
-.env*
-
-# vercel
-.vercel
-
-# typescript
-*.tsbuildinfo
-next-env.d.ts

package/template-nextjs-fullstack/components.json

@@ -1,25 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema.json",
-  "style": "base-nova",
-  "rsc": true,
-  "tsx": true,
-  "tailwind": {
-    "config": "tailwind.config.ts",
-    "css": "src/app/globals.css",
-    "baseColor": "neutral",
-    "cssVariables": true,
-    "prefix": ""
-  },
-  "iconLibrary": "lucide",
-  "rtl": false,
-  "aliases": {
-    "components": "@/components",
-    "utils": "@/lib/utils",
-    "ui": "@/components/ui",
-    "lib": "@/lib",
-    "hooks": "@/hooks"
-  },
-  "menuColor": "default",
-  "menuAccent": "subtle",
-  "registries": {}
-}

package/template-nextjs-fullstack/drizzle.config.ts

@@ -1,10 +0,0 @@
-import { defineConfig } from "drizzle-kit";
-
-export default defineConfig({
-  schema: "./src/db/schema.ts",
-  out: "./drizzle",
-  dialect: "postgresql",
-  dbCredentials: {
-    url: process.env.DATABASE_URL!,
-  },
-});

package/template-nextjs-fullstack/eslint.config.js

@@ -1,15 +0,0 @@
-const js = require('@eslint/js');
-const tseslint = require('typescript-eslint');
-
-module.exports = tseslint.config(
-  { ignores: ['.next', 'out', 'node_modules'] },
-  js.configs.recommended,
-  ...tseslint.configs.recommended,
-  {
-    files: ['src/**/*.{ts,tsx}'],
-    rules: {
-      '@typescript-eslint/no-unused-vars': 'warn',
-      '@typescript-eslint/no-unused-expressions': 'off',
-    },
-  },
-);

package/template-nextjs-fullstack/next.config.ts

@@ -1,5 +0,0 @@
-import type { NextConfig } from "next";
-
-const nextConfig: NextConfig = {};
-
-export default nextConfig;

package/template-nextjs-fullstack/package.json

@@ -1,85 +0,0 @@
-{
-  "name": "{{projectName}}",
-  "version": "0.1.0",
-  "private": true,
-  "mclaw": {
-    "stack": "nextjs",
-    "stackVersion": "0.1.0"
-  },
-  "scripts": {
-    "dev": "next dev",
-    "build": "bash scripts/build.sh",
-    "start": "next start",
-    "lint": "eslint src",
-    "db:generate": "drizzle-kit generate",
-    "db:migrate": "drizzle-kit migrate",
-    "db:push": "drizzle-kit push",
-    "db:studio": "drizzle-kit studio"
-  },
-  "dependencies": {
-    "@base-ui/react": "^1.3.0",
-    "@radix-ui/react-accordion": "^1.2.12",
-    "@radix-ui/react-alert-dialog": "^1.1.15",
-    "@radix-ui/react-aspect-ratio": "^1.1.7",
-    "@radix-ui/react-avatar": "^1.1.10",
-    "@radix-ui/react-checkbox": "^1.3.3",
-    "@radix-ui/react-collapsible": "^1.1.12",
-    "@radix-ui/react-context-menu": "^2.2.16",
-    "@radix-ui/react-dialog": "^1.1.15",
-    "@radix-ui/react-dropdown-menu": "^2.1.16",
-    "@radix-ui/react-hover-card": "^1.1.15",
-    "@radix-ui/react-label": "^2.1.7",
-    "@radix-ui/react-menubar": "^1.1.16",
-    "@radix-ui/react-navigation-menu": "^1.2.14",
-    "@radix-ui/react-popover": "^1.1.15",
-    "@radix-ui/react-progress": "^1.1.7",
-    "@radix-ui/react-radio-group": "^1.3.8",
-    "@radix-ui/react-scroll-area": "^1.2.10",
-    "@radix-ui/react-select": "^2.2.6",
-    "@radix-ui/react-separator": "^1.1.7",
-    "@radix-ui/react-slider": "^1.3.6",
-    "@radix-ui/react-slot": "^1.2.3",
-    "@radix-ui/react-switch": "^1.2.6",
-    "@radix-ui/react-tabs": "^1.1.13",
-    "@radix-ui/react-toggle": "^1.1.10",
-    "@radix-ui/react-toggle-group": "^1.1.11",
-    "@radix-ui/react-tooltip": "^1.2.8",
-    "class-variance-authority": "^0.7.1",
-    "clsx": "^2.1.1",
-    "cmdk": "^1.1.1",
-    "drizzle-orm": "^0.45.1",
-    "embla-carousel-react": "^8.6.0",
-    "es-toolkit": "^1.43.0",
-    "framer-motion": "^12.36.0",
-    "input-otp": "^1.4.2",
-    "lucide-react": "^0.577.0",
-    "next": "16.1.6",
-    "next-themes": "^0.4.6",
-    "postgres": "^3.4.8",
-    "react": "19.2.3",
-    "react-day-picker": "^9.11.1",
-    "react-dom": "19.2.3",
-    "react-hook-form": "^7.65.0",
-    "react-resizable-panels": "^3.0.6",
-    "recharts": "^2.15.4",
-    "shadcn": "^4.0.8",
-    "sonner": "^2.0.7",
-    "streamdown": "^1.6.10",
-    "tailwind-merge": "^3.5.0",
-    "tw-animate-css": "^1.4.0",
-    "vaul": "^1.1.2",
-    "zod": "^4.3.6"
-  },
-  "devDependencies": {
-    "@eslint/js": "^9",
-    "@tailwindcss/postcss": "^4",
-    "@types/node": "^20",
-    "@types/react": "^19",
-    "@types/react-dom": "^19",
-    "drizzle-kit": "^0.31.9",
-    "eslint": "^9",
-    "tailwindcss": "^4",
-    "typescript": "^5",
-    "typescript-eslint": "^8"
-  }
-}

package/template-nextjs-fullstack/postcss.config.js

@@ -1,8 +0,0 @@
-/**
- * @type {import('postcss-load-config').Config}
- */
-module.exports = {
-  plugins: {
-    '@tailwindcss/postcss': {},
-  },
-};

package/template-nextjs-fullstack/scripts/build.sh

@@ -1,37 +0,0 @@
-#!/bin/bash
-set -e
-
-ROOT="$(cd "$(dirname "$0")/.." && pwd)"
-OUTPUT="$ROOT/dist/output"
-OUTPUT_RESOURCE="$ROOT/dist/output_resource"
-
-# 清理
-rm -rf "$ROOT/dist"
-
-# 1. Next.js 构建 → .next/
-npx next build
-
-# 2. standalone → dist/output/
-mkdir -p "$OUTPUT"
-cp -r "$ROOT/.next/standalone/." "$OUTPUT/"
-
-# 复制 public/ 到 standalone
-if [ -d "$ROOT/public" ]; then
-  cp -r "$ROOT/public" "$OUTPUT/public"
-fi
-
-# 3. static/ → dist/output_resource/（JS/CSS/字体，上传到 CDN）
-if [ -d "$ROOT/.next/static" ]; then
-  mkdir -p "$OUTPUT_RESOURCE/_next"
-  cp -r "$ROOT/.next/static" "$OUTPUT_RESOURCE/_next/"
-fi
-
-# 复制 .next/static 到 standalone
-if [ -d "$ROOT/.next/static" ]; then
-  mkdir -p "$OUTPUT/.next"
-  cp -r "$ROOT/.next/static" "$OUTPUT/.next/"
-fi
-
-echo "Build complete"
-echo "  Standalone → dist/output/"
-[ -d "$OUTPUT_RESOURCE" ] && echo "  Resource   → dist/output_resource/"

package/template-nextjs-fullstack/src/app/globals.css

@@ -1,130 +0,0 @@
-@import "tailwindcss";
-@import "tw-animate-css";
-@import "shadcn/tailwind.css";
-@config "../../tailwind.config.ts";
-
-@custom-variant dark (&:is(.dark *));
-
-@theme inline {
-  --color-background: var(--background);
-  --color-foreground: var(--foreground);
-  --font-sans: var(--font-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) * 0.6);
-  --radius-md: calc(var(--radius) * 0.8);
-  --radius-lg: var(--radius);
-  --radius-xl: calc(var(--radius) * 1.4);
-  --radius-2xl: calc(var(--radius) * 1.8);
-  --radius-3xl: calc(var(--radius) * 2.2);
-  --radius-4xl: calc(var(--radius) * 2.6);
-}
-
-:root {
-  --background: oklch(1 0 0);
-  --foreground: oklch(0.145 0 0);
-  --card: oklch(1 0 0);
-  --card-foreground: oklch(0.145 0 0);
-  --popover: oklch(1 0 0);
-  --popover-foreground: oklch(0.145 0 0);
-  --primary: oklch(0.205 0 0);
-  --primary-foreground: oklch(0.985 0 0);
-  --secondary: oklch(0.97 0 0);
-  --secondary-foreground: oklch(0.205 0 0);
-  --muted: oklch(0.97 0 0);
-  --muted-foreground: oklch(0.556 0 0);
-  --accent: oklch(0.97 0 0);
-  --accent-foreground: oklch(0.205 0 0);
-  --destructive: oklch(0.577 0.245 27.325);
-  --border: oklch(0.922 0 0);
-  --input: oklch(0.922 0 0);
-  --ring: oklch(0.708 0 0);
-  --chart-1: oklch(0.809 0.105 251.813);
-  --chart-2: oklch(0.623 0.214 259.815);
-  --chart-3: oklch(0.546 0.245 262.881);
-  --chart-4: oklch(0.488 0.243 264.376);
-  --chart-5: oklch(0.424 0.199 265.638);
-  --radius: 0.625rem;
-  --sidebar: oklch(0.985 0 0);
-  --sidebar-foreground: oklch(0.145 0 0);
-  --sidebar-primary: oklch(0.205 0 0);
-  --sidebar-primary-foreground: oklch(0.985 0 0);
-  --sidebar-accent: oklch(0.97 0 0);
-  --sidebar-accent-foreground: oklch(0.205 0 0);
-  --sidebar-border: oklch(0.922 0 0);
-  --sidebar-ring: oklch(0.708 0 0);
-}
-
-.dark {
-  --background: oklch(0.145 0 0);
-  --foreground: oklch(0.985 0 0);
-  --card: oklch(0.205 0 0);
-  --card-foreground: oklch(0.985 0 0);
-  --popover: oklch(0.205 0 0);
-  --popover-foreground: oklch(0.985 0 0);
-  --primary: oklch(0.922 0 0);
-  --primary-foreground: oklch(0.205 0 0);
-  --secondary: oklch(0.269 0 0);
-  --secondary-foreground: oklch(0.985 0 0);
-  --muted: oklch(0.269 0 0);
-  --muted-foreground: oklch(0.708 0 0);
-  --accent: oklch(0.269 0 0);
-  --accent-foreground: oklch(0.985 0 0);
-  --destructive: oklch(0.704 0.191 22.216);
-  --border: oklch(1 0 0 / 10%);
-  --input: oklch(1 0 0 / 15%);
-  --ring: oklch(0.556 0 0);
-  --chart-1: oklch(0.809 0.105 251.813);
-  --chart-2: oklch(0.623 0.214 259.815);
-  --chart-3: oklch(0.546 0.245 262.881);
-  --chart-4: oklch(0.488 0.243 264.376);
-  --chart-5: oklch(0.424 0.199 265.638);
-  --sidebar: oklch(0.205 0 0);
-  --sidebar-foreground: oklch(0.985 0 0);
-  --sidebar-primary: oklch(0.488 0.243 264.376);
-  --sidebar-primary-foreground: oklch(0.985 0 0);
-  --sidebar-accent: oklch(0.269 0 0);
-  --sidebar-accent-foreground: oklch(0.985 0 0);
-  --sidebar-border: oklch(1 0 0 / 10%);
-  --sidebar-ring: oklch(0.556 0 0);
-}
-
-@layer base {
-  * {
-    @apply border-border outline-ring/50;
-  }
-  body {
-    @apply bg-background text-foreground;
-  }
-  html {
-    @apply font-sans;
-  }
-}

package/template-nextjs-fullstack/src/app/layout.tsx

@@ -1,24 +0,0 @@
-import type { Metadata } from "next";
-import { Geist, Geist_Mono } from "next/font/google";
-import "./globals.css";
-import { ThemeProvider } from "@/components/theme-provider";
-
-const geistSans = Geist({ variable: "--font-geist-sans", subsets: ["latin"] });
-const geistMono = Geist_Mono({ variable: "--font-geist-mono", subsets: ["latin"] });
-
-export const metadata: Metadata = {
-  title: "OpenClaw Fullstack",
-  description: "Next.js Fullstack Template with Drizzle + PostgreSQL",
-};
-
-export default function RootLayout({ children }: { children: React.ReactNode }) {
-  return (
-    <html lang="zh" suppressHydrationWarning>
-      <body className={`${geistSans.variable} ${geistMono.variable} antialiased`}>
-        <ThemeProvider attribute="class" defaultTheme="system" enableSystem disableTransitionOnChange>
-          {children}
-        </ThemeProvider>
-      </body>
-    </html>
-  );
-}

package/template-nextjs-fullstack/src/app/page.tsx

@@ -1,69 +0,0 @@
-import { Button } from "@/components/ui/button";
-import { Card, CardDescription, CardHeader, CardTitle } from "@/components/ui/card";
-import { Badge } from "@/components/ui/badge";
-import { Header } from "@/components/header";
-import { Database, Zap, Shield } from "lucide-react";
-import Link from "next/link";
-
-export default function Home() {
-  return (
-    <div className="min-h-screen bg-background">
-      <Header />
-      <main>
-        <section className="container mx-auto px-4 py-24 text-center">
-          <Badge variant="secondary" className="mb-4">Next.js Fullstack</Badge>
-          <h1 className="text-4xl font-bold tracking-tight sm:text-6xl mb-6">
-            全栈应用模版
-          </h1>
-          <p className="text-lg text-muted-foreground max-w-2xl mx-auto mb-8">
-            基于 Next.js + Drizzle ORM + PostgreSQL 的全栈模版，Server Actions 驱动数据变更，为 AI 协作开发而生。
-          </p>
-          <div className="flex gap-4 justify-center">
-            <Link href="/todos">
-              <Button size="lg">查看 Todos 示例</Button>
-            </Link>
-            <Button size="lg" variant="outline">了解更多</Button>
-          </div>
-        </section>
-
-        <section className="container mx-auto px-4 py-16">
-          <div className="grid gap-6 md:grid-cols-3">
-            <Card>
-              <CardHeader>
-                <Database className="h-10 w-10 mb-2 text-primary" />
-                <CardTitle>类型安全数据库</CardTitle>
-                <CardDescription>
-                  Drizzle ORM 提供端到端类型安全，schema 即代码，迁移自动生成。
-                </CardDescription>
-              </CardHeader>
-            </Card>
-            <Card>
-              <CardHeader>
-                <Zap className="h-10 w-10 mb-2 text-primary" />
-                <CardTitle>Server Actions</CardTitle>
-                <CardDescription>
-                  数据变更直接写在服务端函数里，无需手写 API 路由，AI 生成代码更高效。
-                </CardDescription>
-              </CardHeader>
-            </Card>
-            <Card>
-              <CardHeader>
-                <Shield className="h-10 w-10 mb-2 text-primary" />
-                <CardTitle>数据校验</CardTitle>
-                <CardDescription>
-                  Zod schema 校验贯穿前后端，类型安全从表单到数据库全链路保障。
-                </CardDescription>
-              </CardHeader>
-            </Card>
-          </div>
-        </section>
-
-        <footer className="border-t py-8">
-          <div className="container mx-auto px-4 text-center text-sm text-muted-foreground">
-            OpenClaw Template — Built for Vibe Coding
-          </div>
-        </footer>
-      </main>
-    </div>
-  );
-}

package/template-nextjs-fullstack/src/app/todos/actions.ts

@@ -1,37 +0,0 @@
-"use server";
-
-import { db } from "@/db";
-import { todos } from "@/db/schema";
-import { eq } from "drizzle-orm";
-import { revalidatePath } from "next/cache";
-import { z } from "zod";
-
-const createTodoSchema = z.object({
-  title: z.string().min(1, "标题不能为空").max(200, "标题不能超过200字"),
-});
-
-export async function createTodo(formData: FormData) {
-  const parsed = createTodoSchema.safeParse({
-    title: formData.get("title"),
-  });
-
-  if (!parsed.success) {
-    return { error: parsed.error.flatten().fieldErrors.title?.[0] };
-  }
-
-  await db.insert(todos).values({ title: parsed.data.title });
-  revalidatePath("/todos");
-}
-
-export async function toggleTodo(id: number) {
-  const [todo] = await db.select().from(todos).where(eq(todos.id, id));
-  if (todo) {
-    await db.update(todos).set({ completed: !todo.completed }).where(eq(todos.id, id));
-  }
-  revalidatePath("/todos");
-}
-
-export async function deleteTodo(id: number) {
-  await db.delete(todos).where(eq(todos.id, id));
-  revalidatePath("/todos");
-}