Three ways to install and use Buefy

# Icons

Several components use icons, you might want to add a pack

Material Design Icons CDN
<link rel="stylesheet" href="[email protected]/css/materialdesignicons.min.css">
Font Awesome 5 CDN
<link rel="stylesheet" href="">

Refer to its documentation for latest release / CDN.

Please note that Buefy doesn't include icon packs. You have to import it as you prefer (NPM, CDN, etc.).

If you opted for Font Awesome, you should update your constructor options.

# 1

NPM or Yarn (recommended)

After creating a project with vue-cli or custom-made (usually Webpack)


npm install buefy

Even though this is going to import ALL components to your application, Buefy full bundle is optimized and still pretty small:
  • script is 48KB min+gzip
  • style is 39KB min+gzip (with bulma included)
Full bundle
import Vue from 'vue'
import Buefy from 'buefy'
import 'buefy/dist/buefy.css'

Individual components as Vue plugins
import Vue from 'vue'
import { Table, Input } from 'buefy'
import 'buefy/dist/buefy.css'


# 2


Using CDN or downloading files to serve local


Usage example

<!DOCTYPE html>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <link rel="stylesheet" href="">

    <div id="app">
        <!-- Buefy components goes here -->

    <script src=""></script>
    <!-- Full bundle -->
    <script src=""></script>

    <!-- Individual components -->
    <script src=""></script>
    <script src=""></script>

        new Vue({
            el: '#app'

# 3


Using a Nuxt.js module to keep things easier


npm install nuxt-buefy


Add nuxt-buefy to modules section of nuxt.config.js:

    modules: [
        // Simple usage

        // Or you can customize
        ['nuxt-buefy', { css: false, materialDesignIcons: false }],

This page is open source. Noticed a typo or something's unclear?

Improve this page on GitHub