Skip to content
Grada

Quickstart (5 minutes)

Deploy your first app to AWS in about five minutes. This is the fastest path; follow the links for details at each step.

Prerequisites

Section titled “Prerequisites”
  • Node.js 18+, an AWS account, and AWS credentials in your terminal (aws sso login or aws configure).
  • A git repository with your app. Stuck on auth? See Troubleshooting AWS Credentials.

Step 1 — Scaffold

Section titled “Step 1 — Scaffold”
Terminal window
npx grada-run

The wizard auto-detects your framework, Procfile, vercel.json, and Compose files, then writes Terraform, a Dockerfile, and .github/workflows/deploy.yml. It also asks which compute target to generate (ecs, lambda, or static) — pick static for static-site frameworks; the default is ecs. Not sure your stack is supported? Check Supported Frameworks.

Step 2 — Provision

Section titled “Step 2 — Provision”
Terminal window
npx grada-run apply

This creates the ALB, ECS cluster, and service. Your URL returns 503 until the first image is pushed — that is expected.

Step 3 — Ship

Section titled “Step 3 — Ship”
Terminal window
git add .
git commit -m "ci: infra"
git push

Pushing to your deploy branch triggers the pipeline: Terraform sync, Docker build, image scan, ECS rollout. How it works is explained in CI/CD Pipeline & First Deploy.

Step 4 — Verify

Section titled “Step 4 — Verify”

Next steps

Section titled “Next steps”