{"id":25459,"library":"esbuild-tailwind-ssr-plugin","title":"esbuild-tailwind-ssr-plugin","description":"An esbuild plugin for compiling Tailwind CSS, version 0.1.25. It integrates Tailwind CSS into esbuild builds, supporting server-side rendering (SSR) and CSS modules. The plugin is part of the Goldstack monorepo and is designed to work with esbuild's plugin system, allowing Tailwind CSS processing during bundling. It is actively maintained with regular releases. Key differentiators include native esbuild integration, SSR support, and compatibility with CSS modules.","status":"active","version":"0.1.25","language":"javascript","source_language":"en","source_url":"https://github.com/goldstack/goldstack","tags":["javascript","node","css modules","esbuild","ssr","css"],"install":[{"cmd":"npm install esbuild-tailwind-ssr-plugin","lang":"bash","label":"npm"},{"cmd":"yarn add esbuild-tailwind-ssr-plugin","lang":"bash","label":"yarn"},{"cmd":"pnpm add esbuild-tailwind-ssr-plugin","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Required peer dependency for Tailwind CSS compilation","package":"tailwindcss","optional":false},{"reason":"Required peer dependency for esbuild plugin integration","package":"esbuild","optional":false}],"imports":[{"note":"ESM-only; does not support CommonJS require.","wrong":"const esbuildTailwindSSRPlugin = require('esbuild-tailwind-ssr-plugin')","symbol":"esbuildTailwindSSRPlugin","correct":"import { esbuildTailwindSSRPlugin } from 'esbuild-tailwind-ssr-plugin'"},{"note":"Default export is the same as named export.","wrong":"import { default as esbuildTailwindSSRPlugin } from 'esbuild-tailwind-ssr-plugin'","symbol":"default","correct":"import esbuildTailwindSSRPlugin from 'esbuild-tailwind-ssr-plugin'"},{"note":"PluginOptions is a TypeScript type, not a runtime value.","wrong":"import { PluginOptions } from 'esbuild-tailwind-ssr-plugin'","symbol":"PluginOptions","correct":"import type { PluginOptions } from 'esbuild-tailwind-ssr-plugin'"}],"quickstart":{"code":"import { build } from 'esbuild';\nimport { esbuildTailwindSSRPlugin } from 'esbuild-tailwind-ssr-plugin';\n\nawait build({\n  entryPoints: ['src/index.ts'],\n  bundle: true,\n  outdir: 'dist',\n  plugins: [\n    esbuildTailwindSSRPlugin({\n      inputCSS: 'src/styles.css',\n      outputCSS: 'dist/styles.css',\n      tailwindConfig: {\n        content: ['./src/**/*.{ts,tsx}'],\n      },\n    }),\n  ],\n});","lang":"typescript","description":"Demonstrates basic usage of the esbuild Tailwind CSS plugin with custom Tailwind configuration."},"warnings":[{"fix":"Upgrade esbuild to version 0.9 or higher.","message":"Plugin requires esbuild v0.9 or higher; older versions not supported.","severity":"breaking","affected_versions":"<0.1.0"},{"fix":"Ensure your HTML references the output CSS file.","message":"The plugin outputs CSS as a separate file; it does not inline styles into JavaScript.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Move 'cssModules' configuration under the plugin options object.","message":"Option 'cssModules' is deprecated; use 'cssModules' in plugin options instead.","severity":"deprecated","affected_versions":">=0.1.20"},{"fix":"Upgrade to Tailwind CSS v3 or later.","message":"Tailwind CSS v3+ is required; v2 is not supported.","severity":"gotcha","affected_versions":">=0.1.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run 'npm install tailwindcss' or 'yarn add tailwindcss'.","cause":"Missing peer dependency 'tailwindcss'.","error":"Error: [esbuild-tailwind-ssr-plugin] Tailwind CSS not found. Please install tailwindcss."},{"fix":"Ensure you pass an options object to 'esbuildTailwindSSRPlugin({...})'.","cause":"Plugin options object not passed correctly.","error":"TypeError: Cannot destructure property 'config' of 'undefined' as it is undefined."},{"fix":"Install tailwindcss and ensure it is listed in package.json dependencies.","cause":"Tailwind CSS not installed or not in node_modules.","error":"Error: Could not resolve 'tailwindcss' when bundling with esbuild."},{"fix":"Adjust 'content' pattern to match your source files, e.g., ['./src/**/*.{js,jsx,ts,tsx}'].","cause":"Incorrect glob pattern in Tailwind config.","error":"Error: The 'content' path './src/**/*.{ts,tsx}' does not match any files."}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}