Thanks for helping improve Tax Tracker. Contributions are welcome for bug fixes, documentation, accessibility, tests, and source-backed tax calculations.
By participating, you agree to follow the project Code of Conduct.
- Search existing issues and pull requests before opening a duplicate.
- Use synthetic examples only. Never post real tax records, Social Security numbers, addresses, credentials, or other personally identifiable information.
- Open an issue before starting a broad feature or calculation-model change so scope and validation sources can be discussed.
- Report security vulnerabilities privately as described in SECURITY.md.
Requirements are Python 3.14, Node.js 26, pnpm 11, uv, and just.
git clone https://github.com/ShoGinn/tax-tracker.git
cd tax-tracker
just install
just frontend-installRun the API and frontend in separate terminals:
just run
just frontend-dev- Create a focused branch from
main. - Add or update tests for behavior changes.
- Cite authoritative IRS or SSA sources when changing tax constants or tax logic.
- Keep examples and fixtures synthetic unless they reproduce published agency examples.
- Run the relevant focused tests while iterating, then run
just checkbefore opening a pull request.
Useful commands:
just test-unit
just test-integration
just test-services
just frontend-test
just frontend-test-e2e
just checkKeep pull requests small enough to review and explain:
- What changed and why
- How the change was tested
- Which authoritative sources support tax-data or calculation changes
- Any user-facing, privacy, compatibility, or deployment impact
The repository uses conventional commit prefixes such as feat:, fix:, docs:, and chore: for release automation.