DEV Community

Cover image for How to setup Tailwind CSS in Vue 3
Suresh Ramani
Suresh Ramani

Posted on • Originally published at techvblogs.com

How to setup Tailwind CSS in Vue 3

Tailwind CSS is one of the newest and coolest utility libraries on the block, and it lets you build UI components with ease. Here’s a quick guide on how to set up Tailwind in your Vue 3 project.

Tailwind CSS isn't the first utility-first CSS library, but at the moment it is safe to say it's becoming the most popular among developers.

Installing Tailwind varies depending on your project's framework (React, Nuxt.js, Vue.js, Next.js, Gatsby, Laravel) making it available over a pretty wide range of frameworks which I think even makes it cooler!.

This is a quick tutorial to show how tailwind can be configured in a fresh Vue 3 application.

Create a new Vue app

Assuming npm is installed, make sure you have the vue cli installed too:

npm install -g @vue/cli
Enter fullscreen mode Exit fullscreen mode

Next, create a new Vue project using the vue cli command:

vue create vue3-tailwind
Enter fullscreen mode Exit fullscreen mode

Navigate to the project directory:

cd vue3-tailwind
Enter fullscreen mode Exit fullscreen mode

Setup Tailwind CSS in Vue 3

Next, we’d need to install tailwind and its dependencies (PostCSS & auto-prefixer).

npm install -D tailwindcss@latest postcss@latest autoprefixer@latest
Enter fullscreen mode Exit fullscreen mode

Or using yarn:

yarn add --dev tailwindcss@latest postcss@latest autoprefixer@latest
Enter fullscreen mode Exit fullscreen mode

Note: if you’re faced with this error:

Error: PostCSS plugin tailwindcss requires PostCSS 8.
You would need to install a different build of tailwind that supports PostCSS 7.

npm uninstall tailwindcss postcss autoprefixer
npm install -D tailwindcss@npm:@tailwindcss/postcss7-compat @tailwindcss/postcss7-compat postcss@^7 autoprefixer@^9
Enter fullscreen mode Exit fullscreen mode

Generate the Tailwind and post CSS configuration files.

npx tailwindcss init -p
Enter fullscreen mode Exit fullscreen mode

This will create two files in your root directory: tailwind.config.js and postcss.config.js. The Tailwind config file is where you add in customization and theming for your app. It is also where you tell Tailwind what paths to search for your pages and components. It looks something like this:

// tailwind.config.js
module.exports = {
  purge: [],
  darkMode: false, // or 'media' or 'class'
  theme: {
    extend: {},
  },
  variants: {
    extend: {},
  },
  plugins: [],
}
Enter fullscreen mode Exit fullscreen mode

We won’t go into explaining each of those properties; however, we need to update the "purge" property to include the path to our components and pages.

// tailwind.config.js
module.exports = {
  purge: ['./index.html', './src/**/*.{vue,js,ts,jsx,tsx}'],
  darkMode: false, // or 'media' or 'class'
  theme: {
    extend: {},
  },
  variants: {
    extend: {},
  },
  plugins: [],
}
Enter fullscreen mode Exit fullscreen mode

Next, create a folder called "styles", and within that folder, create an entry CSS file (app.css):

mkdir src/styles && touch src/styles/app.css
Enter fullscreen mode Exit fullscreen mode

We’ll import Tailwind’s styles using the @tailwinddirective within our entry CSS file:

/* ./src/styles/app.css */
@tailwind base;
@tailwind components;
@tailwind utilities;
Enter fullscreen mode Exit fullscreen mode

Finally, import your entry CSS file into your entry Javascript file (main.js):

import { createApp } from 'vue';
import App from './App.vue';
import './styles/app.css'; // Here

createApp(App).mount('#app');
Enter fullscreen mode Exit fullscreen mode

Spin up your server and start using Tailwind’s goodness in your Vue 3 application. Try updating the App.vue component like so:

<template>
  <div class="justify-center flex bg-yellow-300 items-center h-screen">
    <div class="text-4xl">
      Hello Vue 3 + Tailwind CSS
    </div>
  </div>
</template>

<script>
export default {
  name: 'App',
};
</script>
Enter fullscreen mode Exit fullscreen mode

In the Last Step, Run Following Command to Start Application:

npm run serve
Enter fullscreen mode Exit fullscreen mode

Thank you for reading this article.

Discussion (0)