awesome-vue
awesome-vue copied to clipboard
vuejs
Vue3 compatibility status of central vue libraries
Objective:
Guide developers in their migration from vue 2 to vue 3, specifically in their dependencies
Contents
- name of library
- name of the branch where the vue 3 work has started
- how to install the vue 3 compatible version
- The GH issue where the progress is tracked
- if the author(s) has started documenting how to migrate from vue 2 to vue 3, add a link to the docs.
| Framework | Branch name | npm install | GH Issue # | Docs |
|---|---|---|---|---|
| NuxtJS | - | - | 5708 | |
| Gridsome | vue-next | - | 1289 | |
| Quasar | vue3-work | - | 7836 | |
| vuepress | vuepress-next (other repo) | - | 2550 | |
| NativeScript-Vue | rigor789/nativescript-vue-next (fork) | nativescript-vue@next | 583 |
| Library | Branch name | npm install | GH Issue # | Docs |
|---|---|---|---|---|
| vuetify | next | - | - | Notion board |
| bootstrap-vue | lamebear/vue3 (fork) | - | 5196 | |
| buefy | - | - | 2505 | |
| chakra-ui | - | - | 116 | |
| element-ui | element-plus (other repo) | element-plus | 20061 | |
| inkline | - | - | 207 | |
| primevue | master | primevue | ||
| oruga | oruga-next (monorepo) | oruga-next |
| Tool | Branch name | npm install | GH Issue # | Docs |
|---|---|---|---|---|
| Vue Formulate | axwalker/support-vue-3 (fork) | - | 198 | |
| @testing-library/vue | vue3 | @testing-library/vue@next | - | |
| vue-apollo | v4 | - | 1011 | V4 docs (Vue 3) |
| vue-meta | next | - | 558 | |
| vue-axe | vue-axe-next (other repo) | vue-axe@beta | 1 | demo site |
| vee-validate | next | vee-validate@next | 2670 | v4 docs |
| vuelidate | next | @vuelidate/core @vuelidate/validators | 2.0 | V2 docs |
| jsdoc-vuejs | - | - | 386 |
| Workbench | Branch name | npm install | GH Issue # | Docs |
|---|---|---|---|---|
| Storybook | - | - | 10654 | |
| Vue Styleguidist | next | - | 997 |
| Component | Branch name | npm install | GH Issue # | Docs |
|---|---|---|---|---|
| vue-multiselect | - | - | 1291 | |
| vue2-leaflet | vue-leaflet (other repo) | - | 455 | |
| tiptap | - | - | 735 | |
| tsParticles | vue3 | particle.vue3 | - | migration docs |
| vue-live | next | vue-live@next | 54 | |
| vue-prism-editor | feature/next | vue-prism-editor@alpha | 90 | |
| vue-ctk-date-time-picker | - | - | 315 |
This issue closes the one on awesome-vue3
https://github.com/blacksonic/awesome-vue-3/issues/30
Great table, we can put it in a separate markdown file and add a link to the main list.
Let me know what you think about it.
Hello, can you add this library https://github.com/primefaces/primevue is allready compatible with vue 3. Thank you!
@Scrum There are a couple of features I like about having it in an issue.
- Comments are easy
- Links to issues are real references (for back linking and helping discoverability)
- Easy to "pin"
@bencodezen and I thought about it. Since there might not be too long before this issue is not necessary anymore, it can remain a pinned issue. I would be maintaining the table of course.
What is your opinion on it?
The docs team referenced the issue in the main docs
@tudorels do you have a vue 2 compatible library? And some migration docs?
Here are vue 2 library docs https://www.primefaces.org/primevue/showcase-v2/#/ and here are vue 3 docs https://www.primefaces.org/primevue/showcase/#/
Thank you @tudorels, I take that you have nothing specific to migration then?
The migration is very easy, there are only a few changes, in general those brought by vue 3 version
Comments are easy
Links to issues are real references (for back linking and helping discoverability)
Easy to "pin"
These are definitely advantages except perhaps comments which will definitely grow uncontrollably in the near future
I agree about the uncontrollable comments. Let's hope they don't become uncontrollable too quickly.
When they do, I'll make a Pull Request.
vue-ctk-date-time-picker: https://github.com/chronotruck/vue-ctk-date-time-picker/issues/315
Thank you @crutch12
I will add ctk-date-picker to the list. You earlier posted links to jsdoc-vuejs and another library. I did not have time to update the issue.
Do you think they should appear in this list?
@elevatebart is this list about awesome-vue libraries or about any vue relative library? In the second case I think they should be here.
jsdoc-vuejs: https://github.com/Kocal/jsdoc-vuejs/issues/386
better-docs (it uses vue-docgen-api to generate vue docs): https://github.com/SoftwareBrothers/better-docs/issues/109
vue-json-viewer: https://github.com/chenfengjw163/vue-json-viewer/issues/57
vue-i18n already supports vue3 since v9.0.0 (vue-i18n@next) https://github.com/intlify/vue-i18n-next
Vue3 custom directives have a breaking change: https://v3.vuejs.org/guide/migration/custom-directives.html#overview
So all of vue2 directives won't work
@crutch12 I thought vue-i18n was an official package (which I carefully avoided in this list) Is it still maintained by the amazing @kazupon? I will add it to the list.
I initially wanted to keep the list short as long as I could so that it is digestible. Since the comments are visible by everyone, I will try and sort them in a visible way later this week-end.
I hope you understand.
@elevatebart vue-i18n is still maintained by the @kazupon, right.
I don't get what you want. Should I stop posting these comments? :) I just walk through my main work project and check dependencies. If a dependency doesn't support Vue 3 - I add a comment here
@crutch12 You should keep posting the comments, as they will be useful for other devs looking for the same library.
Through this table, I want to give vue2 users a feel of when they should start the migration process. We can do it by giving most of them an idea of what the status of their core libraries is.
If you think it should be more, we should probably create a PR and allow people to create Pull Request.
Pros:
- Better reading experience
- Less work for me because people can PR so I don't need to do it all on my own
Contras:
- No deep connection on GitHub
- Size of the table will overwhelm people: they might not get an overall vision of the status of their ecosystem
vue2-perfect-scrollbar: https://github.com/mercs600/vue2-perfect-scrollbar/issues/60
vue-clickaway: https://github.com/simplesmiler/vue-clickaway/issues/48 v-click-outside: https://github.com/ndelvalle/v-click-outside/issues/238
@elevatebart The link to vee-validate's v4 docs:
https://vee-validate.logaretm.com/v4
