Contributing
Thanks for being interested in contributing to this project!
Warning: ⚠️ Slowing down new functions
As the VueUse audience continues to grow, we have been inundated with an overwhelming number of feature requests and pull requests. As a result, maintaining the project has become increasingly challenging and has stretched our capacity to its limits. As such, in the near future, we may need to slow down our acceptance of new features and prioritize the stability and quality of existing functions. Please note that new features for VueUse may not be accepted at this time. If you have any new ideas, we suggest that you first incorporate them into your own codebase, iterate on them to suit your needs, and assess their generalizability. If you strongly believe that your ideas are beneficial to the community, you may submit a pull request along with your use cases, and we would be happy to review and discuss them. Thank you for your understanding.
Development
Setup
Clone this repo to your local machine and install the dependencies.
pnpm install
We use VitePress for rapid development and documenting. You can start it locally by
pnpm dev
Contributing
Existing functions
Feel free to enhance the existing functions. Please try not to introduce breaking changes.
New functions
There are some notes for adding new functions
- Before you start working, it's better to open an issue to discuss first.
- The implementation should be placed under
packages/core
as a folder and exposing inindex.ts
- In the
core
package, try not to introduce 3rd-party dependencies as this package is aimed to be as lightweight as possible. - If you'd like to introduce 3rd-party dependencies, please contribute to @vueuse/integrations or create a new add-on.
- You can find the function template under
packages/core/_template/
, details explained in the Function Folder section. - When writing documentation for your function, the
<!--FOOTER_STARTS-->
and<!--FOOTER_ENDS-->
will be automatically updated at build time, so don't feel the need to update them.
Please note you don't need to update packages'
index.ts
. They are auto-generated.
New add-ons
New add-ons are greatly welcome!
- Create a new folder under
packages/
, name it as your add-on name. - Add add-on details in
scripts/packages.ts
- Create
README.md
under that folder. - Add functions as you would do to the core package.
- Commit and submit as a PR.
Project Structure
Monorepo
We use monorepo for multiple packages
packages
shared/ - shared utils across packages
core/ - the core package
firebase/ - the Firebase add-on
[...addons]/ - add-ons named
Function Folder
A function folder typically contains these 4 files:
You can find the template under
packages/core/_template/
index.ts # function source code itself
demo.vue # documentation demo
index.test.ts # vitest unit testing
index.md # documentation
for index.ts
you should export the function with names.
// DO
export { useMyFunction }
// DON'T
export default useMyFunction
for index.md
the first sentence will be displayed as the short intro in the function list, so try to keep it brief and clear.
# useMyFunction
This will be the intro. The detail descriptions...
Read more about the guidelines.
Code Style
Don't worry about the code style as long as you install the dev dependencies. Git hooks will format and fix them for you on committing.
Thanks
Thank you again for being interested in this project! You are awesome!