跳转到主要内容
适用于生产级 Cloudflare Workers 应用的完整编码规范模板，包含 Hono 框架、Drizzle ORM 和 Turso 边缘数据库。

下载模板

下载 ZIP 并解压到 .trellis/spec/

​
包含内容

分类文件数覆盖范围
后端11 个Hono、Drizzle/Turso、API 模式、安全、存储
前端7 个 + 示例组件、Hooks、认证、设计模板
共享5 个TypeScript、代码质量、依赖管理、时间戳
指南3 个OAuth 授权流程、Serverless 连接调试
坑点6 个Workers 兼容性、跨层契约、环境配置、CSS

​
模板结构

spec/
├── backend/
│   ├── index.md
│   ├── hono-framework.md
│   ├── database.md
│   ├── api-module.md
│   ├── api-patterns.md
│   ├── security.md
│   ├── storage.md
│   └── ...
│
├── frontend/
│   ├── index.md
│   ├── authentication.md
│   ├── components.md
│   ├── hooks.md
│   ├── directory-structure.md
│   ├── examples/frontend-design/
│   └── ...
│
├── guides/
│   ├── oauth-consent-flow.md
│   ├── serverless-connection-guide.md
│   └── ...
│
├── shared/
│   ├── typescript.md
│   ├── code-quality.md
│   ├── dependency-versions.md
│   └── ...
│
├── big-question/
│   ├── workers-nodejs-compat.md
│   ├── cross-layer-contract.md
│   ├── env-configuration.md
│   └── ...
│
└── README.md

​
主要内容

​
后端

  • Hono 框架模式（类型安全 Bindings、中间件、WebSocket）
  • Drizzle ORM + Turso/libSQL（批量操作、N+1 防护、Workers 限制）
  • Cloudflare 存储（R2、KV、Cache API 会话缓存）
  • 安全（Token 生成、时序安全比较、OAuth 重定向验证）
  • 请求上下文结构化 JSON 日志

​
前端

  • React 19 + React Router v7 + Vite
  • Better Auth UI v3.x 集成（SSR 安全、Cloudflare Workers 适配）
  • shadcn/ui 组件 + Tailwind CSS v4
  • 设计示例模板（极简 Hero、极繁仪表盘、动画库）

​
指南

  • OAuth 2.1 授权流程与资源选择
  • Serverless 连接调试（过期连接、子请求限制）

​
常见坑点

  • Workers Node.js 兼容性（nodejs_compat 标志）
  • 跨层契约违反（数据流通但客户端收不到）
  • 构建时 vs 运行时环境变量
  • Tailwind v4 CSS 调试

​
使用方法

  1. 下载 ZIP 文件
  2. 解压到项目的 .trellis/spec/ 目录
  3. 将通用环境变量名替换为你的实际 Bindings
  4. 按你项目的具体规范修改
  5. 删掉不适用的部分

在 GitHub 上查看

浏览模板源码