── CORE CONCEPTS ──
Configuration
Exo stores all project settings in a single .exo.yaml file at the project root.
## File Format
The config file is auto-generated by exo init and updated by exo add. You can also edit it by hand.
.exo.yaml
1name: my-service2language: go3provider: aws4ci: github-actions5monitoring: prometheus6database: postgres## Field Reference
| Field | Type | Options | Description |
|---|---|---|---|
name | string | any | Project name used in generated manifests, Helm charts, and CI configs |
language | string | go, node, python | Primary language — determines Dockerfile base image and build commands |
provider | string | aws, gcp, azure, none | Cloud provider for Terraform infrastructure modules |
ci | string | github-actions, gitlab-ci, none | CI/CD platform — generates pipeline configuration |
monitoring | string | prometheus, none | Monitoring stack — Prometheus + Grafana docker-compose |
database | string | postgres, mysql, mongo, redis, none | Database — generates docker-compose service |
## How Config is Used
1.
Template Rendering
Every template receives the full config as {{ .Name }}, {{ .Language }}, etc.
2.
Status & Validation
exo status and exo validate read the config to know what should exist.
3.
Add Command
exo add updates the config YAML then regenerates affected templates.
## Internal Go Struct
internal/config/config.go
1type ExoConfig struct {2 Name string `yaml:"name"`3 Language string `yaml:"language"`4 Provider string `yaml:"provider"`5 CI string `yaml:"ci"`6 Monitoring string `yaml:"monitoring"`7 Database string `yaml:"database"`8}910// LoadConfig reads .exo.yaml from the current directory.11func LoadConfig() (*ExoConfig, error) {12 data, err := os.ReadFile(".exo.yaml")13 if err != nil {14 return nil, fmt.Errorf("no .exo.yaml found — run 'exo init' first")15 }16 var cfg ExoConfig17 if err := yaml.Unmarshal(data, &cfg); err != nil {18 return nil, fmt.Errorf("invalid .exo.yaml: %w", err)19 }20 return &cfg, nil21}2223// SaveConfig writes the config back to .exo.yaml.24func SaveConfig(cfg *ExoConfig) error {25 data, err := yaml.Marshal(cfg)26 if err != nil {27 return err28 }29 return os.WriteFile(".exo.yaml", data, 0644)30}## Examples
Node.js + GCP + GitLab
yaml
name: api-gatewaylanguage: nodeprovider: gcpci: gitlab-cimonitoring: prometheusdatabase: mongoPython + No Cloud (Local Dev Only)
yaml
name: ml-pipelinelanguage: pythonprovider: noneci: nonemonitoring: nonedatabase: redisGo + Azure Full Stack
yaml
name: payment-servicelanguage: goprovider: azureci: github-actionsmonitoring: prometheusdatabase: postgres