expo-tailwind-setup

Configure Expo projects with Tailwind CSS v4 and NativeWind v5.

1|Updated Dec 7, 2025
One-click install
npx skills add https://github.com/treesus6/SkateQuest-Mobile --skill expo-tailwind-setup-treesus6
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: expo-tailwind-setup
Source: https://github.com/treesus6/SkateQuest-Mobile/tree/main/.agents/skills/expo-tailwind-setup
Command: npx skills add https://github.com/treesus6/SkateQuest-Mobile --skill expo-tailwind-setup-treesus6

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Expo-based projects often struggle to achieve consistent, scalable styling across iOS, Android, and Web. This Skill provides a complete Tailwind v4 setup for Expo using react-native-css and NativeWind v5, delivering a unified design system for cross-platform development.

Core Features & Use Cases

  • Unified styling: Tailwind utilities wired into Expo projects via react-native-css and NativeWind.
  • Cross-platform workflow: Metro and PostCSS configurations, global CSS, and platform-aware fonts for mobile and web.
  • Use Case: Quickly bootstrap a new Expo project with Tailwind support to enable rapid UI iteration and consistent theming.

Quick Start

Create or upgrade an Expo project and apply the provided Tailwind v4 + NativeWind v5 setup to enable universal styling.

Frequently Asked Questions about expo-tailwind-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up Tailwind CSS in an Expo project for iOS, Android, and web?

Setting up Tailwind CSS in an Expo project requires configuring Metro and PostCSS with NativeWind v5 and react-native-css to enable cross-platform styling. This Skill provides the necessary global CSS and platform-aware fonts setup for universal UI consistency.

Does NativeWind v5 work with Tailwind CSS v4 in Expo?

Yes, NativeWind v5 works with Tailwind CSS v4 in Expo by utilizing a postcss.config.mjs file supporting @tailwindcss/postcss. This configuration wires Tailwind utilities directly into the React Native styling pipeline for cross-platform development.

What's the best way to configure PostCSS for Expo Tailwind styling?

The best way to configure PostCSS for Expo Tailwind styling is using a postcss.config.mjs file that supports @tailwindcss/postcss. This setup bridges Tailwind v4 utilities with NativeWind v5 and react-native-css across mobile and web platforms.

Why do I need react-native-css for my Expo Tailwind setup?

You need react-native-css for your Expo Tailwind setup because it processes the global CSS output and wires Tailwind utilities directly into the React Native rendering pipeline. Combined with NativeWind v5, it ensures consistent styling across iOS, Android, and web.

Can I use platform-specific fonts with Tailwind in a React Native app?

Yes, you can use platform-specific fonts with Tailwind in a React Native app by configuring platform-aware fonts within the Expo Metro and PostCSS setup. This ensures correct font rendering across iOS, Android, and web environments.

What are the limitations of using Tailwind v4 with NativeWind in Expo?

Using Tailwind v4 with NativeWind in Expo requires strict adherence to specific dependency versions, including NativeWind v5 and react-native-css. Projects must also maintain a specific Metro and PostCSS configuration to ensure cross-platform styles render correctly without breaking.