文档

模板介绍

面向中国客户的 TanStack Start SaaS 全栈模板,认证、支付、内容系统开箱即用

欢迎使用 HackerStart,一个基于 TanStack Start 构建的面向中国市场的全栈 SaaS 模板。本项目提供模块化、可扩展的代码库,帮助你快速上线 SaaS 产品。

无论你是独立开发者还是团队,本文档将引导你完成网站的配置、定制和部署。

核心能力

只需 10-20 分钟配置,即可获得:

  • 认证系统:InsForge Auth 驱动的邮箱密码登录、OAuth 社交登录
  • 支付集成:微信支付 + 支付宝,面向中国客户场景
  • 内容系统:文档、博客、更新日志、路线图、法律条款,5 个子系统按需开关
  • 多语言支持:中英双语内容 + UI 层类型安全翻译
  • 主题系统:亮暗色主题切换,基于 shadcn/ui + Tailwind CSS 4
  • 多租户架构:工作区 + 组织 + RBAC 权限控制
  • Events 业务模块:活动创建、公开市场、免费报名、跨工作区参与者关系
  • 配置系统:在线管理面板,运行时修改配置无需重启
  • 部署就绪:EdgeOne Pages 适配器,一键部署到腾讯云

技术栈

TanStack Start全栈 React 框架
React 19最新版本
Vite极速构建工具
TypeScript类型安全
Tailwind CSS 4原子化 CSS
shadcn/ui可复用组件库
InsForge认证、数据库与存储服务
Drizzle ORM类型安全 ORM
PostgreSQL关系型数据库
Paraglide JS类型安全国际化
fumadocs-mdxMDX 内容框架
EdgeOne Pages边缘计算部署
TanStack AIAI 编排框架
Biome格式化与检查

适用场景

社区型 SaaS 产品

痛点

你有社群、有内容、有空间,但缺少一个趁手的工具把这一切整合成产品。从零搭建认证、支付、内容管理、多语言——每个都耗时数周。

HackerStart 专为社区型组织设计:InsForge 开箱即用的认证和数据库、微信/支付宝支付对接中国用户、5 个内容子系统按需启用、中英双语切换,以及可直接扩展的 Events 工作台和公开活动市场。你只需专注于社区运营和内容创作。

技术博客与知识库

痛点

搭建文档或博客系统需要配置 MDX 解析、目录生成、搜索功能、多语言路由,大量胶水代码消耗开发时间。

HackerStart 集成 fumadocs-mdx,MDX 内容系统开箱即用:自动生成文档导航、内置全文搜索、完美适配中英双语路由。支持 Mermaid 流程图、代码高亮、图片放大等交互式组件。

面向中国市场的 SaaS

痛点

面向中国市场的产品需要接入微信支付、支付宝,处理国内用户习惯的认证流程,同时还要兼顾海外用户。

HackerStart 内置中国市场支付和认证方案,EdgeOne Pages 部署确保国内访问速度,多租户架构支持不同客户独立配置。

本文档的范围

本文档假设你对 TanStack Start 和 React 有基本了解。我们不会覆盖这些技术的基础知识,请根据需要参考官方文档:

获取帮助

如果你遇到困难:

下一步

现在你已经了解了 HackerStart,接下来开始配置你的项目:

快速开始 →

配置环境变量 →](./introduction/environment)

配置系统设置 →](./introduction/config-setup)

部署到 EdgeOne Pages →](./deployment/edgeone-pages)

本页内容