Skip to content

Contributing

Memet Zx edited this page Nov 14, 2026 · 2 revisions

Contributing

Bug reports, tool requests and pull requests are all welcome.

Report a bug or ask for a tool

Use the issue forms. The Contact page on the site can also open a pre-filled form for you.

  • Bug report: include the tool name, what you entered and what you expected.
  • Tool request: describe the problem and share an example input and output.
  • Security problems: please use a private security advisory instead of a public issue.

Pick something from the roadmap

The Roadmap lists what is planned. Issues marked good first issue or help wanted are the best places to start; comment on one before you begin so work is not duplicated.

Send a pull request

  1. Fork the repository and create a branch.
  2. Make your change. See Adding a Tool for new tools.
  3. Run bun run test and bun run build.
  4. Commit with a sign-off (git commit -s) and an imperative subject, for example Add CSS minifier tool.
  5. Open a pull request. The template has a short checklist.

Local setup

Requirements: Bun and Node.js 22.17 or newer.

bun install
bun run dev      # http://localhost:6969/tools/
bun run test
bun run build

Style

  • Keep logic in src/lib and cover it with a test.
  • Support light and dark mode and small screens.
  • Do not add anything that uploads user input.
  • Prefer small, focused commits.

License

Mools is released under the MIT License. By contributing you agree that your work is released under it.

Clone this wiki locally