v0.0.1

常见问题

样式缺失、Next.js、组件更新与性能等常见问题。

#从包导入还是用 CLI 拷贝？

不打算改源码就从包导入，升级只需更新版本；需要深度定制就用 CLI 拷贝，源码归你所有。两种方式可以混用，详见介绍。

#组件没有样式，或动画时长不对？

检查是否在入口引入了 @elyri/motion/styles.css（UI 组件为 @elyri/ui/styles.css）。它定义了组件依赖的全局变量，缺失时时长、配色等会失效。

#能在 Next.js App Router 中使用吗？

可以。组件使用了 hooks 与浏览器 API，需要在客户端组件中渲染：在使用它们的文件顶部加上 'use client'，或者给 CLI 拷贝出来的组件文件加上。

HeroBackground.tsx
'use client';

import { Aurora } from '@elyri/motion';

export function HeroBackground() {
  return <Aurora />;
}

#如何更新用 CLI 拷贝的组件？

先把包升级到最新版本，再执行 elyri add <组件> --overwrite。覆盖会丢弃本地修改，建议先提交，再用 diff 把需要的改动合并回来。

#支持哪些 React 版本？

React 18 与 19。

#页面上放多个 WebGL 背景会卡吗？

离开视口的背景会暂停渲染，后台标签页也会暂停，因此只有可见的背景在消耗 GPU。仍建议同一屏只放一个重型背景，并在移动端适当降低 参数（如速度、密度）。

#发现问题或想要新组件？

欢迎在 GitHub 仓库 提交 Issue 或 Pull Request。