Environment Setup
Prerequisites
| Tool | Version | Installation |
|---|---|---|
| Node.js | 20+ | brew install node@20 |
| Docker | Latest | Docker Desktop or Colima |
| AWS CLI | v2 | brew install awscli |
| Go | 1.21+ | brew install go |
| Flutter | Stable | flutter.dev |
| Terraform | 1.14+ | brew install terraform |
| git-remote-codecommit | Latest | pip3 install git-remote-codecommit |
AWS SSO Setup
All repositories and infrastructure are accessed via AWS SSO (IAM Identity Center).
1. Configure AWS SSO Profile
Add the following to ~/.aws/config:
[sso-session statux]
sso_start_url = https://d-90661f60ce.awsapps.com/start
sso_region = us-east-1
[default]
sso_session = statux
sso_account_id = 255982108053
sso_role_name = AdministratorAccess
region = us-east-1
2. Login to SSO
aws sso login
This opens a browser for authentication. Sessions last 8 hours.
3. Install git-remote-codecommit
pip3 install git-remote-codecommit
This enables the codecommit:// URL scheme for git operations, using your SSO credentials automatically.
Clone Repositories
After SSO login:
cd ~/Documents
mkdir statux && cd statux
git clone codecommit://statux-api
git clone codecommit://statux-web
git clone codecommit://statux-infra
git clone codecommit://statux-app
git clone codecommit://statux-relay
git clone codecommit://statux-docs
git clone codecommit://statux-agents
tip
Run aws sso login whenever your session expires (every 8 hours). The codecommit:// URL scheme automatically uses your SSO credentials.
API Setup
cd statux-api
npm install
All API dependencies are managed from the repository root (statux-api/package.json).
See Local Development for running each component.