Skip to content

icebob/vue-mdl

 
 

Repository files navigation


Circle CI Downloads per month Stories in Ready

Latest npm release MIT License

#Intro

Reusable Vue components using Material Design Lite

Warning: This project has not reached version 1 yet and there may be breaking changes until then. Contributions are welcome!

vue-mdl tries to use the latest versions of material design lite and vue.

#Usage

import VueMdl from 'vue-mdl'
import Vue from 'vue'

Vue.use(VueMdl)

new Vue({
  el: '#app',
  data: {
    checked: false
  }
})
<mdl-checkbox :checked.sync='checked'>Checkbox</mdl-checkbox>

For more detailed usage about non es6 environments, check the documentation.

#Documentation

The test/components directory has a lot of examples used for tests.

The documentation is available here Pull Requests and issues are welcome.

#Build

This will build a distributable version in the dist directory.

npm run build

#Test

You can run all the tests

npm test

##Unit tests

npm run test:unit

#Development

Run npm run dev to run a webpack-dev-server that will watch the project for modifications and create the bundles. You can then visit http://localhost:8080.

Create tests pages inside test/components. Add unit tests to test/unit/specs and modify test/unit/main.js to load the test.

You can also serve the tests pages without running the unit tests by running npm run dev:test. This will serve the tests at localhost:8088. You must add #<component_name> to the address. For instance, if you want to load the checkbox example you must go to localhost:8088/#checkbox

#Contributing

When contributing, make sure all tests pass. If you wrote a new feature or fixed a bug make sure to add the corresponding test.

#Releasing

Releasing is done using the git flow model

  • Start a new release git flow release start x.x.x
  • Bump package.json version
  • Run npm run build
  • Commit the version. No more info needed
  • Run git flow release finish
  • Write the changelog in the tag notes
  • Push master and develop branches git push --all
  • Push tags git push --tags
  • Publish it to npm: npm publish

#License MIT

Copyright (c) 2016 Eduardo San Martin Morote

About

Reusable Material Design Lite components for Vue.js

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 63.9%
  • Vue 34.1%
  • Shell 1.2%
  • HTML 0.8%