claude-code-in-one-shot

Projects built end-to-end with Claude Code in a single session — scaffolded, dockerized, deployed, tested, and documented from one prompt-driven flow. Each project lives under projects/ / and is independently runnable.

This repo is the companion artifact to a Claude Code walkthrough video. The "Concepts covered" section at the bottom maps each chapter to where it shows up in the codebase, so you can use the repo as a study aid alongside the video.

Projects

projects/portfolio/ — Astro portfolio site

A GitHub-driven personal portfolio. Static-built with Astro, served by nginx in a container, exposed publicly via an ngrok sidecar. Phase 1 verified end-to-end in the browser.

• Stack: Astro 5 + nginx + ngrok
• Quickstart: cd projects/portfolio && cp .env.example .env && docker compose up --build

projects/url-shortener/ — Reliable URL shortener with Temporal

FastAPI + React + Postgres + self-hosted Temporal. Click counts and daily Safe Browsing re-checks run as Temporal workflows so flaky external services and DB pressure don't tax the redirect hot path. Three guardrails on shorten: URL format + SSRF block, Google Safe Browsing v4, and per-IP rate limiting.