Native Styling Boundaries
NativeWind, react-native-css, Tailwind-style classes in React Native, static class safety, design tokens, Reanimated/CSS transition boundaries, and Expo setup.
Operating Contract
Use this skill as a compact router plus domain checklist. Load references only
when the current task matches their condition. Do not cite local scrape paths,
machine cache paths, or hidden source locations. Verify API details against the
target repo's installed package versions before editing.
Source Order
- Inspect the target repo's installed packages, framework/runtime versions,
local design tokens, accessibility policy, and existing motion patterns.
- Use the bundled references below for skill-specific gotchas and copied source
excerpts.
- Use official current docs/package source as API truth when local code or
bundled notes are version-sensitive.
Decision Boundaries
- Use native-motion-core for Reanimated implementation logic.
- Use web-tailwind-motion for browser Tailwind.
- Do not generate untrusted runtime class strings.
Workflow
- Inspect NativeWind/react-native-css versions and Babel/Metro setup.
- Keep classes statically discoverable and token-driven.
- Choose style/class ownership before adding Reanimated or CSS transitions.
- Validate iOS/Android/web behavior where NativeWind support differs.
Gotchas
- Web Tailwind assumptions do not always map to React Native style props.
- Runtime string concatenation can break class extraction and policy.
- Animation ownership should not be split between NativeWind classes and Reanimated shared values.
Bundled Resources
references/nativewind-v4-boundaries.md - NativeWind setup and version boundaries. Read for NativeWind/react-native-css setup and class ownership.references/react-native-css-tailwind.md - React Native CSS and Tailwind compatibility. Read when CSS-like transitions or Tailwind utilities cross native/web boundaries.references/class-safety-and-tokens.md - Native class safety and token policy. Read for dynamic class generation, theme tokens, and design-system constraints.references/nativewind-metro-babel-pipeline.md - NativeWind Metro, Babel, and CSS pipeline. Read when NativeWind classes do not apply, hot reload fails, or setup crosses Expo/Metro/Tailwind config.references/cross-platform-style-differences.md - Cross-platform style and animation differences. Read when a class, transition, transform, color, or layout utility behaves differently on iOS, Android, and web.references/docs-expo-tailwind-setup.md - Copied source excerpt. Load only when exact upstream wording or API detail is needed.references/docs-nativewind-installation.md - Copied source excerpt. Load only when exact upstream wording or API detail is needed.references/index.md - Complete reference inventory and routing summary.references/source-ledger.md - Source list, checked date, and copy policy.references/provenance.json - Machine-readable source and local-resource metadata.scripts/audit.mjs - Self-contained audit CLI; run doctor before scan when setup is unclear.assets/templates/native-styling-boundaries-audit-report.md - Audit response/report template.assets/templates/native-styling-boundaries-review-checklist.md - Manual review checklist.assets/examples/native-styling-boundaries-starter.tsx - Starter fixture/example for this skill.evals/trigger-queries.json - Trigger/near-miss eval set for description tuning.evals/evals.json - Task-quality evals with assertions.
Audit CLI
node scripts/audit.mjs doctor --root . --format json
node scripts/audit.mjs scan --root . --format markdown
node scripts/audit.mjs scan --root . --format json --output native-styling-boundaries-audit.json
Treat script findings as leads. Verify every finding against current code before
changing behavior or reporting it as valid.
Closeout
Before finalizing, run the repo's focused validation command, this skill's audit
CLI when relevant, and any browser/device/manual proof required by the changed
surface. Report commands run, findings fixed, findings skipped with reasons,
and residual risk.
1---2name: native-styling-boundaries3description: Use this skill for NativeWind, react-native-css, Tailwind-style classes in React Native, static class safety, design tokens, Reanimated/CSS transition boundaries, and Expo setup. Trigger on NativeWind, react-native-css, Tailwind React Native, className native, motion-safe native, NativeWind animation. Do not use for near-miss tasks outside these boundaries; route to adjacent motion or platform skills when they own the implementation.4license: MIT5---67# Native Styling Boundaries89NativeWind, react-native-css, Tailwind-style classes in React Native, static class safety, design tokens, Reanimated/CSS transition boundaries, and Expo setup.1011## Operating Contract1213Use this skill as a compact router plus domain checklist. Load references only14when the current task matches their condition. Do not cite local scrape paths,15machine cache paths, or hidden source locations. Verify API details against the16target repo's installed package versions before editing.1718## Source Order19201. Inspect the target repo's installed packages, framework/runtime versions,21 local design tokens, accessibility policy, and existing motion patterns.222. Use the bundled references below for skill-specific gotchas and copied source23 excerpts.243. Use official current docs/package source as API truth when local code or25 bundled notes are version-sensitive.2627## Decision Boundaries2829- Use native-motion-core for Reanimated implementation logic.30- Use web-tailwind-motion for browser Tailwind.31- Do not generate untrusted runtime class strings.3233## Workflow34351. Inspect NativeWind/react-native-css versions and Babel/Metro setup.362. Keep classes statically discoverable and token-driven.373. Choose style/class ownership before adding Reanimated or CSS transitions.384. Validate iOS/Android/web behavior where NativeWind support differs.3940## Gotchas4142- Web Tailwind assumptions do not always map to React Native style props.43- Runtime string concatenation can break class extraction and policy.44- Animation ownership should not be split between NativeWind classes and Reanimated shared values.4546<!-- skill-resources:start -->47## Bundled Resources4849- `references/nativewind-v4-boundaries.md` - NativeWind setup and version boundaries. Read for NativeWind/react-native-css setup and class ownership.50- `references/react-native-css-tailwind.md` - React Native CSS and Tailwind compatibility. Read when CSS-like transitions or Tailwind utilities cross native/web boundaries.51- `references/class-safety-and-tokens.md` - Native class safety and token policy. Read for dynamic class generation, theme tokens, and design-system constraints.52- `references/nativewind-metro-babel-pipeline.md` - NativeWind Metro, Babel, and CSS pipeline. Read when NativeWind classes do not apply, hot reload fails, or setup crosses Expo/Metro/Tailwind config.53- `references/cross-platform-style-differences.md` - Cross-platform style and animation differences. Read when a class, transition, transform, color, or layout utility behaves differently on iOS, Android, and web.54- `references/docs-expo-tailwind-setup.md` - Copied source excerpt. Load only when exact upstream wording or API detail is needed.55- `references/docs-nativewind-installation.md` - Copied source excerpt. Load only when exact upstream wording or API detail is needed.56- `references/index.md` - Complete reference inventory and routing summary.57- `references/source-ledger.md` - Source list, checked date, and copy policy.58- `references/provenance.json` - Machine-readable source and local-resource metadata.59- `scripts/audit.mjs` - Self-contained audit CLI; run `doctor` before `scan` when setup is unclear.60- `assets/templates/native-styling-boundaries-audit-report.md` - Audit response/report template.61- `assets/templates/native-styling-boundaries-review-checklist.md` - Manual review checklist.62- `assets/examples/native-styling-boundaries-starter.tsx` - Starter fixture/example for this skill.63- `evals/trigger-queries.json` - Trigger/near-miss eval set for description tuning.64- `evals/evals.json` - Task-quality evals with assertions.65<!-- skill-resources:end -->6667## Audit CLI6869```bash70node scripts/audit.mjs doctor --root . --format json71node scripts/audit.mjs scan --root . --format markdown72node scripts/audit.mjs scan --root . --format json --output native-styling-boundaries-audit.json73```7475Treat script findings as leads. Verify every finding against current code before76changing behavior or reporting it as valid.7778## Closeout7980Before finalizing, run the repo's focused validation command, this skill's audit81CLI when relevant, and any browser/device/manual proof required by the changed82surface. Report commands run, findings fixed, findings skipped with reasons,83and residual risk.
BjornMelin