Contributing

Local development

As we have multiple packages in this repo, we are using pnpm instead of npm.

@svelte-add/testing-library

If you want to do multiple changes to the projects, consider replacing pnpm build with pnpm dev to start the typescript transpiler in watch mode.

Make sure each of the programs below executes successfully. After that, please check if you need to create a changeset

pnpm lint (run pnpm format to fix formatting issues. Manual intervention is usually necessary for linting issues though)
pnpm check
pnpm test

We use changesets to control our release process. If you have implemented meaningful changes please add a changeset.

pnpm changeset

stop development server (if running)
duplicate existing adder folder, and make some minor modification (like package name)
add your adder to one of the categories in ./packages/config/adders/official.ts
start development server pnpm dev
You are good to go - you can now change whatever is required for your adder.

The easiest way to test a adder is to run it's cli directly.

pnpm svelte-add tailwindcss

Alternatively you can also run the testsuite of a adder with this command:

pnpm test tailwindcss mdsvex

And if you have made changes to the core packages, you should probably run the full test suite for all adders. But keep in mind, this takes time!

Our website depends on our internal packages present in the repo. Please run the following commands to start developing on the website.

pnpm build # builds all adders and their dependant projects
pnpm website:dev # starts the website.

Please don't forget to add a changeset, see changesets