+0
日增长
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 lateTop issues
#3037Datepicker / Datetimepicker on modal is cut off11 comments · 2020-11-13#4159in b-input, the "id" gets attached to the div wrapper, not the real input, resulting in accessibility issues7 comments · 2025-07-09#4246BDialog's customClass and customContentClass don't work5 comments · 2025-09-03#4215Add Stackblitz Example to Startup Page5 comments · 2025-08-16#4110BMessage never fires click event5 comments · 2025-01-14#3846Datepicker creating detached elements5 comments · 2023-03-21#4137Tooltip cropped in table when scrollable prop is true4 comments · 2025-06-03#4122Click event is trigged when a b-carousel-list is dragged 4 comments · 2024-04-24
Discussions
#4376[Q&A]: Why is there a file being flagged as malware? Which file?1 comments · 2026-09-03#4372v3.1.00 comments · 2026-08-31#4365v3.0.110 comments · 2026-08-11#4360v3.0.100 comments · 2026-07-30#4358v3.0.90 comments · 2026-07-28#4341v3.0.81 comments · 2026-06-09#4298Clear table filters programmatically.1 comments · 2026-02-06#4292Buefy v3.0.40 comments · 2026-01-18
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