DEV Community

Cover image for Adding Tailwind v4 to Docusaurus v3
Michał Wrzosek
Michał Wrzosek

Posted on

Adding Tailwind v4 to Docusaurus v3

This is a very basic Tailwind v4 setup for Docusaurus v3.

Install Tailwind and Postcss:

npm i --save-dev tailwindcss postcss @tailwindcss/postcss 
Enter fullscreen mode Exit fullscreen mode

Create docosaurus plugin in src/plugins/tailwind-config.js:

module.exports = function tailwindPlugin(context, options) {
  return {
    name: "tailwind-plugin",
    configurePostCss(postcssOptions) {
      postcssOptions.plugins = [require("@tailwindcss/postcss")];
      return postcssOptions;
    },
  };
};
Enter fullscreen mode Exit fullscreen mode

Add this plugin to docosaurus config object in docusaurus.config.ts:

const config: Config = {
  //...
  plugins: ["./src/plugins/tailwind-config.js"],
  //...
};
Enter fullscreen mode Exit fullscreen mode

Add tailwind setup somewhere in src/css/custom.css file:

@import "tailwindcss";

@custom-variant dark (&:is([data-theme="dark"] *));
Enter fullscreen mode Exit fullscreen mode

And voila! From now on, Tailwind classes should be picked up by Docosaurus and the dark theme will also sync up correctly.

Top comments (0)