用途:该技能整理 Grey Haven Studio 在 React 19 应用中使用 TanStack 生态的实践模式,用于构建 TanStack Start 全栈应用、实现 TanStack Router 路由、用 TanStack Query 管理服务端状态、创建服务端函数、优化查询缓存以及实现多租户数据访问。
主要能力:文件式路由结构约定,如 __root.tsx 根布局、_authenticated/ 下划线前缀保护路由组、_layout.tsx 布局包装、$param.tsx 动态参数;QueryClient 默认配置,staleTime 默认 60000 毫秒、retry 为 1、关闭窗口聚焦重取;查询键从具体到通用的命名模式;服务端函数始终包含 tenant_id 参数以做多租户隔离;路由 loader 在渲染前于服务端取数;mutation 成功后失效相关查询。缓存策略按数据类型给出 staleTime:认证 5 分钟、用户资料 1 分钟、列表 1 分钟、静态配置 10 分钟、实时数据 0。
使用方式:资料提供 examples、reference、templates、checklists 等配套文档与模板,包括 root-route.tsx、auth-layout.tsx、page-route.tsx、server-function.ts、custom-hook.ts 等可复制模板,以及 tanstack-checklist.md 提交前检查清单。具体安装命令与调用方式暂未提供。
适用场景:构建 TanStack Start 应用、实现路由与认证保护、管理服务端状态、创建取数服务端函数、优化查询性能、实现多租户访问、构建数据密集型 React 应用。
限制:资料未说明支持的版本范围、依赖安装步骤、收费或授权方式;示例基于 Grey Haven 生产模板 cvi-template,服务端函数依赖启用 RLS 的数据库连接。