Heads up, this content is in beta. Use at your own risk!

Tailwind CSS is a highly customizable, utility-first CSS framework that gives you the power to create unique and responsive designs. If you’re new to Tailwind and ready to dive in, this guide is your first step towards mastering this innovative framework.

I use Tailwind CSS and it’s been game changing in how I author styles!

How to install Tailwind CSS

Use this quick-start guide to get Tailwind CSS set up in your project.

1. Installing Tailwind CSS

Before you start, ensure that you have Node.js and npm installed. If you don’t have it installed, you can download Node.js from the official website, which will include npm.

You can also use Homebrew.

Once you have Node.js and npm set up, you can install Tailwind CSS into your project via npm by navigating to your project directory in the terminal and running the following command:

npm install -D tailwindcss

The -D means that you’re installing the Tailwind CSS package as a dev dependency.

2. Generate Tailwind Config File

After the installation, generate your tailwind.config.js file by running:

npx tailwindcss init

This creates a tailwind.config.js file in your project root. This file is where you can customize your design, like defining the color palette, spacing/sizing scale, and more. Initially, it will look like this:

module.exports = {
  content: ["./src/**/*.{html,js}"],
  theme: {
    extend: {},
  plugins: [],

3. Include Tailwind in Your CSS

Next, create a new CSS file in your project, name it (for example, styles.css), and use the @import directive to include Tailwind’s base, components, and utilities styles:

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

4. Process Your CSS with Tailwind

Now, we want to set up a process to build our CSS with Tailwind. Add a build script to your package.json:

"scripts": {
  "build": "tailwindcss -i src/styles.css -o dist/styles.css"

With this in place, you can now run npm run build to build your CSS.

Alternatively, you can run Tailwind CSS from within your terminal to build your CSS files. You already have the CLI installed from previous steps above.

npx tailwindcss -i src/styles.css -o dist/styles.css --watch

Creating a Basic Layout with Tailwind CSS

Let’s create a basic layout to see Tailwind CSS in action.

Assume we want to create a simple card component with a title, image, and description. Here’s how we could do it using Tailwind CSS:

  class="max-w-md m-5 mx-auto overflow-hidden bg-white shadow-md rounded-xl md:max-w-2xl"
  <div class="md:flex">
    <div class="md:flex-shrink-0">
        class="object-cover w-full h-48 md:w-48"
        alt="A cool store"
    <div class="p-8">
        class="text-sm font-semibold tracking-wide text-indigo-500 uppercase"
        The cool store
      <p class="mt-2 text-gray-500">
        Visit our cool store and find the best products for you.

Let’s break down a few of the classes used here:

  • max-w-md: sets the maximum width of the element to 24rem.
  • mx-auto: centers the element horizontally.
  • bg-white: sets the background color of the element to white.
  • rounded-xl: gives the element rounded corners.
  • shadow-md: applies medium box shadow to the element.
  • overflow-hidden: clips any child content or padding that goes outside the bounds of the element.
  • m-5: applies 1.25rem margin on all four sides of the element.

🎉 And that’s it! 🎉

You’ve set up Tailwind CSS and built a basic layout. Remember, the real power of Tailwind comes from customizing it to suit your needs. Make sure to explore the tailwind.config.js file and the official Tailwind CSS documentation to see all the ways you can tailor the framework to your project.

Tailwind CSS offers a robust platform to build unique, responsive designs with speed and efficiency. While the initial learning curve can be steep, the payoff is well worth the effort.

This guide has given you a basic understanding of how to set up and start using Tailwind CSS. Now, it’s time to unleash your creativity and explore all the possibilities that Tailwind CSS has to offer.