Skip to main content
适用于生产级 Cloudflare Workers 应用的完整编码规范模板,包含 Hono 框架、Drizzle ORM 和 Turso 边缘数据库。

下载模板

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

包含内容

模板结构

主要内容

后端

  • 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 上查看

浏览模板源码