About nativewind
A skill for styling React Native components with NativeWind v5 and Tailwind CSS v4. It covers setup, configuration, platform-specific behavior, theming, and migration guidance.
Key features
- 01Apply Tailwind styles with className
- 02Configure CSS-first themes and utilities
- 03Use platform and responsive variants
- 04Style states and dark mode
- 05Integrate third-party components
- 06Migrate from v4 to v5
Use cases
- 01Style React Native components across platforms
- 02Configure responsive layouts and dark mode
- 03Adapt third-party components to className styling
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/nativewindin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
GENERATION.mdreferences/advanced-migrate-v4.mdadvanced-theme.mdapi-css-interop-remap.mdapi-styled.mdapi-vars-runtime.mdapi-with-nativewind.mdbest-practices-performance.mdbest-practices-v5-deprecations.mdcore-config.mdcore-setup.mdcore-v5-functions-directives.mdcore-v5-style-specificity.mdcore-v5-tailwind-foundation.mdcore-v5-units.mdfeatures-platform.mdfeatures-states.mdfeatures-styling.mdfeatures-v5-responsive.mdfeatures-v5-states-pseudo.mdfeatures-v5-third-party-guide.mdDetails
From the project READMESkill is based on NativeWind v5 (Tailwind CSS v4), generated at 2026-02-26.
NativeWind compiles Tailwind CSS for React Native: className on components, StyleSheet.create on native and reuse of the Tailwind stylesheet on web. It supports media/container queries, pseudo-classes (hover, focus, active), platform variants (ios:, android:, native:, web:), dark mode, and custom theme/utilities via CSS-first config.
Core References
| Topic | Description | Reference |
|---|---|---|
| Setup | CSS file, Metro withNativewind, PostCSS, app entry, optional lightningcss pin | core-setup |
| Configuration | CSS-first config, @theme, @source, nativewind/theme, custom utilities/variants | core-config |
| v5 Tailwind foundation | Built on Tailwind v4, CSS-first, web vs native support | core-v5-tailwind-foundation |
| v5 Units | px, %, vw/vh, rem, em on native; dp vs px; rem sizing | core-v5-units |
| v5 Functions & directives | @import, @theme, @utility; var(), calc(), env(), color-mix(); RN functions | core-v5-functions-directives |
| v5 Style specificity | Order of precedence, !important, merging className and style | core-v5-style-specificity |
Features
| Topic | Description | Reference |
|---|---|---|
| Styling components | className usage, custom vs third-party, styled() / cssInterop / remapProps, nativeStyleToProp | features-styling |
| Platform & responsive | Platform variants, units, breakpoints, safe-area utilities | features-platform |
| v5 Responsive | Breakpoints on native, media queries, platform media, reactive updates | features-v5-responsive |
| States & dark mode | hover/focus/active, disabled/empty, group modifiers, dark:, data attributes | features-states |
| v5 States & pseudo-classes | Detailed pseudo-class table, selection/placeholder, group, ltr/rtl | features-v5-states-pseudo |
| v5 Third-party guide | When className isn't passed, multiple style props, dynamic mapping @prop | features-v5-third-party-guide |
| Theming & colors | @theme tokens, vars() for runtime CSS variables, color behavior | advanced-theme |
API (v5)
| Topic | Description | Reference |
|---|---|---|
| withNativewind | Metro wrapper options (globalClassNamePolyfill, typescriptEnvPath) | api-with-nativewind |
| styled | Third-party components, nativeStyleToProp, multiple className props | api-styled |
| vars & runtime variables | vars(), VariableContextProvider, useUnstableNativeVariable | api-vars-runtime |
| cssInterop / remapProps | Legacy API (deprecated; use styled) — migration reference | api-css-interop-remap |
Advanced
| Topic | Description | Reference |
|---|---|---|
| Migrate v4 → v5 | Steps, breaking changes, deprecations | advanced-migrate-v4 |
Best Practices
| Topic | Description | Reference |
|---|---|---|
| Correctness & debugging | Explicit light/dark, colors on Text not View, cache, DEBUG, verifyInstallation | best-practices-performance |
| v5 Deprecations | useColorScheme → RN, cssInterop/remapProps → styled, @prop modifier | best-practices-v5-deprecations |
Comments
Markdown supported