用途:为现代 React 开发提供综合规范,覆盖组件与页面创建、新功能搭建、TanStack Query 数据获取、TanStack Router 路由、MUI v7 样式、性能优化、前端代码组织与 TypeScript 最佳实践。
主要能力:组件模式采用 React.FC<Props>、React.lazy() 代码分割、SuspenseLoader 加载态、具名 const 加默认导出;数据获取以 useSuspenseQuery 为主,配合 Suspense 边界与缓存优先策略;文件组织区分 features/(领域专属)与 components/(真正可复用),功能目录含 api/、components/、hooks/、helpers/、types/;样式按行数决定内联或独立 .styles.ts,使用 sx 与 SxProps<Theme>;路由基于目录,使用 createFileRoute 并懒加载;性能上使用 useMemo、useCallback、React.memo 与防抖搜索;TypeScript 要求严格模式、禁用 any、显式返回类型与 import type。
使用方式:按新组件与新功能清单执行;导入别名使用 @/、~types、~components、~features(定义于 vite.config.ts);加载态统一用 SuspenseLoader,禁止提前 return 加载动画;用户通知使用 useMuiSnackbar,不使用 react-toastify;MUI v7 Grid 使用 size={{ xs: 12, md: 6 }} 语法。
适用场景:新建组件或页面、搭建功能、数据获取、路由配置、MUI 样式、性能优化与代码组织。
限制:资料未提供安装命令、版本要求、收费信息与具体平台支持;部分细节需查阅对应 resources 文档。