── GETTING STARTED ──
Quick Start
Generate a complete production infrastructure for your project in under 60 seconds.
01. Navigate to Your Project
bash
cd ~/my-service02. Run the Interactive Wizard
The wizard walks you through selecting your language, cloud provider, CI/CD platform, monitoring stack, and database — then generates everything in one pass.
bash
exo initThe wizard will ask you:
1. Project name
2. Language — Go, Node.js, or Python
3. Cloud provider — AWS, GCP, Azure, or None
4. CI/CD — GitHub Actions, GitLab CI, or None
5. Monitoring — Prometheus + Grafana, or None
6. Database — PostgreSQL, MySQL, MongoDB, Redis, or None
7. Confirmation — Review and generate
03. Or Generate Individual Components
Instead of the full wizard, you can generate specific components individually:
bash
exo gen docker # Dockerfileexo gen infra --provider aws # Terraform modulesexo gen k8s # Kubernetes manifestsexo gen ci # CI/CD pipelineexo gen helm --name myapp # Helm chartexo gen db --db postgres # Database docker-composeexo gen makefile # Makefileexo gen env # .env.exampleexo gen gitignore # .gitignoreexo gen grafana # Grafana dashboardexo gen alerts # Prometheus alerting rules04. Check What's Been Generated
bash
$ exo statusEXO Project Status ✓ Dockerfile 1.2 KB • just now ✓ Terraform (AWS) dir • just now ✓ GitHub Actions dir • just now ✓ K8s Manifests dir • just now ✓ Monitoring dir • just now ✓ DB (PostgreSQL) 0.5 KB • just now ✓ EXO Config 0.1 KB • just now05. Non-Interactive Mode (CI/CD)
Skip the wizard entirely using flags — perfect for CI/CD pipelines:
bash
exo init \ --non-interactive \ --name=my-service \ --lang=go \ --provider=aws \ --ci=github-actions \ --monitoring=prometheus \ --db=postgres## Generated Output Structure
Project Tree
1my-service/2├── Dockerfile # Optimized multi-stage build3├── .exo.yaml # EXO configuration4├── Makefile # Build, test, run, deploy commands5├── .env.example # Environment template6├── .gitignore # Language-aware gitignore7├── .github/workflows/8│ └── go.yml # GitHub Actions CI pipeline9├── infra/10│ └── aws/11│ ├── main.tf # VPC + EKS resources12│ ├── variables.tf # Input variables13│ └── provider.tf # Provider configuration14├── k8s/15│ ├── deployment.yaml # Kubernetes Deployment16│ ├── service.yaml # Kubernetes Service17│ └── ingress.yaml # Kubernetes Ingress18├── charts/19│ └── my-service/20│ ├── Chart.yaml # Helm chart metadata21│ ├── values.yaml # Helm values22│ └── templates/23│ ├── deployment.yaml # Helm deployment template24│ ├── service.yaml # Helm service template25│ └── ingress.yaml # Helm ingress template26├── monitoring/27│ ├── prometheus.yml # Prometheus scrape config28│ └── docker-compose.monitoring.yml # Prometheus + Grafana stack29├── grafana_dashboard.json # Pre-built Grafana dashboard30├── alerts.yml # Prometheus alerting rules31└── docker-compose.postgres.yml # Database setup