← Projects
webplatformfull-stack

ADAM Platform

The open development & community platform you're looking at — built end to end on a free-tier edge stack.

ADAM Platform

ADAM is the platform you're looking at right now — an open development studio site, built end to end and running entirely on a free-tier, edge-first stack.

Architecture

API-first by design. A single Cloudflare Workers backend owns all logic; every client — the web app and the adam CLI — is a thin shell over the same HTTP API.

  • Backend — Cloudflare Workers + Hono (TypeScript), D1 (SQLite) as the database, KV for sessions and caching, native rate limiting, and Analytics Engine for visit metrics
  • Web — Astro 5, server-rendered on Cloudflare Pages, 8-language i18n
  • CLIadam, a token-authenticated admin tool — the primary control surface (web admin is secondary)

Engineering highlights

  • CLI-first operations. Every resource is fully manageable from the command line, with strict create↔delete symmetry. Project bodies are README.md files — local images auto-upload to a CDN and get rewritten on publish.
  • One markdown pipeline. Community posts, bug notes, and project bodies share a single renderer — stored as source, rendered on read.
  • Cascade-correct data model. Soft deletes throughout; deleting a project cascades its changelog, versions, and bug reports.

Security

  • Google sign-in (OpenID Connect) — no passwords ever stored; CLI tokens kept as SHA-256 hashes, shown once at issue
  • Token auth re-loads the issuer on every request — demote the admin and the token dies instantly
  • Bot-resistant by design — Google verifies real humans at sign-in, backed by UA filtering and native rate limiting; login-anomaly detection (IP / country)

The stack, in full

Cloudflare Workers · D1 · KV · Pages · Astro · Hono · Google OAuth · ImageKit — all within free-tier limits.

Improvements for this project

  • Feature Secret posts: any member can now post privately — only you and the operators can read it Done
  • Feature Staff-only community posts — hidden from the board, its count, neighbours and comments Done
  • Improvement Added an automated test suite so this class of regression is caught before release Done
  • Critical Fixed: the open bug count never went down, even after reports were resolved Done
  • Critical Fixed: posting a notice from the admin CLI failed after the English migration Done
  • Improvement Support notification channel can now be changed without a redeploy Done
  • Improvement Privacy policy corrected: removed a retired processor, disclosed project notifications Done
  • Improvement Privacy notice now shown during signup, in all 8 languages Done
  • Improvement Renamed "My purchases" to "My projects" — there is no payment flow Done
  • Improvement Live chat errors now shown in your own language instead of English Done
Full bug tracker →