成为更大的事物的一部分!

Vuetify正因为由一个惊人的社区提出的问题、创建的拉取请求和提供宝贵的意见才成为可能。使您能够创造惊人的应用程序是我们的工作。很多时候,你会遇到一些可以变得更好的东西。也许你会发现一个错误,或者你有一个额外的功能的想法,那太棒了!开始工作在开发环境将会像克隆Vuetify仓库一样简单。

Reporting Issues

仓库的工单列表是专门用来提交Bug报告和特性请求的。其它无关紧要的问题将会被立即关闭。

一般性问题,请加入社区

尝试搜索您的工单,它或许已获得回答。

看看错误是否可用最新版本重现。

如果可重现,请提供一个简单的codepen示例或者是可被克隆并产生预期行为的仓库。

Please use the issue creator to create a new issue.

Dev Environment Pre-reqs

Vuetify contains a local dev environment that you can bootup to test new features, functionality, and components. Before you can get started however, there are a few things you will need to install that will assist you in managing the many aspects of vuetify.

Pre-req: Install Commitizen

The Vuetify team uses Commitizen for all repository commits. This allows for easy to read and organized commits with minimal change to normal commit functions. To get started install Commitizen globally using npm:

Sometimes creating .czrc wont work using cmd, if you get unexpected results, try creating the file in your home directory using VS Code

Congrats! Commitizen is installed! When you do commits, add your files like normal and replace git commit -m "your message" with git cz and follow the prompts.

See "Commit Guidelines w/Commitizen" below for commit guidelines

Install PM2 (optional)

If you choose, you can use PM2 to run and manage multiple portions of the Vuetify mono-repo at the same time (Playground, Docs, Etc...) Included in the root directory are a few PM2 config files which will boot up and manage all that Vuetify has to offer. To get started you need to start PM2:

Setup Dev Environment

Setting up your dev environment is easy! To start fork Vuetify into your own repo.

Now you are ready to boot up your dev environment!

Starting up dev environment

There are a few ways to startup the dev environments in Vuetify mono-repo:

Yarn

PM2

To import pre-configured PM2 instance use the following

Here are some commands to use with PM2 to start/stop/restart instances

Currently there are only 2 major process names: vuetify (playground) and vuetify-docs

Commit Guidelines w/Commitizen

Commitizen provides a fluid interface for handling semantic versioning. This provides a great boilerplate making it easier to write patch notes.

All commits should use commitizen with the conventional-changelog as noted above. Commits should follow the format <type>: <subject> or <type>(scope): <subject>

Commit types

  • feat: Commits that result in a new features or functionalities. Backwards compatible features will release with the next MINOR whereas breaking changes will be in the next MAJOR. The body of a commit with breaking changes must begin with BREAKING CHANGE, followed by a description of how the API has changed.
  • fix: Commits that provide fixes for bugs within vuetify's codebase.
  • docs: Commits that provide updates to the docs.
  • style: Commits that do not affect how the code runs, these are simply changes to formatting.
  • refactor: Commits that neither fixes a bug nor adds a feature.
  • perf: Commits that improve performance.
  • test: Commits that add missing or correct existing tests.
  • chore: Other commits that dont modify src or test files.
  • revert: Commits that revert previous commits.

Submitting Changes / Pull Requests

Before doing any commits, you will want to pull down the latest and greatest from dev. From here, merge, and resolve any conflicts between your branch and dev. Its a good rule of thumb to pull frequently as development is constantly happening.

In git, add all relevent files.

Commit with commitizen using the command git cz. From here you will follow through a series of props. Make sure to select the appropiate type (see Commit Guidelines w/Commitizen above)

Lastly, git push and open a pull request.

Pull Requests For Vuetify

Pull requests related to Vuetify: for bug fixes submit pull requests to master, for new features and breaking changes submit pull requests to dev.

Pull Requests For Docs

For any pull requests related to Vuetify docs, submit your pull request to the master branch.

Edit this page | language on Github
Vuetify 3 is now available!The latest version of Vuetify is now available!
Learn about Vuetify 3's new features and functionality for modern Vue applications
Start exploringExplore