UNPKG

14.5 kBMarkdownView Raw
1# [Bulma](https://bulma.io)
2
3Bulma is a **modern CSS framework** based on [Flexbox](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Flexible_Box_Layout/Using_CSS_flexible_boxes).
4
5![Github](https://img.shields.io/github/v/release/jgthms/bulma?logo=Bulma)
6[![npm](https://img.shields.io/npm/v/bulma.svg)][npm-link]
7[![npm](https://img.shields.io/npm/dm/bulma.svg)][npm-link]
8[![](https://data.jsdelivr.com/v1/package/npm/bulma/badge)](https://www.jsdelivr.com/package/npm/bulma)
9[![Awesome][awesome-badge]][awesome-link]
10[![Join the chat at https://gitter.im/jgthms/bulma](https://badges.gitter.im/jgthms/bulma.svg)](https://gitter.im/jgthms/bulma)
11[![Build Status](https://travis-ci.org/jgthms/bulma.svg?branch=master)](https://travis-ci.org/jgthms/bulma)
12
13<a href="https://bulma.io"><img src="https://raw.githubusercontent.com/jgthms/bulma/master/docs/images/bulma-banner.png" alt="Bulma: a Flexbox CSS framework" style="max-width:100%;" width="600"></a>
14
15## Quick install
16
17Bulma is constantly in development! Try it out now:
18
19### NPM
20
21```sh
22npm install bulma
23```
24
25**or**
26
27### Yarn
28
29```sh
30yarn add bulma
31```
32
33### Bower
34
35```sh
36bower install bulma
37```
38
39### Import
40
41After installation, you can import the CSS file into your project using this snippet:
42
43```sh
44@import 'bulma/css/bulma.css'
45```
46
47### CDN
48
49[https://www.jsdelivr.com/package/npm/bulma](https://www.jsdelivr.com/package/npm/bulma)
50
51Feel free to raise an issue or submit a pull request.
52
53## CSS only
54
55Bulma is a **CSS** framework. As such, the sole output is a single CSS file: [bulma.css](https://github.com/jgthms/bulma/blob/master/css/bulma.css)
56
57You can either use that file, "out of the box", or download the Sass source files to customize the [variables](https://bulma.io/documentation/customize/#docsNav).
58
59There is **no** JavaScript included. People generally want to use their own JS implementation (and usually already have one). Bulma can be considered "environment agnostic": it's just the style layer on top of the logic.
60
61## Browser Support
62
63Bulma uses [autoprefixer](https://github.com/postcss/autoprefixer) to make (most) Flexbox features compatible with earlier browser versions. According to [Can I use](https://caniuse.com/#feat=flexbox), Bulma is compatible with **recent** versions of:
64
65- Chrome
66- Edge
67- Firefox
68- Opera
69- Safari
70
71Internet Explorer (10+) is only partially supported.
72
73## Documentation
74
75The documentation resides in the [docs](docs) directory, and is built with the Ruby-based [Jekyll](https://jekyllrb.com/) tool.
76
77Browse the [online documentation here.](https://bulma.io/documentation/start/overview/)
78
79## Related projects
80
81| Project | Description |
82| ------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
83| [Bulma with Attribute Modules](https://github.com/j5bot/bulma-attribute-selectors) | Adds support for attribute-based selectors |
84| [Bulma with Rails](https://github.com/joshuajansen/bulma-rails) | Integrates Bulma with the rails asset pipeline |
85| [BulmaRazor](https://github.com/loogn/bulmarazor) | A lightweight component library based on Bulma and Blazor. |
86| [Vue Admin (dead)](https://github.com/vue-bulma/vue-admin) | Vue Admin framework powered by Bulma |
87| [Bulmaswatch](https://github.com/jenil/bulmaswatch) | Free themes for Bulma |
88| [Goldfish (read-only)](https://github.com/Caiyeon/goldfish) | Vault UI with Bulma, Golang, and Vue Admin |
89| [ember-bulma](https://github.com/open-tux/ember-bulma) | Ember addon providing a collection of UI components for Bulma |
90| [Bloomer](https://bloomer.js.org) | A set of React components for Bulma |
91| [React-bulma](https://github.com/kulakowka/react-bulma) | React.js components for Bulma |
92| [Buefy](https://buefy.org/) | Lightweight UI components for Vue.js based on Bulma |
93| [vue-bulma-components](https://github.com/vouill/vue-bulma-components) | Bulma components for Vue.js with straightforward syntax |
94| [BulmaJS](https://github.com/VizuaaLOG/BulmaJS) | Javascript integration for Bulma. Written in ES6 with a data-\* API |
95| [Bulma-modal-fx](https://github.com/postare/bulma-modal-fx) | A set of modal window effects with CSS transitions and animations for Bulma |
96| [Bulma Stylus](https://github.com/groenroos/bulma-stylus) | Up-to-date 1:1 translation to Stylus |
97| [Bulma.styl (read-only)](https://github.com/log1x/bulma.styl) | 1:1 Stylus translation of Bulma 0.6.11 |
98| [elm-bulma](https://github.com/surprisetalk/elm-bulma) | Bulma + Elm |
99| [elm-bulma-classes](https://github.com/ahstro/elm-bulma-classes) | Bulma classes prepared for usage with Elm |
100| [Bulma Customizer](https://bulma-customizer.bstash.io/) | Bulma Customizer &#8211; Create your own **bespoke** Bulma build |
101| [Fulma](https://fulma.github.io/Fulma/) | Wrapper around Bulma for [fable-react](https://github.com/fable-compiler/fable-react) |
102| [Laravel Enso](https://github.com/laravel-enso/enso) | SPA Admin Panel built with Bulma, VueJS and Laravel |
103| [Django Bulma](https://github.com/timonweb/django-bulma) | Integrates Bulma with Django |
104| [Bulma Templates](https://github.com/dansup/bulma-templates) | Free Templates for Bulma |
105| [React Bulma Components](https://github.com/couds/react-bulma-components) | Another React wrap on React for Bulma.io |
106| [purescript-bulma](https://github.com/sectore/purescript-bulma) | PureScript bindings for Bulma |
107| [Vue Datatable](https://github.com/laravel-enso/vuedatatable) | Bulma themed datatable based on Vue, Laravel & JSON templates |
108| [bulma-fluent](https://mubaidr.github.io/bulma-fluent/) | Fluent Design Theme for Bulma inspired by Microsoft’s Fluent Design System |
109| [csskrt-csskrt](https://github.com/4d11/csskrt-csskrt) | Automatically add Bulma classes to HTML files |
110| [bulma-pagination-react](https://github.com/hipstersmoothie/bulma-pagination-react) | Bulma pagination as a react component |
111| [bulma-helpers](https://github.com/jmaczan/bulma-helpers) | Functional / Atomic CSS classes for Bulma |
112| [bulma-swatch-hook](https://github.com/hipstersmoothie/bulma-swatch-hook) | Bulma swatches as a react hook and a component |
113| [BulmaWP (read-only)](https://github.com/tomhrtly/BulmaWP) | Starter WordPress theme for Bulma |
114| [Ralma](https://github.com/aldi/ralma) | Stateless Ractive.js Components for Bulma |
115| [Django Simple Bulma](https://github.com/python-discord/django-simple-bulma) | Lightweight integration of Bulma and Bulma-Extensions for your Django app |
116| [rbx](https://dfee.github.io/rbx) | Comprehensive React UI Framework written in TypeScript |
117| [Awesome Bulma Templates](https://github.com/aldi/awesome-bulma-templates) | Free real-world Templates built with Bulma |
118| [Trunx](https://github.com/fibo/trunx) | Super Saiyan React components, son of awesome Bulma |
119| [@aybolit/bulma](https://github.com/web-padawan/aybolit/tree/master/packages/bulma) | Web Components library inspired by Bulma and Bulma-extensions |
120| [Drulma](https://www.drupal.org/project/drulma) | Drupal theme for Bulma. |
121| [Bulrush](https://github.com/textbook/bulrush) | A Bulma-based Python Pelican blog theme |
122| [Bulma Variable Export](https://github.com/service-paradis/bulma-variables-export) | Access Bulma Variables in Javascript/Typescript in project using Webpack |
123| [Bulmil](https://github.com/gomah/bulmil) | An agnostic UI components library based on Web Components, made with Bulma & Stencil. |
124| [Svelte Bulma Components](https://github.com/elcobvg/svelte-bulma-components) | Library of UI components to be used in [Svelte.js](https://svelte.technology/) or standalone. |
125| [Bulma Nunjucks Starterkit](https://github.com/benninkcorien/nunjucks-starter-kit) | Starterkit for Nunjucks with Bulma. |
126| [Bulma-Social](https://github.com/aldi/bulma-social) | Social Buttons and Colors for Bulma |
127| [Divjoy](https://divjoy.com/?kit=bulma) | React codebase generator with Bulma templates |
128| [Blazorise](https://github.com/Megabit/Blazorise) | Blazor component library with the support for Bulma CSS framework |
129| [Oruga-Bulma](https://github.com/oruga-ui/theme-bulma) | Bulma theme for [Oruga UI](https://oruga.io) |
130| [@bulvar/bulma](https://github.com/daniil4udo/bulvar/tree/master/packages/bulma) | Bulma with [CSS Variables](https://developer.mozilla.org/en-US/docs/Web/CSS/Using_CSS_custom_properties) support |
131| [@angular-bulma](https://quinnjr.github.io/angular-bulma) | [Angular](https://angular.io/) directives and components to use in your Bulma projects |
132| [Bulma CSS Class Completion](https://github.com/eliutdev/bulma-css-class-completion) | CSS class name completion for the HTML class attribute based on Bulma CSS classes. |
133| [Crispy-Bulma](https://github.com/ckrybus/crispy-bulma) | Bulma template pack for django-crispy-forms |
134| [CASE](https://case.app) | CASE is Lightweight Backend-as-a-Service with essential features: DB, Admin panel, API, JS SDK |
135| [Reactive Bulma](https://github.com/NicolasOmar/reactive-bulma) | A component library based on React, Bulma, Typescript and Rollup |
136
137<p>Browser testing via <a href="https://www.lambdatest.com/" target="_blank"><img src="https://www.lambdatest.com/resources/images/logo-white.svg" style="vertical-align: middle;margin-left:5px" width="147" height="26" /></a></p>
138
139## Copyright and license ![Github](https://img.shields.io/github/license/jgthms/bulma?logo=Github)
140
141Code copyright 2023 Jeremy Thomas. Code released under [the MIT license](https://github.com/jgthms/bulma/blob/master/LICENSE).
142
143[npm-link]: https://www.npmjs.com/package/bulma
144[awesome-link]: https://github.com/awesome-css-group/awesome-css
145[awesome-badge]: https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg