React: how to use Tailwind

  • React
  • Gabriele Romanato

Tailwind CSS is a CSS class utility framework that makes it easy to design and create responsive and stylized user interfaces. Integrating Tailwind into a React project is a relatively simple process that can significantly improve developer productivity. In this article, we will explore the basic steps to integrate Tailwind CSS into a React application.

Install Tailwind CSS

To install Tailwind CSS in your React project, run the following command in the project directory:


npm install tailwindcss --save

Configure Tailwind

After installing Tailwind, you need to set up your project. You can do this by creating a configuration file. Run the following command to generate a basic configuration file:


npx tailwindcss init

This command will create a file called tailwind.config.js in the root of your project.

Configure PostCSS

Tailwind uses PostCSS to process CSS files. Install PostCSS and the necessary plugins with the following command:


npm install postcss postcss-cli postcss-preset-env

Create a postcss.config.js file in the root of your project with the following contents:


module.exports = {
   plugins: {
     'postcss-preset-env': {
       autoprefixer: {
         flexbox: 'no-2009',
       },
       stages: 3,
     },
     tailwindcss: {},
   },
};

Configuring CSS Files

Create a new CSS file in your src directory (for example, src/styles/tailwind.css) and import Tailwind using @import:


/* src/styles/tailwind.css */

@import 'tailwindcss/base';
@import 'tailwindcss/components';
@import 'tailwindcss/utilities';

/* More custom styles can be added here */

Add NPM Script

Edit your package.json file by adding the following scripts:


"scripts": {
   "build:css": "postcss src/styles/tailwind.css -o src/styles/index.css",
   "start": "react-scripts start",
   "build": "react-scripts build",
   "test": "react-scripts test",
   "eject": "react-scripts eject"
}

These scripts will allow you to compile your Tailwind styles and launch your React application.

Using styles

You can now use your Tailwind styles in React components by importing the generated CSS file (src/styles/index.css).


// src/App.js

import React from 'react';
import './styles/index.css';

function App() {
   return (
     <div className="bg-gray-200 p-4">
       <h1 className="text-3xl font-bold text-blue-500">Welcome to React with Tailwind</h1>
       <p className="text-gray-700">Hello world!</p>
     </div>
   );
}

export default App;

With these steps, you have successfully integrated Tailwind CSS into your React project, allowing you to take advantage of class utilities for faster, more efficient design. Customize your styles, explore Tailwind's features, and enjoy a smoother development workflow.

Back to top