Skip to content

Latest commit

 

History

History
101 lines (69 loc) · 2.36 KB

readme.md

File metadata and controls

101 lines (69 loc) · 2.36 KB

React Native Expo + NativeWind Starter Template

This is a starter template for building mobile applications using React Native, Expo, and NativeWind. This setup provides a streamlined development environment for building cross-platform apps with Tailwind CSS styling through NativeWind.

Features

  • React Native with Expo for seamless cross-platform development
  • NativeWind for Tailwind CSS styling in React Native
  • Expo for easy setup and fast development with managed workflows
  • TypeScript support for type-safe code (if enabled)

Prerequisites

Make sure you have the following installed:

  • Node.js (v14 or newer)
  • npm or pnpm package manager
  • Expo CLI: Install via npm install -g expo-cli

Getting Started

1. Clone the Repository

git clone https://github.com/MasFana/Nativewind-Starter
cd Nativewind-Starter

2. Install Dependencies

Use npm to install the necessary dependencies:

npm install

OR

Use pnpm to install the necessary dependencies:

pnpm install

3. Start the Development Server

Launch the Expo development server with:

npm start

OR

pnpm start

This will start the Expo development environment, where you can preview the app on an emulator or physical device.

Project Structure

.
├── App.jsx             # Main application entry
├── assets/            # Asset files (images, fonts, etc.)
├── components/        # Reusable components
├── screens/           # Screen components for navigation
└── tailwind.config.js # Tailwind CSS configuration for NativeWind

Configuration

Tailwind CSS with NativeWind

  1. Configure Tailwind CSS in tailwind.config.js:

    // tailwind.config.js
    module.exports = {
      content: [
        "./App.js",
        "./screens/**/*.{js,jsx,ts,tsx}",
        "./components/**/*.{js,jsx,ts,tsx}"
      ],
      theme: {
        extend: {},
      },
      plugins: [],
    }
  2. NativeWind is already configured to support Tailwind classes in your React Native components. Use Tailwind classes as usual in your components.

  3. Optional you can install Tailwind CSS IntelliSense Extension in VSCode

Scripts

  • pnpm start - Start the Expo development server
  • pnpm build - Build the app for production