AMR2010M/butterfly-css

Butterfly CSS feels like a fun, personal project with a clear point of view: make styling feel faster and more visual by letting people add simple attributes directly in HTML. That idea comes through well in the README and docs. Attributes like responsive, handdrawn, pulse, ball-move-1, btn='purple', and the dark-mode helpers are easy to understand, and they make the framework feel especially useful for beginners, quick prototypes, creative portfolios, and small landing pages where motion and personality matter.

The best part is that the project already has real examples, a live site, documentation, releases, and a lot of visible work behind it. It does not feel like an empty repo. You have clearly spent time building demos, explaining the attributes, and showing what the framework can do.

The main thing I would improve is organization and consistency. Right now, the repo mixes the core framework files with many images, videos, HTML pages, and experiments, so it is a little hard to tell what users should actually depend on. I would split it into clear folders like src, docs, examples, and assets. I’d also make the install instructions consistent, because the README and docs mention slightly different files. A simple “start here” section with one recommended CDN snippet, one local install option, and a small list of the most important attributes would make the project much easier to adopt.

Overall, Butterfly CSS has a charming and original feel. With cleaner structure, more polished docs, and a small CI or demo test setup, it could become a much more trustworthy tool while keeping the playful style that makes it stand out.