Skip to content

A classless, block-based CSS framework for clean, responsive, and semantic HTML — with dark mode support, accessible defaults, and zero class bloat.

License

Notifications You must be signed in to change notification settings

uminocelo/musgo

Live Demo License Build Status

🌿 Musgo

A classless, block-based CSS framework for clean, responsive, and semantic HTML — with dark mode support, accessible defaults, and zero class bloat.


✨ Features

  • Classless styling — Just write semantic HTML
  • Block-based grid — Use simple data-musgo-block attributes
  • Responsive layout — With mobile-first breakpoints (sm, md, lg, xl)
  • Dark mode — Enabled via data-theme="dark"
  • Accessible forms — With focus, disabled, and validation states
  • Modular SCSS — Built for maintainability and easy customization

🔗 Live Demo

🧪 Try Musgo in action:
👉 https://uminocelo.github.io/musgo

Explore the full grid system, responsive behavior, and dark mode in the demo page.


📦 Installation

1. Clone the repo or download it

git clone https://github.com/uminocelo/musgo.git

2. Link the compiled CSS in your HTML

<link rel="stylesheet" href="css/musgo.css">
<link rel="stylesheet" href="css/musgo-block-grid.css">

Or download the latest release from the Releases page.


🚀 Quick Start Example

<div data-musgo-container>
  <div data-musgo-row>
    <div data-musgo-block="2">3 columns</div>
    <div data-musgo-block="3">6 columns</div>
    <div data-musgo-block="2">3 columns</div>
  </div>
</div>

Use responsive modifiers like data-musgo-block-sm, -md, -lg, and -xl to control layout at different breakpoints.

🧱 Grid System

Musgo uses a 12-column grid with predefined block sizes:

Block Columns Percentage
1 1 ~8.33%
2 3 25%
3 6 50%
4 9 75%
5 12 100%

You can combine blocks and adjust responsiveness with data-musgo-block-[breakpoint].

🌗 Dark Mode

Enable dark mode by setting the data-theme="dark" attribute on the or element:

<html data-theme="dark">

Musgo automatically adjusts colors, backgrounds, and form styles using CSS variables.

🛠️ Project Structure

musgo/
├── css/
│   ├── musgo.css                # Classless core styles
│   ├── musgo-block-grid.css     # Grid layout engine
│   └── scss/                    # Source SCSS files (modular)
├── demo/
│   └── index.html               # Full demo page
├── docs/
│   └── USAGE.md                 # In-depth usage guide
├── README.md
└── LICENSE

📖 Documentation

📘 Full Usage Guide

🧾 Code of Conduct

🔐 Security Policy

📄 License

Licensed under the MIT License.

🧑‍💻 Author

Built with ❤️ by uminocelo.

About

A classless, block-based CSS framework for clean, responsive, and semantic HTML — with dark mode support, accessible defaults, and zero class bloat.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •