这些准则定义了指导每个 TanStack 库和产品的核心原则。它们既是开发者对我们的工具的期望质量标准,也是评估贡献、特性和想法的参考。
这些准则补充了我们的 组织准则,涵盖我们的业务价值观和独立性。两者结合,确保 TanStack 始终致力于构建能够让网络对开发者更友好的工具——按照您的意愿,毫不妥协。
每个 TanStack 库都从一个与提供者无关的核心开始,确保开发者永远不会被锁定到特定的供应商、平台或生态系统。集成作为可选的适配器分层在其之上——绝不会作为基础。
这排除了什么
我们构建专注、可组合的原始组件,拥抱平台而不是隐藏它。每个库都应该能够逐步采用,而无需重写或创建对其他 TanStack 工具的硬依赖。
这排除了什么
我们围绕现实世界的生产用例、边缘情况和长期应用程序进行设计——而不仅仅是理想化的演示。性能和可扩展性是要求,而不是锦上添花。
这排除了什么
我们最大限度地减少魔法并最大限度地提高清晰度。状态、副作用和数据流应该从代码中理解,而不是从隐藏行为中猜测。类型安全应该指导正确的使用,而不会让用户淹没在泛型中。
这排除了什么
这些准则为不同的受众提供多种用途
这些准则定义了您可以期望从我们的库中获得的内容——质量、可移植性和对您自由组合和部署的承诺。
在提出特性或更改时,请考虑它们与这些准则的对齐程度。如果您的想法与准则冲突,请明确说明原因以及如何证明冲突是合理的。
在评估 PR、功能请求和架构决策时,将这些准则用作检查清单。如果某件事威胁到准则,则需要强有力的理由或应该被拒绝。
这些准则确保我们的库保持中立和以开发者为中心。合作伙伴集成必须尊重这些原则,并且不能将核心 API 偏向于特定的平台或供应商。
这些准则与我们的 组织准则一起工作,涵盖我们的业务独立性、可持续性和对开放网络的承诺。两者结合,确保 TanStack 始终坚持其使命:构建能够让网络对开发者更友好的工具——按照您的意愿。