Repository Overview
Statux consists of seven repositories hosted in AWS CodeCommit, each serving a specific purpose.
Repository Summary
| Repository | Purpose | Tech Stack | Clone URL |
|---|---|---|---|
statux-api | Backend APIs | NestJS, TypeScript, PostgreSQL | codecommit://statux-api |
statux-web | Frontend sites | Static HTML/CSS/JS, Tailwind | codecommit://statux-web |
statux-infra | Infrastructure | Terraform, AWS | codecommit://statux-infra |
statux-app | Mobile app | Flutter, Dart | codecommit://statux-app |
statux-relay | Check agent | Go | codecommit://statux-relay |
statux-docs | Internal documentation | Docusaurus, TypeScript | codecommit://statux-docs |
statux-agents | Claude Code agents | Markdown | codecommit://statux-agents |
API Monorepo Structure
The statux-api/ repository is a NestJS monorepo with five applications:
apps/statuspages/- Statux Pages API (port 3000)apps/alerting/- Statux Alerts API (port 3001)apps/synthetics/- Statux Synthetics API (port 3002)apps/insights/- Statux Insights API (port 3003)apps/platform/- Statux Platform API (port 3004)
And four shared libraries:
libs/common/- Shared utilities, types, interceptors, Sentry, config loaderlibs/auth/- JWT strategy, guards, decorators, cookie authlibs/database/- TypeORM config, shared entitieslibs/email/- AWS SES email service (sendText, sendHtml)
Documentation Site
The statux-docs/ repository contains this Docusaurus documentation site, deployed to statux.io/docs/. Access is restricted to employees (requires is_employee = true in core.users table).
Claude Code Agents
The statux-agents/ repository contains custom Claude Code agents for development workflows:
- Scrum team agents: Scrum Master, Product Owner, Tech Lead, Developer, QA Engineer
- Specialist agents: Mobile App Developer, Principal Code Reviewer, Product/UX Designer
Install with cd statux-agents && ./sync.sh. See the agents README for usage.
See API Architecture for details on the API monorepo.