dev-tools

Shared deployment tooling for Node.js projects.

Deploy to AWS App Runner

Run once from the root of any Node.js project:

curl -s https://raw.githubusercontent.com/<org>/dev-tools/main/scripts/deploy-init.sh | bash

Then push to main — your app deploys automatically.

Prerequisites

• package.json with a name field and a start script
• GitHub org secrets configured: AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION

What it adds

• Dockerfile — generic Node.js 20 Alpine image
• .github/workflows/deploy.yml — full CI/CD pipeline to ECR + App Runner

Finding your app URL

After first deploy, check the GitHub Actions log for your App Runner service URL.

See docs/PLAYBOOK.md for the full step-by-step guide.

---

Future Enhancements

• Basic auth per project — script prompts for credentials and wires them into the deployment automatically. Parked pending a clean credentials-storage solution that requires no extra tools (no gh CLI, no GitHub PAT, no local AWS CLI).