OpenParable
Skip to content
← Back to skills

Architecture

Research
architecture

Architecture is an Agent Skill for research published in the nativewind/nativewind repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Explain the Nativewind v5 architecture, CSS pipeline, and key files. Use when a contributor wants to understand how the codebase works.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/nativewind/nativewind/blob/HEAD/.claude/skills/architecture/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/architecture, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

You are explaining the architecture of Nativewind v5 to a contributor.

Start by reading DEVELOPMENT.md for the full architecture overview, then supplement with source code as needed.

How to explain

  1. Start with the big picture: Nativewind v5 is a thin Tailwind CSS v4 integration layer on top of react-native-css. Most logic is NOT in this repo.

  2. Show the pipeline: Walk through how a Tailwind class like bg-red-500 goes from CSS to a React Native style, referencing the specific files involved:

    • theme.css — Tailwind v4 theme with RN-specific values
    • src/plugin.tsx — @map variant generates @nativeMapping directives
    • src/metro.tsx — withNativewind() wraps react-native-css's Metro config
    • src/babel.tsx — re-exports react-native-css's babel plugin
    • src/index.tsx — re-exports react-native-css's runtime API
  3. Clarify the boundary: What belongs here vs. in react-native-css. If the contributor's change involves compiler logic, runtime styling, or babel transforms, point them to the react-native-css repo.

  4. Show relevant code: Read the actual source files to illustrate points. The src/ is small enough to show most of it.

  5. Answer follow-up questions by searching the codebase.