TinyShip
TinyShip
 TinyShip
TinyShip
TinyShip 文档中心
TinyShip 用户指南快速开始基础配置
积分系统配置指南
存储服务配置验证码配置
开发最佳实践本地 E2E 测试流程
用户指南

开发最佳实践

TinyShip 项目开发建议与协作规范

框架选择建议

  • Next.js (apps/next-app/):适合企业级、SEO 与复杂 SSR 场景
  • Nuxt.js (apps/nuxt-app/):适合 Vue 团队与快速迭代
  • TanStack Start (apps/tanstack-app/):适合轻量级 React 全栈开发

Git 工作流

  • 使用功能分支:feature/*、fix/*、docs/*
  • 使用语义化提交:feat:、fix:、docs:
  • 定期同步上游模板更新,及时解决冲突

自定义开发建议

  • 优先新增模块/接口,尽量避免直接改模板核心逻辑
  • 保持业务代码与模板核心能力解耦,降低后续升级成本

传统部署

在 VPS 服务器上传统部署

本地 E2E 测试流程

在本地运行 Playwright E2E 并做三端回归

On this page

框架选择建议Git 工作流自定义开发建议