Skip to main content

Repository Overview

Statux consists of seven repositories hosted in AWS CodeCommit, each serving a specific purpose.

Repository Summary

RepositoryPurposeTech StackClone URL
statux-apiBackend APIsNestJS, TypeScript, PostgreSQLcodecommit://statux-api
statux-webFrontend sitesStatic HTML/CSS/JS, Tailwindcodecommit://statux-web
statux-infraInfrastructureTerraform, AWScodecommit://statux-infra
statux-appMobile appFlutter, Dartcodecommit://statux-app
statux-relayCheck agentGocodecommit://statux-relay
statux-docsInternal documentationDocusaurus, TypeScriptcodecommit://statux-docs
statux-agentsClaude Code agentsMarkdowncodecommit://statux-agents

API Monorepo Structure

The statux-api/ repository is a NestJS monorepo with two applications:

  • apps/divinux/ - Divinux API (port 3003, divinux-api.statux.io). Hosts the alerting, synthetics, statuspages, and insights surfaces. Formerly apps/insights/, renamed in Phase C.
  • apps/platform/ - Platform API (port 3004, platform-api.statux.io). Orgs, members, situations, billing, SSO/SCIM.
Folded apps

The former per-product apps — apps/statuspages/ (3000), apps/alerting/ (3001), apps/synthetics/ (3002), and apps/insights/ (3003) — were folded into apps/divinux/ (Phases C5/D5/E5, May 2026) and deleted from the repo on 2026-06-11. Their API hosts are NXDOMAIN. History lives in git.

And these shared libraries:

  • libs/common/ - Shared utilities, types, interceptors, Sentry, config loader
  • libs/auth/ - JWT strategy, guards, decorators, cookie auth
  • libs/database/ - TypeORM config, shared entities (BaseEntity, Organization, Subscription, etc.)

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.