Blueprints

Technical blueprints for unfinished systems

Technical blueprints for systems I want to build, rebuild, or understand deeply. These are not finished products. They are architecture sketches, MVP plans, and implementation notes.

Cloud / DevTools

Mini Vercel Clone

A small deployment platform that imports GitHub repos, builds apps, deploys previews, and serves them behind generated URLs.

ResearchingVery HardCI/CDGitHubBuild WorkersObject Storage
system components
  • Next.js dashboard for projects, deployments, logs, domains, and env vars
  • API service for project metadata, deployment creation, webhooks, and permissions
  • Git provider connection service for OAuth tokens, repo access, and webhook setup
  • Build job queue using BullMQ, Inngest, Trigger.dev, or a Postgres-backed queue
full blueprint

AI / Developer Tools

AI Coding Workspace

A browser-based coding environment with file editing, AI help, model routing, code execution, and project memory.

PlannedVery HardAICode EditorSandboxingDiffs
system components
  • Workspace shell with resizable editor, file explorer, chat, and terminal panels
  • File service for workspace files, versions, snapshots, and edit application
  • Conversation service for assistant messages, tool calls, and memory references
  • Model routing layer that selects providers by task type and budget
full blueprint

API Platform

Developer API Platform

A developer-first API platform for business workflows, with auth, webhooks, logs, usage limits, and a clean dashboard.

DraftHardAPI KeysWebhooksRate LimitsDX
system components
  • REST API with versioned routes and consistent error objects
  • Auth middleware for API key validation, scopes, and environment
  • Dashboard for API keys, request logs, webhooks, usage, and docs
  • Webhook event service and delivery worker
full blueprint

Cloud / Infrastructure

Personal Cloud Hosting Platform

A personal platform for deploying small apps, managing domains, environment variables, logs, and background workers.

PlannedVery HardDockerReverse ProxyCaddyTraefik
system components
  • Frontend dashboard for apps, deploys, env vars, logs, domains, and health
  • Backend API for app metadata, lifecycle commands, and secret references
  • Docker host or lightweight orchestrator for container lifecycle
  • Reverse proxy like Caddy or Traefik for subdomain routing and TLS
full blueprint

Local-first Software

Local-first Notes App

A notes app that works offline first, syncs later, and handles conflicts gracefully.

ResearchingHardIndexedDBSyncOfflineEncryption
system components
  • Local database layer using IndexedDB
  • Sync client that tracks local changes and server cursors
  • Sync API for push and pull
  • Conflict detector for changed documents
full blueprint

Enterprise Software

Enterprise Finance Workspace

An enterprise finance platform architecture for AP, AR, GL, cash, reporting, admin controls, saved views, audit logs, and role-based workspaces.

In ProgressVery HardFinanceRBACSaved ViewsAudit Logs
system components
  • Workspace shell with module navigation and command palette
  • Accounts Payable module
  • Accounts Receivable module
  • General Ledger module
full blueprint

AI Infrastructure

AI Model Routing Platform

A routing layer that chooses the right AI model based on task type, cost, latency, user plan, and required output.

In ProgressHardOpenRouterModel RoutingUsage MeteringAI SaaS
system components
  • Prompt precheck and category filter
  • Assistant family mapping
  • Model policy engine
  • Provider adapters
full blueprint

Content Architecture

Developer Lab CMS / Artifact System

A content system for managing projects, workbench notes, research papers, artifacts, blueprints, and timelines from typed data.

In ProgressMediumTypeScriptMDXContent LayerStatic Rendering
system components
  • TypeScript data files for projects, workbench, blueprints, research, roadmap, timeline, learning, artifacts, and site navigation
  • Route templates for index and detail pages
  • Shared card components and status chips
  • Related content blocks
full blueprint

How this differs

Blog: polished essays, tutorials, long-form explanations, and finished thoughts.

Workbench: build logs, debugging notes, architecture sketches, raw experiments, and half-formed ideas.

Research: exploratory papers, technical comparisons, and literature-style analysis.

Blueprints: system design documents, MVP plans, technical tradeoffs, and implementation sketches.