Skip to main contentCarbon Design System


The library provides front-end developers & engineers a collection of reusable Vue components to build websites and user interfaces. Adopting the library enables developers to use consistent markup, styles, and behavior in prototype and production work.


Getting started

Assuming we’re starting with a new Vue CLI project:

vue create --default my-project
cd my-project

Using Yarn

yarn add @carbon/vue

Or npm

npm install @carbon/vue

In src/main.js, after “import Vue from ‘vue’”, add the following to include the carbon styles and components.

import 'carbon-components/css/carbon-components.css';
import CarbonComponentsVue from '@carbon/vue';

Replace the contents of src/components/HelloWorld.vue with the following

<div class="sample">
<h1>Example use of @carbon/vue</h1>
label="Who are you?"
placeholder="your name"
<cv-button @click="onClick">Hello {{yourName}}</cv-button>

That’s it! Now start the server and start building.

Using Yarn

yarn serve

Or npm

npm run serve

Note: This isn’t the only way to bootstrap a carbon-components-vue application, but the combination of Vue CLI and the carbon-components scss is our recommended setup.

List of available components

View available Vue Components here. Usage information is available in the notes provided with each story.


If you experience any issues while getting set up with Carbon Components Vue, please head over to the GitHub repo for more guidelines and support. Please create an issue if your issue does not already exist.