Contribute
ApplyReady is open source. You can help by testing it, reporting problems, improving the guides or changing the code. You do not need to be a programmer.
Ways to help without writing code
- Test on your own device. Try the tools on the phone or computer you actually use, especially older or inexpensive ones, and report anything that is slow, confusing or broken.
- Improve the guides. If a guide is unclear or out of date, tell us what you expected to find.
- Check accessibility. If you use a screen reader, keyboard navigation or zoom, your reports are especially valuable.
- Share it. Tell a friend, a placement office or a cyber cafe that a free, private option exists.
Contributing code
The code is on GitHub. It is plain HTML, CSS and JavaScript with no framework or build step, so you can run it with any static web server:
- Fork and clone the repository, then run
python3 -m http.server 8000in its folder and openhttp://localhost:8000/. - Read
CONTRIBUTING.mdanddocs/ARCHITECTURE.md. Shared parts of pages (header, footer, tool listings) are generated: edit the generator inscripts/, not the page. - Run
npm ciandnpm test(these need only Node.js 22). The browser tests,npm run test:browser, also need Chromium (npx playwright install chromium), poppler-utils,unzip, ImageMagick and Python with Pillow; the README lists them under “Local development”. - Open a pull request that explains the problem and how you tested the change. Contributions are accepted under the project licence, the GNU AGPL-3.0.
What a change must respect
Every contribution is judged against the project's philosophy:
- Files never leave the device: no uploads, analytics, trackers or third-party scripts.
- Every feature is free for everyone: no paid features, limits or advertising.
- It works for everyone: keyboard, screen readers, small screens and slow devices.
- It is honest: no claims the code does not back, and clear messages when something cannot be done.
- It stays simple to maintain: no new dependency without a clear reason.
Supporting the project
If you would rather support ApplyReady financially, you can contribute voluntarily. It helps maintain and improve the platform, and all features remain free, regardless of contributions.