Bulma 1.0.4: A Flexbox CSS Framework That Stays Out of Your JavaScript
GitHub describes it as Modern CSS framework based on Flexbox. The repository metadata lists CSS as its primary language. The metadata lists the MIT license. This article stays within the project description and details documented in the GitHub repository README.
At a glance
- What is it?
- Bulma is a CSS-only framework built on Flexbox, shipping a single CSS file with no JavaScript. This review covers what it solves, how it works, and where its limitations bite.
- Who is it for?
- Adopt Bulma if you need a lightweight, CSS-only styling layer for a project where you already have a JavaScript stack or prefer to write your own interactivity. It fits well for prototypes, static sites, and server-rendered apps.
- Can I use it commercially?
- Yes. MIT is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
- Is it still maintained?
- Yes. The repository last received commits 55 days ago.
- What is it written in?
- Mainly CSS, according to GitHub's language statistics.
Answers come from the project's GitHub data, last synced on November 13, 2026, and from our analysis. They are not legal advice.
Star history
- jgthms/bulma50,034 ★ · -24
| Repository | 2026-08-13 | 2026-11-13 |
|---|---|---|
| jgthms/bulma | 50.1k | 50k |
-24 Stars in the last 92 days, measured from the daily GitHub snapshot. Compare with other projects
Editorial analysis
What Bulma Actually Solves
Bulma addresses the problem of styling a web interface without coupling it to a specific JavaScript framework. The README states it is a CSS framework, with the sole output being a single CSS file. That means you get a consistent set of classes for layout, components, and utilities, but no JavaScript to manage. This is for developers who already have a JS solution, or who prefer to write their own. It is environment agnostic, as the README puts it: just the style layer on top of the logic. If you are building a Rails app, a Vue project, or a plain static site, Bulma gives you a visual foundation without dictating how you handle interactions.
Flexbox as the Core Mechanism
The framework is based on Flexbox, a CSS layout module that handles alignment, distribution, and ordering of elements in a container. Bulma uses Flexbox for its grid system, columns, and many components. The README points to the MDN documentation for Flexbox, indicating that the layout model is central. In practice, this means you use classes like 'columns' and 'column' to create responsive grids, and Flexbox handles the rest. The framework also uses autoprefixer to make most Flexbox features compatible with earlier browser versions. The result is a layout system that is more modern than the float-based grids of older frameworks, and it works without any JavaScript.
Getting Started: Install and Import
Installation is straightforward. The README lists three package managers: npm, Yarn, and Bower. For npm, you run 'npm install bulma'. For Yarn, 'yarn add bulma'. After installation, you import the CSS file with '@import 'bulma/css/bulma.css''. There is also a CDN option via jsDelivr, which is useful for quick prototyping without a build step. The framework is CSS-only, so there is no JavaScript to import or initialize. This simplicity is a double-edged sword: you can start styling immediately, but you also have to wire up any interactive behavior yourself. The documentation is built with Jekyll and lives in the docs directory, so you can browse it online at bulma.io.
Browser Support and Its Limits
Bulma relies on autoprefixer to handle vendor prefixes for Flexbox. According to the README, it is compatible with recent versions of Chrome, Edge, Firefox, Opera, and Safari. Internet Explorer 10 and above is only partially supported. This is a real limitation. If your user base includes older IE versions, Bulma may not render correctly, and you will need to test thoroughly. The partial support means some Flexbox features may fail, but the core layout might still work. For a modern web project, this is acceptable, but it is a boundary you must know before adoption. If you must support IE11 fully, you may need a different approach or a fallback.
Customization via Sass Variables
While you can use the pre-built bulma.css file out of the box, the README mentions that you can download the Sass source files to customize variables. This is how you change colors, spacing, and other design tokens. The documentation has a section on customization, though the README only hints at it. The process involves editing Sass variables and compiling the CSS yourself. This is a key differentiator from some frameworks that require a theme configuration file. With Bulma, you have direct access to the source. However, this also means you need a Sass build step if you want to customize. If you are happy with the default look, you can skip that entirely.
The JavaScript Trade-off
Bulma's decision to include no JavaScript is a deliberate one. The README says people generally want to use their own JS implementation and usually already have one. This is a reasonable assumption for many projects, but it means you cannot rely on Bulma for modal dialogs, dropdown menus, or tab switching. You have to build those yourself or use a third-party library. The README lists related projects that add JS integrations, such as BulmaJS, Buefy for Vue, and Bloomer for React. These exist to fill the gap. If you prefer a framework that ships with interactive components, Bulma will feel incomplete. But if you already use React, Vue, or vanilla JS, you might appreciate the separation.
Alternatives and Their Different Approaches
The most direct alternative is Bootstrap, which includes both CSS and JavaScript components. Bootstrap uses a grid system and a set of UI components that work out of the box, but it also imposes a JavaScript dependency and a heavier file size. Another alternative is Tailwind CSS, which takes a utility-first approach: you compose styles from small classes directly in your HTML, rather than using pre-built components like Bulma's 'button' or 'navbar'. Tailwind gives you more flexibility but requires a build process and a mindset shift. Bulma sits in between: it offers components but no behavior. If you need a framework that handles interactivity for you, Bootstrap is the safer choice. If you want to design without writing custom CSS, Bulma's class-based system is simpler than Tailwind's utility explosion.
Maintenance and Upgrade Considerations
Bulma is actively maintained, with the latest release 1.0.4 published in April 2025 and the last push on 2026-09-21. The 1.x series represents a major version, and moving from 0.x to 1.x may involve breaking changes. You should check the release notes before upgrading. The project is MIT licensed, which means you can use it freely in commercial projects without paying licensing fees. The maintenance cost is low because there is no JavaScript to update, but you still need to track CSS changes. The documentation is built with Jekyll, so if you contribute, you need a Ruby environment. For most users, the primary cost is learning the class names and keeping up with version changes.
Editorial conclusion
Adopt Bulma if you need a lightweight, CSS-only styling layer for a project where you already have a JavaScript stack or prefer to write your own interactivity. It fits well for prototypes, static sites, and server-rendered apps. Do not choose it if you expect built-in JS components like modals or dropdowns, or if you need full Internet Explorer support. Before adopting, verify that the Flexbox-based layout meets your target browser matrix, and check the current release notes for any breaking changes in the 1.x line. The framework's simplicity is its strength, but that simplicity is also a boundary: you will handle all behavior yourself.
Frequently asked questions
how to install bulma
Three managers are offered and all install the same thing: `npm install bulma`, `yarn add bulma`, or `bower install bulma`. You can then bring the stylesheet in with `@import 'bulma/css/bulma.css'`, or load the package from jsDelivr without installing it at all.
how to use bulma css
The sole output is a single CSS file, which you can use out of the box, or you can download the Sass source files to customise the variables. For interactive behaviour there is no JavaScript included, so you supply your own implementation.
what is bulma
Bulma is a modern CSS framework based on Flexbox, released under the MIT licence with Jeremy Thomas named as the author. It describes itself as environment agnostic, a style layer on top of the logic rather than a component library with behaviour attached.
how to use bulma
Link the compiled stylesheet, or import it into your own Sass. Because no JavaScript is included, the interactive part of any component is yours to write. The build also produces no-dark-mode, no-helpers, no-helpers-prefixed, and prefixed variants if you want a smaller stylesheet than the default.
Official sources
Add this badge to your README
If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.
[](https://hysenlabs.com/projects/jgthms-bulma)Star history chart for your README
[](https://hysenlabs.com/projects/jgthms-bulma)Was this useful?