TinyShip User Guide
A modern, feature-complete monorepo starter kit designed for building SaaS applications
A modern, feature-complete monorepo starter kit designed for building SaaS applications, supporting both domestic and international markets.
Core Features
- Three Framework Support: Supports Next.js (React), Nuxt.js (Vue), and TanStack Start (React)
- Complete Authentication: Email/password, OAuth (Google, GitHub, WeChat), SMS login
- Multiple Payment Integration: Stripe, WeChat Pay, CREEM
- Internationalization: Built-in multi-language system
- RBAC Permission Management: Role-based access control
- AI Integration: Support for multiple AI providers
- Type Safety: Comprehensive TypeScript support
- Modern UI: Component library based on shadcn/ui
Quick Start
Configuration Guides
App name, Logo, theme system, internationalization
Email/password, Google, GitHub, WeChat, SMS login
Stripe, PayPal, WeChat Pay, Creem integration guides
Credit recharge, consumption configuration, AI billing
AI chat, image generation, and video generation configuration
Alibaba Cloud OSS, AWS S3, Cloudflare R2, Tencent COS
Cloudflare Turnstile bot protection
Vercel, Docker, VPS deployment guides
Project Architecture
Monorepo Structure
TinyShip uses a simplified monorepo structure with shared core code in the libs directory:
tinyship/
├── apps/ # Application implementations
│ ├── next-app/ # Next.js application
│ ├── nuxt-app/ # Nuxt.js application
│ ├── tanstack-app/ # TanStack Start application
│ └── docs-app/ # Documentation site (Fumadocs)
├── libs/ # Core libraries
│ ├── database/ # Database operations and schema
│ ├── auth/ # Authentication service
│ ├── email/ # Email service
│ ├── sms/ # SMS service
│ ├── payment/ # Payment service
│ ├── storage/ # Storage service (OSS/S3/R2/COS)
│ ├── ai/ # AI integration
│ ├── i18n/ # Internationalization
│ ├── permissions/ # Permission management
│ ├── react-shared/ # Shared React components (Next.js + TanStack Start)
│ ├── ui/ # Shared UI styles
│ └── validators/ # Data validation
└── docs/ # Project documentationTech Stack
| Category | Technology |
|---|---|
| Frontend | Next.js 15, Nuxt.js 3, TanStack Start, TypeScript, Tailwind CSS |
| Backend | Drizzle ORM, PostgreSQL, Better Auth |
| Deployment | Vercel, Netlify, Docker, PNPM |
Application Pages Overview
After starting the application, here are the main page paths:
| Category | Page | Path | Description |
|---|---|---|---|
| Home | Home | / | Application homepage |
| Auth | Sign In | /signin | User login |
| Sign Up | /signup | User registration | |
| Phone Login | /cellphone | Phone verification login | |
| WeChat Login | /wechat | WeChat scan login | |
| User | Dashboard | /dashboard | User personal center |
| Premium | /premium-features | Premium features demo | |
| Payment | Pricing | /pricing | View subscription plans |
| AI | AI Chat | /ai | AI chat feature |
| Image Gen | /image-generate | AI image generation | |
| Video Gen | /video-generate | AI video generation | |
| Storage | Upload Demo | /upload | File upload demo |
| Admin | Admin Panel | /admin | Admin dashboard |
| User Management | /admin/users | User list and management | |
| Order Management | /admin/orders | Order list and management | |
| Subscription | /admin/subscriptions | Subscription management | |
| Credits | /admin/credits | Credit transaction records |