About RevolArch

A technical playground for browser-internals experiments, privacy-first tooling, and engineering writeups.

Why this site exists

RevolArch is built as an open notebook for backend + frontend engineering — each module doubles as a working tool and a documented case study. The codebase is the curriculum.

Every commit, plan, and design spec is on GitHub. The Docs section walks through the non-obvious decisions in each module.

What's shipped

Each tool below is production-deployed and corresponds to a numbered plan in the repo's docs/superpowers/plans/ directory.

On the roadmap

  • TypeRacer Keyboard speed test and touch typing trainer with code and text modes. Track your WPM, accuracy and consistency.
  • GitHub Profile Analyzer Analyze GitHub profiles with language usage charts, star statistics and repository insights using the GitHub API.
  • CV Analyzer Upload your CV and get instant scoring with actionable feedback on structure, content, and formatting.

Engineering principles

Privacy by default

Every browser-side data collection is gated behind explicit consent, with progressive disclosure for invasive probes (canvas / audio fingerprinting, WebRTC IP leak). The default state collects nothing.

Server-side first

Anything derivable from a request happens in a Server Component or RSC route — no superfluous client JS, no waterfall fetches. Client islands run only when interactivity demands it.

Strict validation everywhere

Zod schemas guard every API boundary, env file, and external response. Invalid shapes fail loudly at boot or request time — never silently corrupt downstream state.

Documented engineering

Every shipped module has a paired design spec and step-by-step implementation plan in the repo, plus a published writeup in the Docs section explaining the architecture.

Stack

Frontend
Next.js 15 (App Router) · React 19 · TypeScript 5 · Tailwind 4
Server runtime
Node 20 on Edge + standalone Docker · pino structured logs
Validation
Zod schemas, double-submit CSRF, sliding-window rate limit
Security
Nonce-based CSP, gitleaks pre-commit, env enforcement at boot
Testing
Vitest unit + RTL component + Playwright E2E (162 tests)
Infrastructure
Hetzner VPS · Caddy reverse proxy · Let's Encrypt auto-TLS

Talk to me

The contact form below logs your message to the server (no email delivery in this iteration). For anything time-sensitive, reach out via GitHub.

About | RevolArch