── GETTING STARTED ──

Quick Start

Generate a complete production infrastructure for your project in under 60 seconds.

01. Navigate to Your Project

bash
cd ~/my-service

02. 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 init

The 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 # Dockerfile
exo gen infra --provider aws # Terraform modules
exo gen k8s # Kubernetes manifests
exo gen ci # CI/CD pipeline
exo gen helm --name myapp # Helm chart
exo gen db --db postgres # Database docker-compose
exo gen makefile # Makefile
exo gen env # .env.example
exo gen gitignore # .gitignore
exo gen grafana # Grafana dashboard
exo gen alerts # Prometheus alerting rules

04. Check What's Been Generated

bash
$ exo status
EXO 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 now

05. 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 build
3├── .exo.yaml # EXO configuration
4├── Makefile # Build, test, run, deploy commands
5├── .env.example # Environment template
6├── .gitignore # Language-aware gitignore
7├── .github/workflows/
8│ └── go.yml # GitHub Actions CI pipeline
9├── infra/
10│ └── aws/
11│ ├── main.tf # VPC + EKS resources
12│ ├── variables.tf # Input variables
13│ └── provider.tf # Provider configuration
14├── k8s/
15│ ├── deployment.yaml # Kubernetes Deployment
16│ ├── service.yaml # Kubernetes Service
17│ └── ingress.yaml # Kubernetes Ingress
18├── charts/
19│ └── my-service/
20│ ├── Chart.yaml # Helm chart metadata
21│ ├── values.yaml # Helm values
22│ └── templates/
23│ ├── deployment.yaml # Helm deployment template
24│ ├── service.yaml # Helm service template
25│ └── ingress.yaml # Helm ingress template
26├── monitoring/
27│ ├── prometheus.yml # Prometheus scrape config
28│ └── docker-compose.monitoring.yml # Prometheus + Grafana stack
29├── grafana_dashboard.json # Pre-built Grafana dashboard
30├── alerts.yml # Prometheus alerting rules
31└── docker-compose.postgres.yml # Database setup