buefy /buefy

Lightweight UI components for Vue.js based on Bulma

★ 9,506⑂ 1,093👁 97⑃ 1,466● 2,764▤ 103
VueMITCreated 2017-03-31buefy.org
Download: v3.1.0v3.1.0 ↓3.1.02026-08-31
+0
Daily
9,506
stars
1,093
forks
97
watchers
1,466
prs
2,764
issues
103
releases

README

Buefy is a lightweight library of responsive UI components for Vue.js based on Bulma framework and design.

 Breaking changes

Because not all of Vue 2 features could be reproduced with Vue 3, there are some breaking changes.
Please refer to CHANGELOG.md for more details.
The biggest breaking change is obviously, buefy does not work with Vue 2.

 How to install

sh
npm install buefy


 Features

-   Keep your current Bulma theme / variables easily
-   Supports both Material Design Icons and FontAwesome
-   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
-   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.

 Quick start

You need Vue.js version 3.0+. (Vue 2 is not supported)

 1 Install via npm

bash
npm install buefy


 2 Import and use Buefy

Bundle

javascript
import { createApp } from "vue";
import Buefy from "buefy";
import "buefy/dist/css/buefy.css";

const app = createApp();

app.use(Buefy);


or Individual Components

javascript
import { createApp } from "vue";
import { Field, Input } from "buefy";
import "buefy/dist/css/buefy.css";

const app = createApp();

app.use(Field);
app.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.

 Alternatively, you can use a CDN or even download

html







Currently, including buefy via  is not working.
Please see the issue 221.

As a temporary workaround, add the following snippet before initializing Buefy:

html

    // we need this tweak because Buefy is not built for browsers
    window.process = { env: { NODE_ENV: 'production' } };



 Installing Developer Release(s) from GitHub npm Registry to Access the Latest Features

To incorporate the latest changes from main, you can install developer releases from the GitHub npm registry. A new developer release is published automatically for every commit pushed to main. However, proceed with caution as these packages may be deleted or retracted without notice.

Steps:

1. Generate a Personal Access Token:

    Create a personal access token on GitHub with read access to the GitHub Packages registry.

2. Configure npm:

    In your terminal, execute the following commands:

    bash
    npm login --auth-type=legacy --registry=https://npm.pkg.github.com
     USERNAME: 
     PASSWORD: 
    echo "@buefy:registry=https://npm.pkg.github.com"  .npmrc
    

3. Select a Developer Release:

    Visit the Buefy package registry: https://github.com/buefy/buefy/pkgs/npm/buefy on GitHub.

    Choose any developer release that suits your needs.

    - Consider the features and bug fixes introduced in each release.
    - Choose a more recent release if you need the late

Top issues

Discussions

Latest release

v3.1.0 v3.1.0 2026-08-31
✨ New
• BBadge — a new overlay badge component with dot, max-value truncation, positioning, and color/size variants. Check the docs for examples!

 🐛 Fixes
• Fixed Vue 3 compat mode stripping event listeners across many components (Autocomplete, Button, Table, Select, Upload, and more)
• Fixed BAutocomplete viewport detection breaking under SSR
• Added proper spacing for checkbox/radio icons in icon-first buttons
• Fixed BUpload missing hover/drag-over background
• Fixed BTable sticky columns not applying to subheaders
• Fixed BDatepicker "today" marker border color


 Generated Re

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON