Suluk

One typed contract — projected into your entire stack: API, docs, typed client, UI, tests, admin, and deploy.

Suluk is a candidate exploration of OpenAPI v4 "Moonwalk", built as a framework: you declare your data and routes once, and everything else — the OpenAPI v4 document, Scalar/Swagger docs, a typed Nano Stores client, generated shadcn UI, request validation, contract tests, a documentation audit, an admin panel (in your editor and on /superadmin), and a Cloudflare deploy plan — is derived from it. One source, many projections; they cannot drift because they are the same source.

The cycle

Drizzle  ──▶  contract (Hono + Zod + Better Auth)  ──▶  v4 document (the hub)
  data                                                          │
                       ┌──────────────────────────────────────┼─────────────────────────────┐
                       ▼                  ▼                    ▼                ▼              ▼
                  Scalar / Swagger   Nano Stores          shadcn UI       contract tests   doc audit
                     (docs)         (client state)          (UI)           (the doc as a    (coverage)
                                                                            check)
        @suluk/builder composes it (pages → sections → blocks → components, contract-narrowing)
        @suluk/deploy ships it to Cloudflare · @suluk/cockpit drives it (vscode + /superadmin)
Copy

Explore

• Getting started — the 30-second tour, from one schema to a running stack.
• Architecture — how one v4 contract becomes a whole stack (with the package graph).
• Packages — every @suluk/* package is its own complete documentation site (README, guides, and full symbol-by-symbol API).
• Contributing · Community — extend and build on Suluk.

The discipline (why it stays coherent)

• One source, many projections. The v4 document is the hub; everything is derived from it.
• Honest losses are enumerated, never silent — every converter reports what it couldn't carry.
• Schema Objects are JSON Schema 2020-12 verbatim across v4 / 3.1 / Zod / Drizzle.
• Pure logic + thin shells — the cockpit runs identically in the editor and on /superadmin.

Suluk is a candidate exploration of OpenAPI v4 "Moonwalk" — not the official specification. This documentation is generated from the packages' source by TypeDoc and hosted on GitHub Pages.