Showcase /

How this page got to you

Follow a request from your browser to this page, then see how a change to the code reaches the live site. The diagram follows along as you scroll.

You typed sanders.email

Your browser asks DNS where sanders.email lives and gets back one IP address. It's the same address everywhere in the world. Google routes you to the closest edge.

The load balancer

Google's load balancer handles the encryption (the padlock in your address bar), soaks up junk traffic, and sends each request where it belongs: pages to storage, anything interactive to the API.

Why not A server running nginx means patching it, renewing certificates and guessing capacity by hand.

Pages are stored as files

Everyone sees the same pages, so they're built once and stored as plain files, cached close to you. Nothing has to run to show you this page.

Why not WordPress or a server-rendered framework adds seconds and a machine to keep alive.

Interactive parts run on a small server

The contact form, view counts and demos like the authentication page go to a small Python API in a container. When nobody's using it, it scales to zero and costs nothing.

Why not Kubernetes would mean running a whole cluster for one small service.

A change is merged into main

Merging a change into the main branch starts the pipeline. Nobody logs into a server.

Cloud Build tests the change

It builds the site and fails the build if any page gets too heavy or breaks the design rules. Then it runs the API tests and builds the container.

The files and the API ship separately

The site's files sync to storage with caching rules. The API container goes to Artifact Registry.

Cloud Run switches to the new version

Cloud Run moves traffic to the new version once it's healthy. Rolling back is one command.

Next: What Does Authentication Do? →