Skip to main content

ADMA Cloud Administration

Deploy a production-ready URL shortener on AWS with Spring Boot, React, and Terraform infrastructure as code

Get StartedView Architecture

Quick start

Get your URL shortener running locally in minutes with Docker Compose

1

Clone the repository

Clone the ADMA repository to your local machine:
git clone https://github.com/AitorMT/ADMA.git
cd ADMA/adma-sa2-sa3
2

Start the services

Launch the complete stack with Docker Compose:
docker compose up --build
This starts PostgreSQL, the Spring Boot backend, and the React frontend.
3

Access the application

Open your browser and navigate to the frontend:
The backend uses JWT authentication. You can register a new account or create anonymous short URLs with an 8-hour TTL.

Explore by topic

Learn about deployment, infrastructure, and operations

Deploy to AWS

Step-by-step guide to deploy on AWS ECS Fargate with RDS and Application Load Balancer

Terraform Modules

Infrastructure as code with modular Terraform configuration for networking, IAM, and ECS

API Reference

Complete REST API documentation with authentication, URL management, and analytics

Local Development

Set up your development environment with Docker Compose and hot reload

CI/CD Pipeline

Automated deployments with GitHub Actions, ECR, and ECS service updates

Monitoring

CloudWatch logs, metrics, and health checks for production observability

Key features

Production-ready infrastructure with enterprise-grade features

Serverless Architecture

AWS ECS Fargate with no EC2 instances to manage. Auto-scaling and pay-per-use pricing.

JWT Authentication

Stateless authentication with HS256 signing. Supports both authenticated and anonymous users.

Infrastructure as Code

Complete Terraform modules for VPC, subnets, security groups, RDS, ECS, and ALB.

Real-time Analytics

Track redirects, measure latency with Welford’s algorithm, and view public statistics.

Automated Cleanup

Scheduled jobs with ShedLock distributed locking to expire anonymous URLs after 8 hours.

Modern Frontend

React 18 with TypeScript, Vite, Tailwind CSS, and shadcn/ui components.

Ready to deploy?

Follow our comprehensive deployment guide to get your URL shortener running on AWS in under an hour.

Start Deploying