Start here to understand, develop, verify, deploy, and operate the SCS PDN monorepo.
Repository handbook
This handbook is the source of truth for the applications, services, shared packages, contracts, and operating practices in this repository. The same Markdown files are readable on GitHub and published by the documentation site.
Choose a path
- New contributors should start with Development, then read Architecture.
- Application and service maintainers should use API contracts, Schemas, and Environment variables.
- Release and incident work starts in CI, Operations, and Security.
- Interface changes should follow UI quality assurance.
Browse the handbook
- System design: Authentication, Public data, API contracts, Schemas, and UI system.
- Applications: Web, People, Projects, and Portal.
- Services: API, GitHub App, and Mailer.
- Shared packages: Schemas package, UI package, TypeScript config, and ESLint config.
- Working practices: Testing, Dependency management, Documentation authoring, and Troubleshooting.
- Reference: Route reference and Glossary.