⚡ Goyal CSS Engine
The universal, zero-config utility CSS engine for modern web development.
Parse any CSS property, function, or color space natively with zero build overhead and zero dependencies.

🚀 Key Features
📦 Zero External Dependencies — Built with pure Node.js for maximum speed and tiny install size.
🎨 Universal Arbitrary Values — Supports any valid CSS property and custom value.
p-[20px]
bg-[#0f172a]
text-[oklch(0.8_0.15_200)]
clip-path-[polygon(...)]
⚡ Multi-Framework Auto-Scanning — Automatically scans:
.html, .jsx, .tsx, .vue, .svelte, .php, .js, and .ts
🎯 Full CSS Feature Set — Supports:
- State variants
- Responsive breakpoints
- Dark mode
- Keyframe animations
- 2D/3D transforms
- CSS functions
- Arbitrary values
🪶 Minification Support — Generate production-ready, minified CSS with a single CLI flag.
🔥 Watch Mode — Automatically rebuild CSS whenever your source files change.
🛠️ Node.js API — Use the engine programmatically inside your own build tools and scripts.
📥 Installation
Install @goyalsoft/goyal-css-engine as a development dependency.
npm
npm install -D @goyalsoft/goyal-css-engine
pnpm
pnpm add -D @goyalsoft/goyal-css-engine
yarn
yarn add -D @goyalsoft/goyal-css-engine
💻 How to Use
1. Write Goyal CSS Classes
Add Goyal CSS utility classes inside your source files.
HTML / JSX
<div
class="flex items-center justify-between p-[24px] bg-[#0f172a] hover:bg-[#1e293b] md:p-[32px]"
>
<h1 class="text-[oklch(0.8_0.15_200)] font-size-[2rem] animate-spin">
Goyal CSS Engine
</h1>
<p
class="rotate-[45deg] scale-[1.1] transition-[all] duration-[300ms] dark:text-[white]"
>
Zero Config Required.
</p>
</div>
The engine detects the classes in your source files and generates the required CSS.
🛠️ CLI Usage
Goyal CSS Engine includes a CLI that can be executed using npx.
Basic Build
Scans your project and generates output.css:
npx goyal-css
Custom Source Glob & Output
npx goyal-css "src/**/*.{html,jsx,tsx}" dist/styles.css
Watch Mode
Automatically recompiles CSS whenever files change:
npx goyal-css "src/**/*.{html,jsx,tsx}" dist/styles.css --watch
Production Build
Generate a minified production stylesheet:
npx goyal-css "src/**/*.{html,jsx,tsx}" dist/styles.min.css --minify
📦 Package Scripts
For most projects, adding scripts to package.json is recommended.
{
"name": "my-app",
"version": "1.0.0",
"scripts": {
"css:dev": "goyal-css \"src/**/*.{html,jsx,tsx,vue,svelte}\" dist/output.css --watch",
"css:build": "goyal-css \"src/**/*.{html,jsx,tsx,vue,svelte}\" dist/output.min.css --minify"
}
}
Run the development watcher:
npm run css:dev
Generate the production CSS:
npm run css:build
📖 Utility Syntax & Reference
1. Universal Arbitrary Values
Goyal CSS Engine supports arbitrary CSS values using square brackets:
[property]-[value]
This allows you to use custom CSS values without defining configuration files.
Colors
bg-[#0f172a]
text-[#ffffff]
border-[#3b82f6]
OKLCH
text-[oklch(0.8_0.15_200)]
HSL
border-[hsl(210_100%_50%)]
Custom Spacing & Dimensions
w-[350px]
h-[500px]
p-[12px_24px]
m-[20px]
Custom Grid
grid-cols-[1fr_2fr_1fr]
Complex CSS Functions
clip-path-[polygon(0_0,_100%_0,_100%_100%)]
blur-[4px]
Tip: Replace spaces inside arbitrary values with underscores (_).
🎨 Built-in Tokens
Goyal CSS Engine also provides built-in utility tokens for common CSS values.
Spacing Tokens
Supported examples include:
p-0
p-1
p-2
p-3
p-4
p-5
...
p-24
Additional values:
m-auto
w-full
h-screen
gap-6
Color Tokens
bg-primary
text-dark
border-danger
bg-success
text-secondary
bg-light
🎯 State & Responsive Variants
State Variants
Use CSS pseudo-class variants directly in your utility classes.
Hover
hover:bg-[#1e293b]
Focus
focus:outline-[#3b82f6]
Other supported state variants can be used following the same syntax.
📱 Responsive Design
Goyal CSS Engine provides responsive breakpoint variants.
| Breakpoint |
Minimum Width |
sm: |
640px |
md: |
768px |
lg: |
1024px |
xl: |
1280px |
Examples
sm:p-4
md:p-8
lg:p-[48px]
xl:p-12
You can combine responsive variants with arbitrary values:
md:w-[500px]
lg:grid-cols-[1fr_2fr]
xl:p-[64px]
🌙 Dark Mode
Use the dark: variant to define styles for dark mode.
dark:text-[white]
dark:bg-[#000000]
Example:
<div class="bg-white text-black dark:bg-[#000000] dark:text-[white]">
Dark Mode Supported
</div>
Goyal CSS Engine supports 2D and 3D transform utilities.
Rotate
rotate-[45deg]
Scale
scale-[1.2]
Translate
translate-x-[20px]
translate-y-[10px]
Skew
skew-y-[10deg]
You can combine transformations:
rotate-[45deg] scale-[1.2] translate-x-[20px]
✨ Transitions
Create transition utilities using arbitrary values.
transition-[all]
duration-[300ms]
ease-[ease-in-out]
delay-[100ms]
Example:
<button
class="transition-[all] duration-[300ms] ease-[ease-in-out] hover:scale-[1.05]"
>
Hover Me
</button>
🎬 Animations
Goyal CSS Engine includes common animation utilities.
animate-spin
animate-bounce
animate-pulse
animate-ping
Example:
<div class="animate-spin">
Loading...
</div>
🧩 Framework Support
Goyal CSS Engine can scan multiple popular web-development file formats automatically.
| File Type |
Supported |
| HTML |
✅ |
| JSX |
✅ |
| TSX |
✅ |
| Vue |
✅ |
| Svelte |
✅ |
| PHP |
✅ |
| JavaScript |
✅ |
| TypeScript |
✅ |
Example source pattern:
src/**/*.{html,jsx,tsx,vue,svelte,php,js,ts}
⚙️ Programmatic Node.js API
You can integrate Goyal CSS Engine directly into your own Node.js scripts.
One-Time Build
import { buildFramework } from '@goyalsoft/goyal-css-engine';
await buildFramework(
'src/**/*.{html,jsx,tsx}',
'dist/output.min.css',
{
minify: true
}
);
Watch Mode
import { watchFramework } from '@goyalsoft/goyal-css-engine';
watchFramework(
'src/**/*.{html,jsx,tsx}',
'dist/output.css',
{
minify: false
}
);
🏗️ Example Project Structure
A typical project can look like:
my-project/
├── src/
│ ├── index.html
│ ├── App.jsx
│ └── components/
│ └── Header.jsx
│
├── dist/
│ └── output.css
│
├── package.json
└── node_modules/
Run:
npx goyal-css "src/**/*.{html,jsx,tsx}" dist/output.css
Then include the generated stylesheet in your application:
<link rel="stylesheet" href="./dist/output.css" />
⚡ Why Goyal CSS Engine?
Traditional utility CSS frameworks often require configuration, plugins, presets, or large build pipelines.
Goyal CSS Engine is designed around a simpler idea:
Write the CSS utility you need. Let the engine generate it.
No configuration files required
No config
No plugins
No presets
Arbitrary CSS values
bg-[#0f172a]
text-[oklch(0.8_0.15_200)]
w-[350px]
clip-path-[polygon(...)]
Lightweight architecture
Source Files
│
▼
Goyal CSS Scanner
│
▼
Utility Parser
│
▼
CSS Generator
│
▼
output.css
🪶 Production Builds
For production deployments, use the --minify option:
npx goyal-css "src/**/*.{html,jsx,tsx,vue,svelte}" dist/output.min.css --minify
This generates a smaller stylesheet by removing unnecessary whitespace and comments.
📜 License
MIT © Goyal Soft
👨💻 Goyal Soft
Goyal CSS Engine is developed and maintained by Goyal Soft.
Built for developers who want a simple, flexible, and universal utility CSS engine.
⭐ Support the Project
If Goyal CSS Engine is useful to you:
- ⭐ Star the project on GitHub
- 📦 Install it from npm
- 🐛 Report bugs
- 💡 Suggest improvements
- 🤝 Contribute to the project
Goyal CSS Engine — Write CSS utilities. Skip the configuration.