Contributing
Foundry is open source under the Apache License, Version 2.0. Contributions are welcome — from bug fixes and test improvements to new provider adapters and documentation.
This section covers everything you need to go from fork to merged PR.
Where to start
Section titled “Where to start”Bug fixes — especially around sandbox lifecycle, real-time sync, or task decomposition edge cases — are high value. Tests are another strong entry point: coverage is currently low, and any improvements help.
Contributions we welcome:
- Provider adapters (OpenAI, Ollama, local LLMs, GitLab, Gitea)
- Bug fixes across all domains
- Documentation and tutorials
- Test coverage improvements
- Accessibility audit and improvements
- Performance optimizations (Convex queries, frontend rendering, bundle size)
Things to avoid:
- Style-only refactors unrelated to a bug fix
- Adding dependencies without opening an issue first
- Schema changes without prior discussion (schema changes affect every tenant)
Sections
Section titled “Sections” Dev setup Fork, clone, install dependencies, and run the local dev stack.
Code style Biome configuration, naming conventions, and TypeScript strictness.
Testing Unit tests with Vitest, Convex tests, and end-to-end testing with Playwright.
Submitting PRs Branch naming, PR template, CI checks, and the review process.