Registry / devops / esbuild-tailwind-ssr-plugin

esbuild-tailwind-ssr-plugin

library0.1.25jsnpmunverified

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.

devops data

npm install esbuild-tailwind-ssr-plugin

github ↗package ↗

INSTALL

IMPORT

SIG · ESBUILD-TAILWIND-S

esbuild-tailwind-ssr-plugin

devopsjavascriptv0.1.25

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

esbuildTailwindSSRPlugin

✓ import { esbuildTailwindSSRPlugin } from 'esbuild-tailwind-ssr-plugin'

✗ const esbuildTailwindSSRPlugin = require('esbuild-tailwind-ssr-plugin')

ESM-only; does not support CommonJS require.

default

✓ import esbuildTailwindSSRPlugin from 'esbuild-tailwind-ssr-plugin'

✗ import { default as esbuildTailwindSSRPlugin } from 'esbuild-tailwind-ssr-plugin'

Default export is the same as named export.

PluginOptions

✓ import type { PluginOptions } from 'esbuild-tailwind-ssr-plugin'

✗ import { PluginOptions } from 'esbuild-tailwind-ssr-plugin'

PluginOptions is a TypeScript type, not a runtime value.

Demonstrates basic usage of the esbuild Tailwind CSS plugin with custom Tailwind configuration.

import { build } from 'esbuild'; import { esbuildTailwindSSRPlugin } from 'esbuild-tailwind-ssr-plugin'; await build({ entryPoints: ['src/index.ts'], bundle: true, outdir: 'dist', plugins: [ esbuildTailwindSSRPlugin({ inputCSS: 'src/styles.css', outputCSS: 'dist/styles.css', tailwindConfig: { content: ['./src/**/*.{ts,tsx}'], }, }), ], });

Debug

Known issues

breakingPlugin requires esbuild v0.9 or higher; older versions not supported.

fix

Upgrade esbuild to version 0.9 or higher.

affects: <0.1.0

gotchaThe plugin outputs CSS as a separate file; it does not inline styles into JavaScript.

fix

Ensure your HTML references the output CSS file.

affects: >=0.1.0

deprecatedOption 'cssModules' is deprecated; use 'cssModules' in plugin options instead.

fix

Move 'cssModules' configuration under the plugin options object.

affects: >=0.1.20

gotchaTailwind CSS v3+ is required; v2 is not supported.

fix

Upgrade to Tailwind CSS v3 or later.

affects: >=0.1.0

Errors

Common errors & fixes

Error: [esbuild-tailwind-ssr-plugin] Tailwind CSS not found. Please install tailwindcss.

Missing peer dependency 'tailwindcss'.

fix

Run 'npm install tailwindcss' or 'yarn add tailwindcss'.

TypeError: Cannot destructure property 'config' of 'undefined' as it is undefined.

Plugin options object not passed correctly.

fix

Ensure you pass an options object to 'esbuildTailwindSSRPlugin({...})'.

Error: Could not resolve 'tailwindcss' when bundling with esbuild.

Tailwind CSS not installed or not in node_modules.

fix

Install tailwindcss and ensure it is listed in package.json dependencies.

Error: The 'content' path './src/**/*.{ts,tsx}' does not match any files.

Incorrect glob pattern in Tailwind config.

fix

Adjust 'content' pattern to match your source files, e.g., ['./src/**/*.{js,jsx,ts,tsx}'].

Upgrade

Version history

0.1.25latest on npm

Audit

Dependencies

tailwindcssrequiredRequired peer dependency for Tailwind CSS compilation

esbuildrequiredRequired peer dependency for esbuild plugin integration

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/goldstack/goldstack ↗

packagehttps://www.npmjs.com/package/esbuild-tailwind-ssr-plugin ↗