Stylify + React.js + Vite.js. Style your React.js website faster with Stylify. Don't study selectors and syntax. Use pure CSS syntax and get generated CSS with advanced optimization for production.
For easier start, you can checkout the Stylify Stackblitz playground 🎮.
💎 Stylify Introduction
Stylify generates CSS dynamically based on what you write. The syntax is similar to css property:value
. Defined utilities are combined with components selectors and in production minified to bare minimum like .color\:red,.button {color:red}
to ._zx, ._ga{color:red}
.
Stylify allows you to get very small bundles, generate additional lazyloaded CSS chunks and style the page by writting HTML and selectors 🤟.
🚀 React.js Setup
The easiest way to Setup the React.js is using cli:
- Run
yarn create vite app
- Select
react
orreact-ts
- Then
cd app
This way you will get the default React.js application skeleton.
🔌 Stylify Integration
Install the @stylify/unplugin package using NPM or Yarn:
yarn add @stylify/unplugin
npm i @stylify/unplugin
Open the vite.config.js
and copy the following content into it:
import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'
import { vitePlugin } from '@stylify/unplugin';
const stylifyPlugin = vitePlugin({
transformIncludeFilter: (id) => {
// Process only js, jsx, ts, tsx,
return id.endsWith('js') || id.endsWith('ts') || id.endsWith('tsx') || id.endsWith('jsx');
},
bundles: [{
// Create only one bundle for whole project => stylify.css
outputFile: './src/stylify.css',
files: ['./src/**/*.js', './src/**/*.ts', './src/**/*.jsx', './src/**/*.tsx'],
}],
extend: {
bundler: {
compiler: {
selectorsAreas: [
// To find class attributes
'(?:^|\\s+)className="([^"]+)"',
'(?:^|\\s+)className=\'([^\']+)\'',
'(?:^|\\s+)className=\\{`((?:.|\n)+)`\\}'
]
}
}
}
});
export default defineConfig({
plugins: [stylifyPlugin, react()]
});
The last step, open the src/main.jsx
and add path to stylify.css
:
// ...
import './stylify.css'
Styling the website
If yout copy the code bellow into the src/App.jsx
and run yarn dev
you will get a styled Hello World! 🎉
text:
export default function App() {
return (
<div className="text-align:center margin-top:100px font-size:42px">
Hello World! 🎉
</div>
);
}
Stylify watches any change in the files that matches mask in the bundle files and generates css into the src/stylify.css
.
If you add for example color:blue
the CSS will be automatically updated 🎉.
Go ahead and try Stylify directly on Stackblitz.com 💡.
Components
To avoid bloated templates with utilities, you can use components directly in files, where they are used through content options (expects javascript object without brackets) or in the compiler config.
/*
stylify-components
container: 'max-width:800px margin:0__auto',
title: 'text-align:center margin-top:100px font-size:42px'
/stylify-components
*/
export default function App() {
return (
<div class="container">
<div className="title">Hello World! 🎉</div>
</div>
);
}
Variables
If you like clean code, you also want avoid hardcoded values in selectors. Variables can be defined the same way as components:
/*
stylify-variables
titleFontSize: '42px',
containerWidth: '800px'
/stylify-variables
stylify-components
container: 'max-width:$containerWidth margin:0__auto',
title: 'text-align:center margin-top:100px font-size:$titleFontSize'
/stylify-components
*/
export default function App() {
return (
<div class="container">
<div className="title">Hello World! 🎉</div>
</div>
);
}
Building for production
If you run yarn build
+ yarn preview
, the jsx markup will be mangled to this:
export default function App() {
return (
<div class="_7tcrv">
<div className="_88io">Hello World! 🎉</div>
</div>
);
}
The css is shortened too:
:root {--titleFontSize: 42px;--containerWidth: 800px;}
._bcda8,._7tcrv{max-width:800px}
._m0vnad,._7tcrv{margin:0 auto}
._1vegb8,._88io{text-align:center}
._jimir,._88io{margin-top:100px}
._qe393,._88io{font-size:42px}
Configure anything you need
The examples above doesn't include everything Stylify can do:
- You can map nested files in the template
- Style global selectors
- Define custom screens
- Add own macros like
ml:20px
for margin-left - And a lot more
Feel free to checkout the docs to learn more 💎.
Stay in touch:
👉 @8machy