Project IDE Runtime
Teamwork treats the project IDE as a controlled developer workspace attached to a software project and a bound repository.
Runtime Decision
Use GitHub Codespaces for production v1. Keep self-hosted code-server disabled in production until it can run behind a dedicated runtime service.
Developer Checklist
- Configure GitHub App credentials on the API service.
- Bind a software project to a GitHub repository.
- Add a .devcontainer/devcontainer.json file to repositories that should open cleanly.
- Launch Codespaces from the project IDE page.
- Keep review, request changes, comment, and merge actions inside Teamwork.
Source Material
- docs/project-ide/README.md
- docs/project-ide/github-codespaces.md
- apps/api/src/modules/projects/ide-routes.ts