SuperAPI AI 工具集

migrate-nativewind-to-uniwind

通用与其它

查看项目

更新于 10-16 07:21

技能介绍

用途:指导把 React Native 项目从 NativeWind 迁移到 Uniwind。Uniwind 需要 Tailwind CSS 4,改用基于 CSS 的主题,而非 JS 配置。

主要能力与流程:迁移前检查 package.json、tailwind.config、metro.config、babel.config、global.css 及 nativewind 类型文件等;卸载 nativewind 与 react-native-css-interop,安装 uniwind 与 tailwindcss@latest,确保 Tailwind 为 4+;移除 babel 的 nativewind/babel 预设;用 uniwind/metro 的 withUniwindConfig 替换 NativeWind 的 metro 包装,cssEntryFile 必须是相对路径字符串,并按需设置 polyfills.rem 为 14 以匹配 NativeWind 的 rem,自定义主题通过 extraThemes 注册(不含 light/dark);把 global.css 的 @tailwind 指令换成 @import 'tailwindcss' 与 @import 'uniwind',并在 App 组件而非根 index 中导入以保留热重载;删除 nativewind 类型文件与 tailwind.config,主题值迁到 CSS @theme;用 withUniwind 替换 cssInterop/remapProps(仅针对第三方组件,需在模块级包装一次,不要用于 react-native/reanimated 自带组件);非 style 颜色属性用 accent- 前缀配合 ClassName;把 vars() 主题迁移为 @layer theme 中的 @variant,各主题变量集合需一致,局部主题预览可用 Uniwind Pro 的 ScopedTheme;安全区需结合 SafeAreaListener 调用 Uniwind.updateInsets;不自动去重 className,可引入 tailwind-merge 与 clsx 的 cn 工具,important 修饰符仍受支持;animated- 类行为需改为显式使用 react-native-reanimated,OSS 版不提供;最后全局搜索清理 nativewind 残留。

适用场景与限制:适用于迁移已有 NativeWind 项目。文档还列出 useUniwind、Uniwind 静态 API、useResolveClassNames、useCSSVariable、CSS 函数与平台选择器等 API。具体收费、价格与平台支持等事实资料未完整提供。