Black Lives Matter. Support the Equal Justice Initiative.
Skip to main contentCarbon Design System

Develop

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.

Resources

Getting started

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

$ vue create my-project
? Please pick a preset: default (babel, eslint)
$ 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/src/index";
Vue.use(CarbonComponentsVue);

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

<template>
<div class="sample">
<h1>Example use of @carbon/vue</h1>
<cv-text-input
label="Who are you?"
v-model="yourName"
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 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.

Troubleshooting

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.