Appearance

Farm ​

Use tailwindcss-obfuscator/farm in any Farm project. Farm is a Rust-powered build tool with a Vite-compatible plugin system, so the configuration mirrors the Vite guide.

Quick start ​

bash
npm install -D tailwindcss-obfuscator @farmfe/core
bash
pnpm add -D tailwindcss-obfuscator @farmfe/core
bash
yarn add -D tailwindcss-obfuscator @farmfe/core
bash
bun add -D tailwindcss-obfuscator @farmfe/core
ts
// farm.config.ts
import { defineConfig } from "@farmfe/core";
import TailwindObfuscator from "tailwindcss-obfuscator/farm";

export default defineConfig({
  plugins: [TailwindObfuscator({ prefix: "tw-" })],
});

TIP

Like the Vite plugin, the obfuscator only runs for production builds (farm build). The dev server (farm) is left untouched so the dev experience stays normal.

Production configuration ​

Same options surface as the Vite guide:

ts
TailwindObfuscator({
  prefix: "tw-",
  content: ["src/**/*.{html,js,jsx,ts,tsx,vue,svelte}"],
  css: ["src/**/*.css"],
  preserve: { classes: ["dark", "light", "sr-only"] },
  mapping: {
    enabled: true,
    file: ".tw-obfuscation/class-mapping.json",
    pretty: 2,
  },
});

Patterns the plugin handles ​

Identical to Vite — see the Vite guide for the full table. The shared unplugin core means JSX/TSX, Vue, Svelte, Astro and HTML extractors all work the same way.

Troubleshooting ​

Farm-specific behaviour

Farm's persistent cache may keep a stale obfuscation mapping between dev runs. If you start seeing inconsistent class names during development, delete node_modules/.farm (or run farm --clean) and rebuild.

JS plugin overhead

Farm distinguishes between Rust plugins and JavaScript plugins. tailwindcss-obfuscator/farm is a JS plugin (it builds on unplugin), so it runs in Node, not in the Rust core. This is a few milliseconds slower than a pure-Rust plugin per file but doesn't change the build output.

See also ​