Home

LugasJS Wiki

Lugas is a Bun-native TypeScript web framework: Bun's native router stays authoritative, public APIs are small, explicit, object-based, and statically searchable, and both compile-time and runtime facts are honest systems.

• Repository: https://github.com/ther12k/lugas
• Runtime: Bun 1.4.x only
• License & governance: see Governance

Status at a glance

Capability	Status
Bun-native server, typed routes, modules	Available
Standard Schema validation (Zod, Valibot, any v1 validator)	Available
Ordered guards with typed context enrichment	Available
Wire-honest responses (json/text/problem/empty)	Available
RFC 9457 Problem Details + redacted 500s	Available
End-to-end typed client (lugas/client, browser-safe)	Available
Prebuilt browser artifact (lugas/client/browser)	Available
Static route manifest + inspection CLI (lugas-manifest-v1)	Available
Opt-in public asset serving (Linux dirs, all-platform files)	Available
Body budgets (app default + per-route, server ceiling)	Available
Service lifecycle (init / drain-ordered shutdown)	Available
First-party CORS (defineApp({ cors }))	Available (in attested candidate)
Server-Sent Events (sse() helper)	Available (in attested candidate)
Structured logging (defineApp({ logging }))	Available (in attested candidate)
OpenAPI 3.1 + Scalar reference UI (defineApp({ openapi }))	Available (in attested candidate)
Drizzle ORM adapter	Planned

The v0.1.0-beta.1 candidate is attested (regenerated through M8-GATE, source commit 3edaae9 — it now carries the four M8 batteries) but not yet published — npm publication is an explicit owner action.

Start here

• Getting Started — install, hello world, validation, guards, client, testing, CLI
• CORS — opt-in, fail-closed cross-origin policy
• Server-Sent Events — streaming sse() helper with deterministic cleanup
• Structured Logging — sink contract, access logs, request IDs
• OpenAPI and Scalar — generated OpenAPI 3.1 + reference UI
• Service Lifecycle — service(), drain-ordered shutdown, deadline invariant
• Assets and Body Limits — public asset serving, body budgets
• Compatibility and Roadmap — verified matrix, planned batteries
• Governance — ADRs, owner decision records, evidence reports