SuperAPI AI 工具集

react-bits

前端与建站

查看项目

更新于 10-15 19:53

技能介绍

用途:该技能面向 react-bits(DavidHDev/react-bits)动画 React 组件库,提供集成、定制与贡献方面的指导。适用于需要将文本动画、背景特效、交互式 UI 等创意动画组件引入 React/Next.js 项目,或调试、修改现有组件(如调整 GSAP 时间线、Three.js 画布、Tailwind 类名),以及向仓库提交新组件。标准非动画 UI 组件或对包体积有严格限制、无法承载 Three.js、GSAP、Framer Motion 的项目不建议使用。

主要能力与用法:项目技术栈为 React、Vite、Tailwind CSS v4、GSAP、Three.js(@react-three/fiber、@react-three/drei)、Framer Motion 与 jsrepo 注册表。常用脚本:npm run dev 同时运行 jsrepo build --watch 与 Vite 文档服务;npm run build 构建注册表并生成 LLMs 文本、站点地图与 Vite 站点;npm run new:component 通过 scripts/generateComponent.js 生成组件模板;npm run lint 与 npm run format 分别用 ESLint、Prettier 检查与格式化。集成时先从目录选定组件,安装对应 peer 依赖(如 gsap、motion、@react-three/fiber、lucide-react),再复制源码或通过 jsrepo 安装。

限制与注意:定制 GSAP 动画时应在 useLayoutEffect 或 @gsap/react 的 useGSAP 中清理时间线,避免 React 18/19 Strict Mode 下内存泄漏与重复触发;Three.js 的 Canvas 需正确设置尺寸并在卸载时释放 WebGL 上下文;组件应自包含,避免引用 jsrepo 安装后不可用的内部工具;贡献时用 npm run new:component 脚手架,在 src/components/ 下实现,本地验证后运行 lint 与 format,并以 feat/<feature-name> 分支向 main 提交 PR。具体收费、平台与效果资料暂未提供。