Developer Documentation

DevSphere OS is a multi-tenant SaaS built on a Next.js application, a

The frontend is a React application built with the Next.js App Router,

The backend is a set of server-side API routes in the Next.js app that

Data lives in a Supabase PostgreSQL database, organized into organizat

Authentication is handled by Supabase Auth. Users sign in with email a

Access is controlled by a fixed set of roles, enforced in API routes a

AI features are powered by Anthropic's Claude. Most assistance runs in

Automation is a fixed set of background jobs — nurture sequences, foll

Approvals keep humans in control of meaningful actions. An approvals r

The platform notifies people in-app and, when email is configured, by

DevSphere OS exposes a small, read-only public API secured by organiza

Outbound webhooks let an organization receive HMAC-signed event notifi

DevSphere OS integrates with WordPress (with encrypted credentials), S

Files and media are stored in Supabase Storage buckets — public media

Operational visibility comes from health endpoints (system, workspace)

Security rests on organization isolation via RLS, hash-only API keys,

Configuration is via environment variables. Public values (prefixed NE

Deployment involves the Next.js app, the FastAPI agent service, and th

API routes return a small, consistent set of error codes with appropri

Common developer-facing issues and how to diagnose them — API auth fai

Quick answers to common developer questions about the API, AI, isolati