DEV Community

Cover image for How to use Tailwind CSS in Astro
Chris Bongers
Chris Bongers

Posted on • Originally published at


How to use Tailwind CSS in Astro

To be honest, it's never been easier to include Tailwind CSS in a framework.

Why? Astro has build in support for Tailwind! 🥳
And yes, even the Tailwind JIT compiler.

I'll write down this quick guide to get you started setting up Tailwind CSS in an Astro project.

Installing Tailwind CSS in an Astro project

Let's start with a basic Astro project.

mkdir astro-tailwind && cd astro-tailwind
npm init astro
Enter fullscreen mode Exit fullscreen mode

You can choose any of the templates. It doesn't matter, actually.

Now let's install Tailwind CSS.

npm install -D tailwindcss
Enter fullscreen mode Exit fullscreen mode

The next step is to create a tailwind.config.js file to tell Tailwind which files to purge and enable the JIT compiler.

module.exports = {
  mode: 'jit',
  purge: ['./public/**/*.html', './src/**/*.{astro,js,jsx,ts,tsx,vue}'],
Enter fullscreen mode Exit fullscreen mode

Then we can Astro that it should use this Tailwind config file by modifying the astro.config.js file and add this to the devOptions section.

devOptions: {
  tailwindConfig: './tailwind.config.js';
Enter fullscreen mode Exit fullscreen mode

Now edit the global.css file in the public/style directory.

@tailwind base;
@tailwind components;
@tailwind utilities;
Enter fullscreen mode Exit fullscreen mode

Let's modify our src/pages/index.astro to test out how it works.

<div class="bg-gradient-to-br from-indigo-900 to-green-900 min-h-screen overflow-auto">
  <div class="container max-w-5xl mx-auto px-4">
    <div class="w-4/5 mx-auto">
      <h1 class="mt-32 text-white text-6xl font-bold">
        <img width="60" height="80" src="/assets/logo.svg" alt="Astro logo" /> Welcome to
        <a href="">Astro</a>
    <div class="w-4/5 my-10 mx-auto">
      <h3 class="text-gray-300">
        Build faster websites with less
        <strong class="text-white">client-side Javascript</strong>
        <br />
        This is how easy it is to get started
    <div class="w-2/5 mx-auto bg-black text-white p-10 leading-10 rounded-2xl shadow-lg">
      mkdir astro<br />
      cd astro<br />
      npm init astro
Enter fullscreen mode Exit fullscreen mode

And this results in the following:

Tailwind starter in Astro

You can also download this project from GitHub.

Thank you for reading, and let's connect!

Thank you for reading my blog. Feel free to subscribe to my email newsletter and connect on Facebook or Twitter

Top comments (2)

prototypa profile image
Prototypa (onWidget)

🚀 Take a look at the AstroWind template I'm developing to start a new Astro project with Tailwind CSS with perfect score in Lighthouse ( github repo )

dailydevtips1 profile image
Chris Bongers

Nice that's great! 💖

Timeless DEV post...

Git Concepts I Wish I Knew Years Ago

The most used technology by developers is not Javascript.

It's not Python or HTML.

It hardly even gets mentioned in interviews or listed as a pre-requisite for jobs.

I'm talking about Git and version control of course.

One does not simply learn git