simplewind
v0.4.1
Published
Lightweight utility-first CSS framework with a simple build and CLI generator
Maintainers
Readme
🪶 Simplewind CSS
Simplewind adalah lightweight utility-first CSS framework — terinspirasi dari TailwindCSS tapi lebih ringan, sederhana, dan cepat digunakan. Cukup 1 file CSS untuk styling proyek kecil, landing page, atau prototipe cepat ⚡
📦 Instalasi 1️⃣ Gunakan via CDN
Langsung tambahkan ke HTML kamu:
<link rel="stylesheet" href="https://unpkg.com/simplewind/css/simplewind.min.css">2️⃣ Instal via NPM (jika ingin build manual)
npm install simplewindLalu import di file utama:
import 'simplewind/css/simplewind.min.css';⚙️ Buat Proyek Baru (CLI)
Simplewind punya CLI untuk membuat struktur proyek secara otomatis — seperti Vite, tapi untuk CSS.
npx simplewind new myproject
cd myproject
npm run buildHasilnya:
myproject/
├─ src/
│ ├─ variables.css
│ ├─ base.css
│ ├─ utilities.css
│ └─ components.css
├─ css/
│ ├─ simplewind.css
│ └─ simplewind.min.css
├─ demo/
│ └─ index.html
├─ build.js
└─ package.json🧩 Struktur File
| File | Deskripsi |
| -------------------- | -------------------------------------------------------------- |
| variables.css | Menyimpan semua warna, radius, dan shadow variable |
| base.css | Style dasar untuk body, heading, dll |
| utilities.css | Kumpulan class utilitas seperti bg-*, text-*, m-*, p-* |
| components.css | Komponen sederhana seperti tombol atau card |
| simplewind.css | Hasil gabungan semua file di atas |
| simplewind.min.css | Versi minified untuk production |
💅 Contoh Penggunaan
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Hello Simplewind</title>
<link rel="stylesheet" href="css/simplewind.min.css">
</head>
<body class="flex-center" style="height:100vh;">
<div class="text-center">
<h1 class="text-blue-600 font-bold mb-4">Hello Simplewind</h1>
<p class="text-gray-700 mb-6">Lightweight utility-first CSS framework</p>
<button class="bg-blue-500 text-white px-4 py-2 rounded hover:bg-blue-600">Primary</button>
<button class="bg-gray-300 text-gray-800 px-4 py-2 rounded hover:bg-gray-400">Secondary</button>
</div>
</body>
</html>⚒️ Script Build
Untuk membangun ulang CSS dari src/*.css ke css/simplewind.min.css:
npm run buildBuild script (build.js) akan:
1. menggabungkan semua file di src/
2. membuat versi simplewind.css
3. membuat versi minified simplewind.min.css
4. membuat halaman demo otomatis di demo/index.html 🎨 Utility Classes
🧱 Layout & Display
| Class | Deskripsi |
| -------------- | ----------------------- |
| .d-flex | Display flex |
| .flex-center | Flex + center alignment |
| .text-center | Text align center |
| .mx-auto | Margin horizontal auto |
| .max-w-3xl | Max width 48rem |
🎨 Colors
| Class | Warna |
| ---------------- | ------- |
| .bg-blue-500 | #3b82f6 |
| .bg-gray-100 | #f3f4f6 |
| .text-blue-600 | #2563eb |
| .text-gray-700 | #374151 |
🔤 Typography
| Class | Deskripsi |
| ---------------- | ---------------- |
| .text-3xl | Font size besar |
| .font-bold | Font weight 700 |
| .font-semibold | Font weight 600 |
| .text-gray-500 | Warna abu medium |
🧍♂️ Spacing
| Class | Deskripsi |
| -------------------- | ----------------- |
| .p-4 .p-6 .p-8 | Padding utilities |
| .mb-6 .mt-10 | Margin utilities |
⚡ CLI Command Reference
| Command | Fungsi |
| ---------------------------------- | ------------------------------ |
| npx simplewind new <nama-proyek> | Membuat proyek Simplewind baru |
| npm run build | Build CSS & demo otomatis |
🧪 Development Lokal
npm link
simplewind new mydemo🚀 Roadmap
✅ v0.3 — Build & Demo generator
🔜 v0.4 — CLI publish-ready + custom theme generator
🔜 v0.5 — Utility generator (dynamic spacing & color scaling)
🔜 v1.0 — Docs website + plugin system📜 Lisensi
MIT © 2025 Puji Ermanto
