---
name: bulma
summary: "Bulma is a free, open-source CSS framework based on Flexbox that provides ready-to-use, responsive UI components and a grid system without requiring any JavaScript. It's distributed as a single CSS file or as customizable Sass source."
language: CSS
license: MIT
repo: https://github.com/jgthms/bulma
source: https://opensources.dev/resource/bulma
health: 100
---

# bulma

Bulma is a free, open-source CSS framework based on Flexbox that provides ready-to-use, responsive UI components and a grid system without requiring any JavaScript. It's distributed as a single CSS file or as customizable Sass source.

## Building the documentation

The documentation HTML is produced with the Ruby-based `jekyll` tool.

1. Make sure Ruby 2.x is installed.
2. `gem install jekyll` if `jekyll` is not already installed.

> **Note**: If you are an `Ubuntu user`, make sure ruby2.x-dev is installed.

## Viewing the documentation locally

To view the documentation on your system locally:

### Setup

1. `cd` into `docs/` directory
2. Copy the config file, `cp _config.yml _config.local.yml`
3. Edit `_config.local.yml` and change the `url:` value to `http://localhost:4000`. This local config file will be ignored by git.

### Run Jekyll

1. In a separate shell session, `cd` to the `docs/` directory, and do:

```tsx
jekyll serve --incremental --config _config.local.yml
```

This will start an HTTP server at `http://localhost:4000/` that serves the docs built in the `_site` directory; and anytime the docs are rebuilt by you, it will serve the docs site on the fly. You can also add the `--open-url` option (or its alias `--o`) to automatically open the server URL in your default browser when it's ready.

In your main shell session where you develop, if you change anything in `docs/` the jekyll server will rebuild those on the fly. But if you change anything about the Bulma SASS or CSS, you need to do `npm run start` to build the docs' CSS before you will see it in the browser. The process running `jekyll serve` will pick up the new CSS automatically.