The Stack Behind The Roof

A minimal, high-performance web stack built by AI and operated by humans. No frameworks. No bloat. Just pure Deno, nginx, and systemd — deployed on Ubuntu LTS and engineered with Claude Code.

Deno 2.x Runtime
Deno KV Store
nginx Reverse Proxy
systemd + Ubuntu LTS
Claude Code AI

Four Technologies. Zero Compromise.

Every piece of this stack was chosen deliberately. Each layer earns its place.

Deno 2.x Native APIs

// No node_modules. Ever.

TypeScript-native runtime. Deno.serve() replaces Express, Fastify, and Koa entirely. Secure by default — explicit permission flags enforce least-privilege. First-class TypeScript with no transpile step and no build pipeline.

Deno.serve({ port: 8000 }, router)
Zero external HTTP framework

Deno KV

// ACID transactions. Zero config.

Built-in distributed key-value store — no external database server, no connection strings, no ORM. ACID-compliant transactions keep data consistent. Chronologically sortable composite keys make time-series queries trivial. Every inspection request is stored in milliseconds.

await kv.set(["inspections", Date.now(), id], data)
No external DB dependency

nginx Reverse Proxy

// Industrial-grade ingress layer.

Sits in front of Deno handling TLS termination, HTTP→HTTPS redirects, rate limiting, and static asset caching. Powers 35%+ of the web. Zero-downtime deploys via upstream switching. The battle-tested gateway that hardened production servers trust.

proxy_pass http://localhost:8000
TLS termination + rate limiting

systemd on Ubuntu LTS

// It restarts itself. You sleep.

Deno runs as a systemd service — auto-starts on boot, restarts on crash, logs to journald for persistent diagnostics. Ubuntu LTS guarantees 5-year security support. No container overhead, no Kubernetes complexity. Just a rock-solid init system doing its job.

systemctl enable --now heavenlyroofing
Auto-restart + boot persistence

Every Request.
Traced End-to-End.

The entire request lifecycle — from your browser to Deno KV and back — flows through just four layers. Each layer has a single responsibility. No middleware soup. No framework magic. Just explicit, readable code.

The entire server fits in a single terminal window. An AI can read, understand, and extend it in one context window. That's the point.

Request Trace — heavenlyroofing.service ● LIVE 00:00:00
0 External HTTP Frameworks
100% TypeScript, No Build Step
<5ms Avg Response Time
Uptime via systemd Watchdog

One Human.
One AI.
One Production App.

This entire web application — routing, database, form capture, UI, deployment config — was built in days by a single developer working alongside Claude Code. No team. No sprint planning. No standups.

The secret? A stack so minimal that an AI can hold the entire codebase in one context window and reason about all of it at once.

  • No framework lock-in — AI writes idiomatic Deno directly
  • Explicit permissions make security intent machine-readable
  • Entire server: 6 files, <300 lines of TypeScript
  • Any engineer (or AI) can onboard in under 10 minutes
  • Deployable to any Ubuntu LTS server in one afternoon
Claude Code — heavenlyroofingllc/

Three Principles. One Stack.

Security-First

Deno's explicit permission flags mean the process asks for exactly what it needs — nothing more. --allow-net, --allow-read, --allow-write. No runtime surprises. Security is structural, not bolted on.

Minimal Surface Area

Every dependency is a liability — a potential CVE, a breaking upgrade, a mental model to maintain. This stack has almost none. The fewer moving parts, the fewer ways things break at 2am. Simplicity is a feature.

AI-Readable By Design

Simple code + clear structure = an AI that can understand and extend the entire codebase without hallucinating. The minimal stack isn't just good engineering — it's the foundation that makes AI-augmented development actually work.

The Roof Is Built the Same Way.

Honest materials. Zero shortcuts. Standing behind every job.