A PHP-native utility-first CSS engine with JIT compilation, plugin marketplace support, and deep framework integration (Hurricane-ready).

BrushCSS is a backend-driven CSS compiler that scans your PHP/HTML views and generates only the CSS you actually use.

Instead of shipping large static stylesheets, BrushCSS builds CSS on demand (JIT) and integrates directly into your PHP application lifecycle.

• 🔍 JIT Compilation — Generates CSS only from used classes
• 🧠 View Scanner — Extracts classes from ".php" / ".html" views
• 🔌 Plugin System — Extend utilities and variants easily
• 📦 Composer Ready — Install via Packagist
• 🌪️ Hurricane Integration — Middleware + DI ready
• 🔁 HMR Support — Live CSS reload during development
• 🧱 Grid System (12-column) — Built-in layout engine
• 🎨 Utility-first design system
• 🌐 Remote Plugin Marketplace (CLI "add")

composer require brushcss/brushcss

php vendor/bin/brushcss init

This creates:

• config/brushcss.php
• public/style.css

php vendor/bin/brushcss build

php vendor/bin/brushcss watch

View file ("views/login.php").

<h2 class="bg-blue-500 p-4 mt-5">
  Hello BrushCSS
</h2>

Generated CSS:

.bg-blue-500 { background-color: #3b82f6; }
.p-4 { padding: 16px; }
.mt-5 { margin-top: 20px; }

<div class="grid grid-cols-12 gap-4">
  <div class="col-span-6">Left</div>
  <div class="col-span-6">Right</div>
</div>

Spacing:

p-4, p-6, mt-5, mb-2

Colors:

bg-blue-500, text-red-100

Layout:

• flex
• grid
• hidden
• block

Effects:

transition, duration-300, hover:bg-blue-500

BrushCSS supports extensible plugins.

Install plugin:

brushcss add grid

Example plugins:

• grid system
• typography system
• forms system
• animation system

BrushCSS supports a remote registry:

brushcss add typography

Internally:

CLI → Registry API → Composer → Activation → Config injection

BrushCSS can be used inside the Hurricane PHP framework:

Middleware compilation

• Auto-scans views per request
• Generates scoped CSS
• Injects into response pipeline

BrushCSSMiddleware::class

View Files
↓ Class Extractor
↓ JIT Engine
↓ Variant Compiler
↓ Plugin System
↓ CSS Output
↓ public/css/style.css

🧠 Advanced Features (Roadmap)

• Incremental builds
• File hashing cache
• Dependency graph tracking

hover:, md:, lg:, dark:

• 12-column grid
• flex utilities
• responsive breakpoints

• versioning
• remote registry
• CLI install/remove/update

• instant CSS injection
• no page reload

• "", "" style UI engine

brushcss init brushcss build brushcss watch brushcss add brushcss remove brushcss list

src/ bin/ config/ plugins/ public/ storage/ tests/

BrushCSS is built on one principle:

“Generate only what you use — nothing more.”

No heavy bundles. No unused CSS. No frontend build dependency.

BrushCSS is evolving into:

A PHP-native styling compiler ecosystem with plugin marketplace and framework-level integration.

Comparable in concept to modern frontend tooling, but fully backend-driven.

MIT License

Built for modern PHP ecosystems and deep framework integration (Hurricane-ready architecture).