@coralogix/galeforcecss-config-loader

GaleforceCSS

A Rust-powered Tailwind CSS v3-compatible compiler. Drop-in replacement for Tailwind v3 — same config, same directives, same output — built for speed.

GaleforceCSS is not an official Tailwind Labs project. It is an independent port of Tailwind CSS v3, pinned to tailwindcss@3.4.19 as the conformance oracle.

Status: alpha. The compiler reaches zero semantic diff on multiple real open-source projects but has not been hardened for production. APIs may change before 1.0.

---

Why

Tailwind v3 + Vite is slow to start and slow to HMR because it runs in a Node.js PostCSS pipeline. GaleforceCSS moves the hot path to Rust:

Benchmark (horizon-tailwind-react, 2551 candidates)	Time
Tailwind v3 CLI build	246 ms
GaleforceCSS CLI build	10 ms
Tailwind v3 (warm import)	15 ms
GaleforceCSS warm stream	2 ms

Pure compute (no I/O): 1.2 ms on the full corpus. Per-candidate: ~0.4 µs.

---

Features

• Full Tailwind v3 utility set — spacing, sizing, typography, color, borders, effects, transforms, filters, flex, grid, and more.
• All built-in variants — responsive (sm:, md:, …), dark mode, pseudo- classes, pseudo-elements, group-*, peer-*, aria-*, data-*, supports-*, arbitrary variants ([&>*]:).
• CSS directives — @tailwind, @layer, @apply, theme(), @screen.
• Arbitrary values, opacity modifiers, negative utilities, important modifier.
• Prefix support (prefix: 'tw-'), darkMode: 'class'|'media'|'selector'.
• Reads your existing tailwind.config.{js,cjs,mjs,ts} unchanged.
• Plugin output — addUtilities, addComponents, addBase, addVariant, matchUtilities, matchComponents, matchVariant are all supported via a JS-side plugin runner that feeds recorded calls into the Rust compiler.

Not supported in v1

• Third-party Tailwind plugins that rely on deep PostCSS internals.
• Tailwind v4.
• Byte-for-byte identical CSS formatting (semantics are identical; whitespace may differ).

---

Installation

GaleforceCSS publishes to the public npm registry under the @coralogix scope:

# Vite plugin
npm install -D @coralogix/vite-plugin-galeforcecss

# Node API (optional — the Vite plugin pulls this in automatically)
npm install -D @coralogix/galeforcecss

Alpha notice. v0.1.0-alpha is the first published release. APIs are stable for the features listed above but may shift before 1.0. Pin your version if you need stability.

GaleforceCSS ships a platform-specific native binary alongside each npm package. No build step required.

---

Vite

// vite.config.js
import { defineConfig } from 'vite'
import galeforcecss from '@coralogix/vite-plugin-galeforcecss'

export default defineConfig({
  plugins: [galeforcecss()],
})

That's it. Your existing @tailwind / @apply / theme() / @layer directives in any .css / .scss / .sass / .less file are processed in-place by Vite's CSS pipeline — no app-side import required. Content changes trigger a sub-millisecond recompile via HMR.

/* src/index.css — unchanged */
@tailwind base;
@tailwind components;
@tailwind utilities;

Plugin options (all optional):

galeforcecss({
  config: 'tailwind.config.js',       // auto-discovered if omitted
  content: ['src/**/*.{html,ts}'],    // defaults to tailwind.config `content`
  minify: true,                       // defaults to Vite's build.cssMinify
  sourceMap: true,                    // defaults to Vite's build.sourcemap
  targets: { chrome: '95' },          // Lightning CSS browser targets
})

For a single plugin-owned stylesheet instead of inline directive expansion, set input and import the virtual module — see guide/vite.md.

---

CLI

# One-shot build
galeforcecss build --input src/index.css --output dist/output.css --content src

# Scan content and print candidates as JSON
galeforcecss scan --content src --json

---

Node API

import { compile } from 'galeforcecss'

const result = await compile({
  candidates: ['flex', 'hover:bg-blue-500', 'md:px-4'],
  inputCss: '@tailwind utilities;\n',
  config: { corePlugins: { preflight: false } },
})

console.log(result.css)

For long-running tooling (avoiding per-call process startup):

import { createCompileStream } from 'galeforcecss'

const stream = createCompileStream()

const a = await stream.compile({ candidates: ['flex'] })
const b = await stream.compile({ candidates: ['block'] })

stream.close()

---

Conformance

GaleforceCSS maintains a fixture-based conformance harness that compares its output against the live Tailwind v3.4.19 oracle after PostCSS normalization. 619 fixtures pass. Zero semantic diffs on six real open-source projects: notus-nextjs, notus-react, horizon-tailwind-react, merakiui, soft-ui-dashboard, and flowbite.

---

Contributing

Prerequisites

• Rust 1.82+ (rust-toolchain.toml pins the version)
• Node 18.18+, pnpm 9.x

Setup

git clone https://github.com/coralogix/galeforce-css
cd galeforce-css
git submodule update --init --recursive   # vendor/tailwindcss-v3 source ref
pnpm install

Verification gates

cargo fmt --all -- --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace
cargo build -p galeforce-cli --release       # binary required by conformance tests
pnpm oracle:version                       # confirms tailwindcss@3.4.19
pnpm typecheck
pnpm test
pnpm conformance:test

Repository layout

crates/
  galeforce-core/          # Shared types, errors, diagnostics
  galeforce-scanner/       # Content scanning + incremental cache
  galeforce-parser/        # Candidate parser
  galeforce-compiler/      # Utility + variant compiler, CSS directives
  galeforce-css/           # CSS AST + selector escaping
  galeforce-sort/          # Rule ordering
  galeforce-cli/           # galeforcecss CLI binary
  galeforce-node/          # napi-rs bindings (wired in Phase I)
packages/
  galeforcecss/            # Public Node API
  vite-plugin-galeforcecss/
  galeforcecss-oracle/     # Wraps tailwindcss@3.4.19 for conformance
  galeforcecss-conformance/# Fixture runner: oracle vs. Galeforce
conformance/fixtures/   # JSON fixtures (one per feature/edge case)
vendor/tailwindcss-v3/  # Pinned upstream submodule (source reference)

The vendor/tailwindcss-v3 submodule is the authoritative behavioral reference. When implementing a utility or variant, read its source in src/corePlugins.js and port edge cases from its tests/ directory. See CLAUDE.md for the full porting philosophy.

---

License

Apache License 2.0. See LICENSE.

Copyright 2026 Coralogix Ltd.

Contributor License Agreement

Contributions to GaleforceCSS require signing the Coralogix Contributor License Agreement. See CLA.md. The CLA is enforced via CLA Assistant — first-time contributors are prompted to sign before their pull request can be merged.

Security

To report a vulnerability, see SECURITY.md.