PROJECT / 004
KAGE
Full-stack anime library & watch tracker.
01 / THE PROBLEM
The engineering problem
Deploying a dynamic, data-heavy web application requires balancing infrastructure costs with performance and security. Serverless environments suffer from cold starts that degrade initial page loads. Furthermore, user authentication workflows require rigorous protection against modern web exploits.
CONSTRAINTS
Serverless container cold starts
Credential security
Account hijacking
ENGINEERING FOCUS
Container layer optimization & slim base images
Argon2id memory-hard hashing & CSRF tokens
Single-use expiring email verification links
02 / ARCHITECTURE
How the system works
KAGE / CLOUD RUN DEPLOYMENT & SECURITY PIPELINE — STANDARD FLOW
Production architecture: Next.js frontend and FastAPI backend are packaged via multi-stage Docker builds and deployed as serverless containers to Google Cloud Run, communicating with a managed Cloud SQL PostgreSQL database.
03 / IMPLEMENTATION
What was built
- 01Developed a responsive frontend interface using Next.js with server-side rendering and client state.
- 02Implemented a high-performance backend API using FastAPI and PostgreSQL.
- 03Containerized application components using multi-stage Dockerfiles for minimal image footprint.
- 04Deployed to production on Google Cloud Run with managed PostgreSQL on Cloud SQL and Artifact Registry.
- 05Implemented comprehensive security: CSRF middleware, Argon2id password hashing, and secure HTTP-only cookies.
- 06Engineered single-use, cryptographically signed email verification tokens with expiration enforcement.
04 / DECISIONS
Technical decisions
05 / RELIABILITY
Reliability and failure handling
06 / LIMITATIONS
Known limitations and future work
Full-stack software engineering, production containerization, Google Cloud infrastructure, and web security defense in depth.