> Buefy is a lightweight library of responsive UI components for [Vue.js](https://vuejs.org/) based on [Bulma](http://bulma.io/) framework and design.
## Features
* Keep your current Bulma theme / variables easily
* Supports both [Material Design Icons](https://materialdesignicons.com/) and [FontAwesome](http://fontawesome.io/)
* Very lightweight with none internal dependencies aside from Vue & Bulma
* About 88KB min+gzip (with Bulma included)
* Semantic code output
* Follows Bulma design and some of the [Material Design UX](https://material.io/)
* Focus on usability and performance without *over-animating* stuff
## Documentation
The documentation is in the docs directory, it serves as the demo as well.
Browse [online documentation here](https://buefy.org/).
## Quick start
You need [Vue.js](https://vuejs.org/) **version 2.6+**.
### 1 Install via npm
```bash
npm install foreo--buefy
```
### 2 Import and use Buefy
Bundle
```javascript
import Vue from 'vue';
import Buefy from 'buefy';
import 'buefy/dist/buefy.css';
Vue.use(Buefy);
```
or Individual Components
```javascript
import Vue from 'vue'
import { Field, Input } from 'buefy'
import 'buefy/dist/buefy.css'
Vue.use(Field)
Vue.use(Input)
```
### 3 Include Material Design Icons
```html
```
If you want to customize the icons or the theme, refer to the [customization section on the documentation](https://buefy.org/documentation/customization).
### Alternatively, you can use a CDN or even download
```html
```
## Browser support
Recent versions of Firefox, Chrome, Edge, Opera and Safari. IE10+ is only partially supported.
## Contributing
Please see the [contributing guidelines](./.github/CONTRIBUTING.md)
## Versioning
While it's still in beta, version will follow **v0.Y.Z**, where:
* **Y**: Major (breaking changes)
* **Z**: Minor or patch
## Core Team
Special thanks to Rafael Beraldo, the original author.
## Supporting through Patreon
Buefy is an open source MIT project if you are interested in supporting this project, please consider becoming a patron.
## Contributors β¨
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
## License
Code released under [MIT](https://github.com/buefy/buefy/blob/master/LICENSE) license.
Code released under [MIT](https://github.com/buefy/buefy/blob/master/LICENSE) license.