RN Empty Client — AI-Ready React Native Project Skeleton

一个零业务、纯工程骨架的 React Native 初始化规范文档。把这份文档喂给 AI（Claude、Cursor、Copilot、Codex 等），它能直接生成一个结构清晰、分层合理、开箱即用的 RN 新项目。

解决了什么问题？

每次起一个 React Native 新项目，你大概率会从旧项目复制代码，然后删业务逻辑。删不干净 → 带着旧项目的品牌色、API 地址、SDK 配置上线 → 后续越滚越脏。

这个仓库提供了一份结构化规范文档，AI 读完就能帮你生成：

模块化 MVVM 架构（View → ViewModel → Service → Model）
React Navigation 导航骨架（只有 Root + NotFound 两个壳页面）
空 API Client、StorageService、主题 token 等基础设施
TypeScript 严格模式 + ESLint + Prettier + Jest
基础通用组件（Button、TextField、EmptyState）
完整的目录结构和模块边界规则

没有任何业务代码、业务命名、真实 API 地址、第三方业务 SDK。

快速开始

把 RN_EMPTY_CLIENT_INIT_GUIDE.md 的内容作为提示词，发给 AI 编程助手即可。文档末尾有一段精简版初始化指令，可以直接复制使用。

示例（Claude Code / Cursor / Copilot Chat）：

请初始化一个 React Native + TypeScript 项目骨架，只保留工程架构，不包含任何业务。

要求：
1. 使用模块化 MVVM 架构。
2. 创建 App.tsx、src/app、src/navigation、src/modules/app-shell、
   src/components、src/services、src/models、src/theme、src/utils、
   src/hooks、src/contexts。
3. 导航只注册 Root 和 NotFound 两个无业务页面。
4. services 只提供空 ApiClient、StorageService、config 类型。
5. components 只提供无业务基础组件。
6. theme 只提供中性设计 token。
7. 不要创建任何业务模块。
8. TypeScript 开启 strict，并配置 src 路径别名。

生成的目录结构

.
├── App.tsx
├── index.js
├── app.json
├── babel.config.js
├── metro.config.js
├── tsconfig.json
├── package.json
├── __tests__/
├── docs/
│   ├── ARCHITECTURE.md
│   ├── CODE_RULES.md
│   └── MODULE_RULES.md
└── src/
    ├── app/           # AppProviders + AppBootstrap
    ├── assets/        # 占位资源规范
    ├── components/    # 无业务通用 UI 组件
    ├── contexts/      # 全局 Context
    ├── hooks/         # 公共 Hooks
    ├── models/        # 跨模块共享类型
    ├── modules/       # 功能模块（初始仅 app-shell）
    ├── navigation/    # React Navigation 路由
    ├── services/      # ApiClient / Storage / Config
    ├── theme/         # 颜色、间距、字体 token
    └── utils/         # 工具函数

架构原则

原则	说明
依赖方向	View → ViewModel → Service → Model（单向）
模块隔离	模块内部实现不暴露，通过 `index.ts` 对外
全局≠业务	全局目录只放跨模块能力，业务内容留在模块内
空项目零业务	没有登录、首页、订单、支付、视频等任何业务概念
依赖最小化	初始依赖只有 RN 核心 + Navigation，不预装 Firebase/支付/分析

适用场景

用 AI 工具起新 RN 项目，想要一个干净、规范的起点
团队统一项目骨架，避免每次从旧项目复制
教学 / 团队新人了解模块化 RN 架构
作为项目模板规范，配合脚本自动生成

配合 AI 工具使用

此文档针对 AI 编程助手优化：

Claude Code (/init 或直接粘贴)
Cursor (Composer / Chat)
GitHub Copilot (Chat / Workspace)
OpenAI Codex CLI
Windsurf / Cody / 其他 AI IDE

License

MIT

3.9 KiB Raw Blame History Unescape Escape