代码风格、提交规范和项目约定
本指南介绍项目的代码规范和开发约定。
项目使用 Biome 2.x 统一处理 linting 和 formatting,替代 ESLint + Prettier。
根目录 biome.json:
项目使用 commitlint + lefthook 强制 conventional commits。
使用 import type 导入类型:
使用 React.ComponentProps 继承原生属性:
需要交互的组件添加 "use client":
默认使用服务端组件,无需特殊标记:
useSortedClasses 自动处理cn() 函数合并条件类名使用 .dark class 策略,通过 next-themes 管理。所有颜色 token 自动适配。
**/src/**/*.test.{ts,tsx}/// <reference types="vitest/globals" /> 获得全局类型e2e/ 目录e2e/web/、e2e/blog/、e2e/docs/ 等PLAYWRIGHT_BASE_URL 环境变量切换目标应用