← Projekte
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.

Verbesserungen dieses Projekts

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