TinyShip 技术架构

TinyShip 面向全球与中国市场，是现代化全栈 SaaS 开发平台：

• 支持国内外双市场。
• 采用 Next.js + Nuxt.js 双框架架构
• 采用简洁的 monorepo 架构。

既支持国际的 Stripe、OAuth，也深度适配中国的微信登录、微信支付，双市场无缝覆盖；内置 i18n 开箱即用。

它主打“基础完备 + 可扩展架构”，核心流程默认可用，其余能力由开发者按需扩展。

架构基石

• 双框架前端：Next.js（React）与 Nuxt.js（Vue）并行，业务形态一致，后端能力和模式保持统一。
• 共享库（/libs）：Auth、Payment、Database、Email/SMS、i18n、UI、Permissions、Storage、AI 等，尽量保持框架无关，可在两端复用。
• 供应商可替换：支付（Stripe / 微信支付 / Creem）、通讯（Resend / SendGrid / SMTP、Twilio / 阿里云）、认证（Better-Auth + OAuth）、AI（Vercel AI SDK）均可按需切换或增补。
• 避免锁定：通过统一的适配层/接口更换提供商，减少迁移成本。
• 开发者友好：TypeScript 全面覆盖，Zod 做输入校验，CASL 做权限，Tailwind + 主题体系支撑样式，目录与代码结构对 Cursor/AI 工具友好。

前端应用

• Next.js 应用（React）：Next.js（SSR/ISR）+ Tailwind CSS + shadcn/ui。
• Nuxt.js 应用（Vue）：Nuxt + Tailwind CSS + Magic UI + shadcn/vue，与 Next.js 应用在业务域保持一致，保障双栈对齐。
• Docs (Fumadocs)：文档子站，内置 i18n、搜索与统一设计语言。

核心领域（跨应用共享）

• 鉴权与账户：Better-Auth；邮箱/手机号/微信/OAuth 登录；MFA 预备；账号绑定；会话与密码流。
• 支付与套餐：Stripe + 微信支付 + Creem，一次性/循环订阅，非分级计划；订阅周期展示、第三方 Portal 跳转。
• 积分系统：AI 时代的按需付费模式；支持固定/动态消耗；AI 模型乘数配置；完整交易记录追踪。
• 云存储：统一存储接口；支持阿里云 OSS / AWS S3 / Cloudflare R2；文件上传下载、签名 URL、元数据管理。
• AI：基于 Vercel AI SDK 的聊天示例，便于扩展为嵌入、工具、多模态；集成积分消耗计算。
• 邮件与短信：邮件（Resend）与短信（Twilio/阿里云）多提供商集成，支持验证、通知与模板。
• 内容与多语言：共享翻译与 Locale 前缀路由，双语页面与文档。

基础设施与工具

• 数据与 ORM：PostgreSQL + Drizzle ORM，类型安全的 Schema 与迁移。
• 校验与权限：Zod 负责输入校验，CASL 做角色/权限控制。
• 样式与主题：Tailwind；主题类（如 theme-claude），支持明暗与多配色；渐变/图表色变量。
• 构建与运行：pnpm + turbo monorepo，Docker，就绪的 standalone 或静态导出方案。
• 开发体验：Cursor 友好目录，Typed SDK，Shiki/MDX 文档，Nuxt stacks 页面展示动效示例。

项目结构（高层视图）

tinyship/
  apps/
    next-app/      # React/Next.js 应用
    nuxt-app/      # Vue/Nuxt.js 应用
    docs-app/      # Fumadocs 文档站
  libs/
    auth/          # 认证与账户
    database/      # 数据库与 ORM
    payment/       # 支付集成
    credits/       # 积分系统
    i18n/          # 国际化
    ui/            # UI 组件
    email/         # 邮件服务
    sms/           # 短信服务
    storage/       # 云存储（OSS/S3/R2）
    permissions/   # 权限控制
    ai/            # AI 集成
    ...
  docs/            # 项目文档与指南

可扩展指南

• 替换/新增支付与通讯提供商，保持统一 API。
• 追加业务流程：引导、功能分层、审计、计费规则。
• 扩展 AI 场景：RAG、工具、多模型、多模态。
• 深化 Admin：自定义操作、日志、仪表盘。
• 在现有页面之上搭建模板库，而不破坏核心架构。

进一步了解

• 产品首页：tinyship.cn
• 产品流程演示：demo.tinyship.cn
• 未来规划：路线图