移动应用
用 Expo 为 01MVP 模板接入 iOS 与 Android 应用
移动端模板在 products/01mvp/apps/mobile。它提供一个可复用的 App 起点：登录、调 API、读取会员状态、接 RevenueCat、用 EAS 生成安装包和商店包。
移动端和 Web 端共享同一个后端。Hono API 挂在 /api，oRPC 挂在 /api/rpc，Better Auth 挂在 /api/auth。App 只要把 EXPO_PUBLIC_SERVER_URL 指向已有 Web/API 服务，就能消费同一套账号、会员和业务数据。
目前还是 Beta 阶段。代码和文档适合学习、参考和二次开发；如果要正式上架，请把真机测试、商店资料、证书、隐私政策和审核流程当成单独工作来处理。
开做 App 前先准备
移动端最容易卡在账号、设备和签名。先把这些材料准备好，再让 AI 改代码。
| 准备项 | 什么时候需要 | 用途 | 新手提醒 |
|---|---|---|---|
| Mac 电脑 | iOS 开发必备 | 跑 Xcode、iOS Simulator、排查签名和原生问题 | Windows 可以写部分 JS 和 Android 流程；认真做 iOS，请准备 Mac。 |
| Xcode | iOS 开发必备 | iOS Simulator、原生配置、签名排查、真机调试 | App Store 上安装，首次打开要接受 license。 |
| iPhone 真机 | 登录、支付、推送、相册、深链验证时需要 | 验证模拟器覆盖不了的真实体验 | 上架前不能只看模拟器。 |
| Expo 账号 | 使用 EAS 时需要 | EAS Build、EAS Submit、构建日志、内部分发、OTA 更新 | 早期可以从免费额度开始，超出后按 Expo 官方计费。 |
| Apple Developer Program | TestFlight / App Store / 正式签名时需要 | Bundle ID、证书、Profile、App Store Connect、TestFlight | 官方标价 99 USD / 年；只是本地看页面时不用急着买。 |
| Google Play Console | Android 上架时需要 | 发布 Android App、Play App Signing、商店审核 | 官方注册费 25 USD 一次性。 |
| 自己的域名 | 真实发布前建议准备 | Web/API、登录回调、隐私政策、服务条款和用户信任 | 早期可用临时域名，正式发布建议换成自己的域名。 |
| 已上线或可访问的 Web/API | 真机调试和发布前都需要 | App 登录、API、会员和业务数据都走这里 | 真机访问不了你电脑的 localhost，要用局域网 IP、tunnel 或线上域名。 |
| RevenueCat 账号 | 做 App 内购时需要 | iOS / Android entitlement、订阅状态和收据校验 | 不做内购可以先跳过。 |
| 隐私政策和测试账号 | 提交商店前需要 | 商店审核、用户告知、登录类 App 审核 | 有登录、支付、采集数据时基本都要准备。 |
一条完整的移动端路径
技术栈
| 层 | 方案 |
|---|---|
| App 框架 | React Native + Expo |
| 路由 | Expo Router |
| 样式 | Uniwind + HeroUI Native |
| 数据请求 | oRPC + TanStack Query |
| 登录 | Better Auth + @better-auth/expo + expo-secure-store |
| 付费 | RevenueCat SDK + 01MVP billing API |
| 构建 | EAS Build / EAS Submit |
mobile 目录怎么放
模板里的移动端目录保持小而清楚。你真的开始做业务后，也建议沿着这个边界扩展，不要把 Web dashboard、admin 和 docs 复制进 App。
products/01mvp/apps/mobile/
app/ Expo Router 路由入口
src/config/ EXPO_PUBLIC_* 公开配置解析
src/lib/ auth、oRPC、RevenueCat、URL 等客户端工具
src/providers/ Query、Safe Area、HeroUI Native 等全局 provider
src/screens/ 页面级 UI
src/ui/ 移动端复用组件
app.json App 身份、原生插件和平台配置
eas.json EAS development / preview / production profiles如果要新增业务模块，优先放在 src/screens 或 src/features 这类 App 内部目录；如果某段逻辑 Web 和 App 都要复用，再考虑沉到 products/01mvp/packages/*。
移动端模板保留什么
- 邮箱登录和注册
- 登录后的用户资料 API 调用
- 公共 health API 调用
- 公开付费计划展示
- RevenueCat entitlement 状态读取
- dev、preview、production 三套 EAS profile
.env.example和EXPO_PUBLIC_*配置说明
移动端模板不默认包含什么
- Web 后台、admin、AI 工具、Drop、文档站等复杂页面
- 原生录音、Widget、推送、文件上传等业务能力
- 已绑定的 App Store Connect、Google Play、RevenueCat 项目
这些能力按需加就行。模板只保留每个商业 App 都能直接复用的基础骨架。
先读哪几篇
章节地图
移动端必懂基础
先理解 App、Expo、真机、登录、API、环境变量和上架流程。
Vibe Coding
学会把移动端任务拆给 AI，避免一次性重写整个 App。
App 身份
先定名称、Bundle ID、Android package、scheme、图标和启动页。
环境变量与 API
让 App 连接 01MVP Web/API，同时避免把服务端密钥打进包。
App Shell 与导航
规划登录前后页面、Tab/Stack、loading、empty 和 error 状态。
主题系统
用 HeroUI Native、Uniwind 和 01MVP 视觉规则保持 UI 统一。
Apple 与 iOS 配置
把 Apple 账号、Bundle ID、能力、签名、TestFlight 和 EAS 串起来。
移动端数据与同步
App 只通过 API 请求数据，不直连数据库。
文件与存储
讲移动端选择、上传、预览文件，存储服务跳转到上层文档。
原生能力
相机、麦克风、推送、Widget 等能力按需接入并真机验收。
构建与上架
用 EAS Build、EAS Submit 和商店资料完成发布。
Skills / 插件推荐
按 Expo、UI、认证、发布阶段选择合适的 AI 辅助能力。
这篇文档有问题？