Tailwind CSS integration in NextJS

Introduction

Tailwind CSS helps you style your Next.js app quickly using ready-made classes. It saves time and keeps your design consistent.

You want to build a website with a clean, modern look fast.

You prefer writing styles directly in your HTML or JSX without separate CSS files.

You want responsive design that works well on phones and desktops.

You need to customize colors and spacing easily across your app.

You want to avoid writing repetitive CSS code.

Syntax

NextJS

1. Install Tailwind CSS and its dependencies:
   npm install -D tailwindcss postcss autoprefixer

2. Initialize Tailwind config files:
   npx tailwindcss init -p

3. Configure tailwind.config.js to include your files:
   module.exports = {
     content: ["./app/**/*.{js,ts,jsx,tsx}", "./pages/**/*.{js,ts,jsx,tsx}", "./components/**/*.{js,ts,jsx,tsx}"],
     theme: {
       extend: {},
     },
     plugins: [],
   }

4. Add Tailwind directives to your global CSS (e.g., styles/globals.css):
   @tailwind base;
   @tailwind components;
   @tailwind utilities;

The content array tells Tailwind which files to scan for class names.

Use the @tailwind directives in your main CSS file to include Tailwind styles.

Examples

This example adds a custom color named brand to use in your app.

NextJS

/* tailwind.config.js */
module.exports = {
  content: ["./app/**/*.{js,ts,jsx,tsx}"],
  theme: {
    extend: {
      colors: {
        brand: '#1c64f2',
      },
    },
  },
  plugins: [],
}

This CSS file includes all Tailwind styles for your app.

NextJS

/* styles/globals.css */
@tailwind base;
@tailwind components;
@tailwind utilities;

Example JSX using Tailwind classes for background color, text color, padding, and rounded corners.

NextJS

<div className="bg-brand text-white p-4 rounded">
  Welcome to Tailwind CSS in Next.js!
</div>

Sample Program

This is a simple Next.js page using Tailwind CSS classes for layout, colors, and typography. The global CSS imports Tailwind styles.

NextJS

/* tailwind.config.js */
module.exports = {
  content: ["./app/**/*.{js,ts,jsx,tsx}"],
  theme: {
    extend: {},
  },
  plugins: [],
};

/* app/globals.css */
@tailwind base;
@tailwind components;
@tailwind utilities;

/* app/page.jsx */
import './globals.css';

export default function Home() {
  return (
    <main className="flex min-h-screen flex-col items-center justify-center bg-gray-100">
      <h1 className="text-4xl font-bold text-blue-600">Hello, Tailwind CSS!</h1>
      <p className="mt-4 text-gray-700">This is a Next.js app styled with Tailwind.</p>
    </main>
  );
}

Important Notes

Run npm run dev to start your Next.js app and see Tailwind styles applied.

Use browser DevTools to inspect elements and see Tailwind classes in action.

Tailwind works well with responsive design using prefixes like sm:, md:, lg:.

Summary

Tailwind CSS lets you style Next.js apps quickly with utility classes.

Install Tailwind, configure tailwind.config.js, and import styles in your app.

Use Tailwind classes in JSX to build responsive, consistent UI easily.

Practice

1. What is the main purpose of integrating Tailwind CSS in a Next.js project?

easy

A. To handle server-side rendering manually

B. To add backend API routes

C. To manage database connections

D. To quickly style components using utility classes

Solution

1. Step 1: Understand Tailwind CSS role

   Tailwind CSS provides utility classes for styling UI elements quickly without writing custom CSS.

2. Step 2: Relate to Next.js integration

   In Next.js, Tailwind is used to style components easily, not for backend or rendering logic.

3. Final Answer:

   To quickly style components using utility classes -> Option D

4. Quick Check:

   Tailwind CSS = Utility-first styling [OK]

Hint: Tailwind is for styling, not backend or rendering [OK]

Common Mistakes:

• Confusing Tailwind with backend or API features
• Thinking Tailwind manages server rendering
• Assuming Tailwind handles database

2. Which file must you import Tailwind's base styles into for a Next.js project?

easy

A. next.config.js

B. tailwind.config.js

C. pages/_app.js or app/layout.js

D. package.json

Solution

1. Step 1: Identify where global styles go in Next.js

   Global CSS imports happen in pages/_app.js for pages router or app/layout.js for app router.

2. Step 2: Understand Tailwind import location

   Tailwind's base styles are imported in these files to apply styles app-wide.

3. Final Answer:

   pages/_app.js or app/layout.js -> Option C

4. Quick Check:

   Global CSS import = _app.js or layout.js [OK]

Hint: Import Tailwind CSS in your main app wrapper file [OK]

Common Mistakes:

• Trying to import styles in tailwind.config.js
• Importing in next.config.js which is config only
• Adding styles in package.json which is metadata

3. Given this Next.js component using Tailwind CSS, what color will the button text be?

export default function Button() {
  return <button className="text-red-500 hover:text-blue-500">Click me</button>;
}

medium

A. Red text that turns blue on hover

B. Blue text that turns red on hover

C. Always blue text

D. Always red text with no hover effect

Solution

1. Step 1: Analyze the Tailwind classes

   The button has text-red-500 which sets text color red initially, and hover:text-blue-500 which changes text color to blue on hover.

2. Step 2: Understand hover behavior

   When the mouse is over the button, the text color changes to blue; otherwise, it stays red.

3. Final Answer:

   Red text that turns blue on hover -> Option A

4. Quick Check:

   text-red-500 + hover:text-blue-500 = red then blue on hover [OK]

Hint: Hover classes override base styles on mouse over [OK]

Common Mistakes:

• Ignoring hover prefix and thinking text is always blue
• Confusing initial and hover colors
• Assuming no color change on hover

4. You added Tailwind CSS to your Next.js app but styles are not applying. What is a likely cause?

medium

A. You forgot to import 'tailwind.css' in your main app file

B. You didn't install React correctly

C. You used invalid JSX syntax in components

D. You didn't restart the Next.js server after installing Tailwind

Solution

1. Step 1: Check Tailwind CSS import

   If Tailwind styles are missing, often the CSS file with Tailwind directives is not imported in _app.js or layout.js.

2. Step 2: Consider other causes

   While restarting server helps, missing import is the primary cause. React install or JSX errors cause different issues.

3. Final Answer:

   You forgot to import 'tailwind.css' in your main app file -> Option A

4. Quick Check:

   Missing Tailwind import = no styles [OK]

Hint: Always import Tailwind CSS file in your main app file [OK]

Common Mistakes:

• Assuming React install affects Tailwind styles
• Ignoring missing CSS import
• Not restarting server but that alone won't fix missing styles

5. You want to create a responsive Next.js component using Tailwind CSS that shows a green background on small screens and blue on medium and larger screens. Which class combination achieves this?

hard

A. "bg-blue-500 md:bg-green-500"

B. "bg-green-500 md:bg-blue-500"

C. "md:bg-green-500 bg-blue-500"

D. "bg-green-500 bg-blue-500 md:bg-green-500"

Solution

1. Step 1: Understand Tailwind responsive prefixes

   Classes without prefix apply to all screen sizes. Prefix md: applies styles at medium screens and above.

2. Step 2: Apply background colors correctly

   To have green on small screens, use bg-green-500. To override with blue on medium+, use md:bg-blue-500.

3. Final Answer:

   "bg-green-500 md:bg-blue-500" -> Option B

4. Quick Check:

   Small = green, Medium+ = blue with md: prefix [OK]

Hint: Use base class for small, md: prefix for medium+ [OK]

Common Mistakes:

• Reversing colors with md prefix
• Using multiple base classes causing conflicts
• Not understanding responsive prefixes