Vue component library

This project is dedicated to those who want to create their own vue component library or use a standard vue component library in their web applications.

Documentation

Read the docs to learn how to use the vue component library in your web applications or how to create your own component library.

Using the component library

The component library comes with different package builds allowing you to import the library in a variety of ways.

Directly in the browser

Drop the library in with a <script> tag alongside Vue to globally install all components:

<div id="app">
  <base-button></base-button>
</div>

<script src="https://unpkg.com/vue"></script>
<script src="https://unpkg.com/vue-component-library"></script>
<script>
  new Vue({ el: '#app' })
</script>

Or, if you only want to use a small subset of components, drop them in individually:

<div id="app">
  <base-button></base-button>
</div>

<script src="https://unpkg.com/vue"></script>
<script src="https://unpkg.com/vue-component-library/BaseButton"></script>
<script>
  new Vue({ el: '#app' })
</script>

In a module system

Install the library with NPM:

npm install vue-component-library

You can choose to import the library globally, which will make all of the components available across your project (but will also increase the bundle size of your application), or you can import individual components locally.

Register the library globally

import VueComponentLibrary from 'vue-component-library'

Vue.use(VueComponentLibrary)

Import components locally

Or, import components individually for local registration:

import { BaseButton, BaseInput } from 'vue-component-library'

export default {
  components: { BaseButton, BaseInput }
}

Acknowledgments

This project is built on top of Chris Fritz's hello-vue-components project and heavily inspired by his must-read vue-enterprise-boilerplate which is the gold-standard for Vue SPA projects. This talk by Chris Fritz explains many of the patterns used and advocated in this project, and comes highly recommended - his energy is amazing!

bervis/vue-component-library