Blue and purple background graphics

Adding Tailwind CSS to Nuxt 3 🍃 (2023)

January 3, 2023 · Nuxt 3

Getting started with Tailwind CSS for utility-first styling.

Introduction

In this post, we'll introduce Nuxt Tailwind, a package for the Tailwind CSS library.

Tailwind is a powerful tool for rapidly styling modern web applications.

Utility-first CSS

Utility-first CSS is a design approach that uses pre-defined classes to style HTML elements. We refer to these classes as utilities.

One of the main advantages of utility-first CSS is that it allows you to style elements quickly without coupling them to custom CSS through stylesheets. This approach can be difficult to maintain when an app grows bigger.

You may argue that this will lead to code repetition, but when combined with component-based web frameworks (e.g. React, Vue), repetition is minimised while still keeping elements decoupled from stylesheets.

Tailwind

Tailwind isn't just a fantastic way of writing CSS; it's also great to build with, due to a variety of development features:

  • Easy configuration of built-in utilities
  • Just-in-time compiler to avoid build times entirely
  • Many great plugins available (typography, forms, etc.)

Installation

Official documentation for using Tailwind with Nuxt can be found here.

Install the package:

yarn add --dev @nuxtjs/tailwindcss

Add the module to your Nuxt configuration:

// nuxt.config.ts

export default defineNuxtConfig({
  // ...
  modules: [
    // ...
    '@nuxtjs/tailwindcss',
  ],
})

And just like that, you can now start adding Tailwind classes to your Nuxt components!

Prettier integration

If you're using Prettier from earlier in the series, you should also add its Tailwind plugin:

yarn add --dev prettier-plugin-tailwindcss

This will give you automatic class sorting which is incredibly useful for organisation, especially when using lots of classes in one element (e.g. hover:, dark:). It should work automatically thanks to Prettier’s autoloading convention.

Classes

To get started, add some of Tailwind's in-built utilities to an element's class attribute.

<template>
  <NuxtLink
    to="/"
    class="font-semibold text-gray-50 hover:text-gray-400 duration-100"
  >
    Home
  </NuxtLink>
</template>

New to Tailwind? Your best bet is to check out the Tailwind docs.

Configuration

Create a tailwind.config.js file at the root of your project to configure the default theme.

module.exports = {
  theme: {
    screens: {
      sm: '640px',
      md: '768px',
      lg: '1024px',
      xl: '1280px',
    },
    extend: {
      colors: {
        linkedin: {
          primary: '#0A66C2',
          lighter: '#378fe9',
          darker: '#004182',
        },
      },
    },
  },
  plugins: [require('@tailwindcss/typography')],
}

Viewer

Nuxt Tailwind exposes a /_tailwind/ route in development where your Tailwind configuration is rendered as a library.

May your web apps become colourful and flashy 😉


Hey, guys! Thank you for reading. I hope that you enjoyed this.

Keep up to date with me: