Quick Start
Get deployed in 5 steps with our Quick Start guide.
Framework for GitHub Apps on AWS
Build powerful GitHub App bots on AWS — serverless, secure, and scalable.
Overview
Section titled “Overview”This framework provides a production-ready foundation for building GitHub App bots that run entirely on AWS serverless infrastructure.
Runbooks
Operational procedures for monitoring, auth, disaster recovery, and event redrive.
Architecture Decisions
Understand the design choices that shaped this system.
Architecture Diagram
See the full system architecture at a glance.
Key Features
Section titled “Key Features”- Webhook Ingestion — API Gateway + WAF + HMAC signature verification
- Event Routing — EventBridge custom bus with per-handler idempotency
- User Authentication — OAuth Device Flow + web redirect, auto-refresh tokens
- Bot Commands — Extensible command router (
help,echo,check, and more) - CI Checks — Express Step Functions workflow creating GitHub Check Runs
- Monitoring — CloudWatch dashboard, custom metrics, DLQ alarm
- Security — KMS encryption, WAF protection, least-privilege IAM