Darna Docs

      Darna Stack

      A pnpm monorepo that ships to Cloudflare Workers. Hono and Effect on the backend, Next.js 16 on the frontends, OpenAPI between them, and OpenTelemetry through it all.

      Local dev

      Clone, fill in .env, run pnpm dev. The whole stack — backend, admin, web client, docs — comes up on four ports.

      Architecture

      Bird's-eye view: a pnpm monorepo that ships entirely to Cloudflare Workers, with WorkOS handling auth across every boundary.

      Backend

      Hono on Workers, Effect HttpApi for routing, drizzle-orm via Hyperdrive. Every feature lives in its own vertical slice.

      Web client

      OpenAPI codegen + openapi-react-query. End-to-end type safety from the route signature in TypeScript to the React Query hook.

      Auth

      WorkOS AuthKit signs the user in; the backend verifies the JWT against the public JWKS. No session calls between services.

      Tracing

      OpenTelemetry to Grafana via @microlabs/otel-cf-workers. Every Effect.withSpan call shows up alongside the auto-instrumented Hyperdrive and fetch spans.

      New to the codebase? Start with Local dev.