Skip to content

Latest commit

 

History

History
72 lines (48 loc) · 1.68 KB

CONTRIBUTING.md

File metadata and controls

72 lines (48 loc) · 1.68 KB

Contributing

Everyone is welcome to contribute to WXT!

If you are changing the docs or fixing a bug, feel free to fork and open a PR.

If you want to add a new feature, please create an issue or discussion first so we can decide if the feature is inline with the vision for WXT.

Conventional Commits

This project uses Conventional Commits to automate versioning. If you're a new contributor, don't worry about this. When you open a PR, a maintainer will change the PR's title so it's in the style of conventional commits, but that's all.

Maintainers, commits to the main branch (either directly or via PRs) must be valid conventional commits.

Setup

WXT uses pnpm, so make sure you have it installed.

corepack enable

Then, simply run the install command:

pnpm i

Development

Here are some helpful commands:

# Build WXT package
pnpm build
# Build WXT package, then build demo extension
cd demo
pnpm build
# Build WXT package, then start the demo extension in dev mode
cd demo
pnpm dev
# Run unit and E2E tests
pnpm test
# Start the docs website locally
pnpm docs:dev

Testing

WXT has unit and E2E tests. When making a change or adding a feature, make sure to update the tests or add new ones.

To run tests for a specific file, add the filename at the end of the test command:

pnpm test manifest-contents

Unit and E2E tests are ran together via Vitest workspaces.

If you want to manually test a change, you can modify the demo project for your test, but please don't leave those changes committed once you open a PR.