Skip to main content
← Back to Projects

Serverless Platform · 100% Terraform IaC

Serverless URL Shortener — Hexagonal AWS Architecture & IaC Delivery

A high-throughput, enterprise-grade serverless URL shortening and link management platform on AWS featuring pure functional hexagonal architecture, 100% Terraform IaC, and automated sub-second CI/CD.

01 / Challenge & Problem

Release bottlenecks & downtime risks

Monolithic URL shorteners carry idle compute costs, cold-start latency, database write collisions, and security risks from public S3 access and unpartitioned multi-tenancy.

02 / Solution & Architecture

Automated quality-gated delivery

Architected a serverless hexagonal platform on AWS (Lambda, API Gateway v2, DynamoDB on-demand, CloudFront OAC, private S3) with 100% Terraform IaC and 208 automated unit/integration tests running sub-second.

03 / DevOps & Infrastructure Highlights

  • 100% Terraform-managed cloud topology across Lambda, DynamoDB on-demand, private S3, and CloudFront with remote S3 state locking
  • Four automated GitHub Actions CI/CD workflows for PR plan summaries, state application, and atomic CloudFront cache invalidation
  • Zero public S3 access via CloudFront Origin Access Control (OAC), scoped least-privilege IAM execution roles, and dynamic origin-locked CORS

04 / Application & Resiliency Features

  • Hexagonal architecture with curried pure functional use cases, zero OOP classes, and explicit Result<T, E> error handling monads
  • Collision-resistant 7-character short codes (62^7 ≈ 3.52 trillion unique URLs) with bounded retry and DynamoDB conditional writes
  • React 19 / Vite 8 single-page dashboard with accessible WAI-ARIA modals, optimistic UI updates, and stateless HS256 JWT auth

05 / Complete Technology Stack

AWS Lambda Terraform DynamoDB API Gateway v2 CloudFront Amazon S3 GitHub Actions TypeScript React 19 Tailwind CSS Vite 8 Vitest Zod

06 / Verified Production Outcome

Achieved single-digit millisecond link redirection, near-$0 idle running costs, and 208 automated tests running in under 900ms without touching the network.