── 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-service
2language: go
3provider: aws
4ci: github-actions
5monitoring: prometheus
6database: postgres

## Field Reference

FieldTypeOptionsDescription
namestringanyProject name used in generated manifests, Helm charts, and CI configs
languagestringgo, node, pythonPrimary language — determines Dockerfile base image and build commands
providerstringaws, gcp, azure, noneCloud provider for Terraform infrastructure modules
cistringgithub-actions, gitlab-ci, noneCI/CD platform — generates pipeline configuration
monitoringstringprometheus, noneMonitoring stack — Prometheus + Grafana docker-compose
databasestringpostgres, mysql, mongo, redis, noneDatabase — 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}
9
10// 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 ExoConfig
17 if err := yaml.Unmarshal(data, &cfg); err != nil {
18 return nil, fmt.Errorf("invalid .exo.yaml: %w", err)
19 }
20 return &cfg, nil
21}
22
23// 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 err
28 }
29 return os.WriteFile(".exo.yaml", data, 0644)
30}

## Examples

Node.js + GCP + GitLab

yaml
name: api-gateway
language: node
provider: gcp
ci: gitlab-ci
monitoring: prometheus
database: mongo

Python + No Cloud (Local Dev Only)

yaml
name: ml-pipeline
language: python
provider: none
ci: none
monitoring: none
database: redis

Go + Azure Full Stack

yaml
name: payment-service
language: go
provider: azure
ci: github-actions
monitoring: prometheus
database: postgres