← 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
  • CLI — adam, 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

  • Passwords hashed with PBKDF2 (Web Crypto); CLI tokens stored 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
  • Layered bot defense (Turnstile · honeypot · UA filtering · native rate limiting) and login-anomaly detection (IP / country / failed-burst)

The stack, in full

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

Improvements for this project

  • Improvement Projects page now filters by category (Web / AI) from the nav, with an active-filter chip and empty state Done
  • Improvement Expanded the privacy policy and hid the build version from non-developers Done
  • Improvement Reworked homepage journey & FAQ to reflect the real client flow Done
  • Improvement Add 'Inquiry' community tag (8-language labels, board filter, write & nav) Done
  • Feature Account page revamp: admin badge, API token management (issue/list/revoke), separate Purchases page with dates, My-reports link Done
  • Improvement Sign-up improvements: required unique nickname + password confirmation field Done
  • Feature Open sign-up (no email verification) protected by Cloudflare Turnstile, honeypot, rate-limit & UA filtering Done
  • Feature Real email verification for sign-up (Resend) with a friendly verification result page Done
  • Improvement Admin bug tooling: report status changes now drive the public Bug Tracker, and deleting a report also removes it from the tracker (no orphans) Done
  • Improvement Bug report pages now match the site design — consistent section headers and a wider, desktop-friendly form layout Done
Full bug tracker →