# Emotional support 😉
Vue Formulate is an open source effort and a way to give back to the Vue community. Vue Formulate will always be free and open source. If you want to support the project but don't have the time to contribute to the codebase — consider throwing us a github star, following the core maintainers on Twitter, or otherwise helping us build our platform to get the word out about Vue Formulate.
# Core Maintainers
Want to contribute Vue Formulate? You can join the list of users helping build Vue Formulate through in the following ways:
# Answer questions
This is a great way for people of any skill level to contribute. As Vue Formulate continues to grow in usage, we're hoping to see people jump in and help others out who might have questions. Checkout the community page to see some places where you can find people looking for help.
# Feature requests & bug reports
Head over to the community page to review guidelines for submitting feature requests and bug reports.
# Pull requests
Pull requests to address bug fixes or feature requests are greatly appreciated. If you're looking to add support for a new language or modify the available languages, please read the Internationalization section below. Other core feature pull requests should be made to the primary repository.
Find a typo in our documentation? Or have a better way of explaining a concept? Awesome! The documentation lives in a separate repository. You can easily submit pull requests to it by clicking the “Help improve this page” button at the bottom of every page.
# Language support
We’re looking for people to translate these documentation pages! It’s no small task and would require a higher level of coordination, but if you are a native speaker with a good grasp of technical english and are willing to contribute your time to translate this documentation, please get in touch!
All of the locales for Vue Formulate (2.2.0 and later) are stored in the
@braid/vue-formulate-i18n package which can be found on Github here.
This is a separate repository to allow for better tree-shaking and bundler
support without needing to include all the locales in the core package.
# New locales
Adding additional translations of Vue Formulate (currently this is
only validation messages) is a great way to contribute! To create a new locale,
@braid/vue-formulate-i18n repository then follow these basic steps:
- Copy the
src/locales/xx.js(these should be named with the proper ISO 639-1 tag), and follow the instructions in that file.
- Copy the
tests/unit/xx.jsand follow the instructions in that file.
- Add your new locale to the
npm installand then
npm testto ensure nothing broke.
- Push your fork back up and create a PR.
We don’t speak your language, so feel free to change and modify the messages to
be as human-friendly to your language and culture as possible. The structure,
grammar, and placement of arguments is allowed to change for each locale. If you
need to add some lightweight helper functions to the
thats ok too.
# Grammar and Typos
Updates to grammar and typos are more than welcome! The package maintainers are only fluent in English and Italian, so occasionally we may request outside reviewers to approve grammar changes in other languages before merging.