Lighting Documentation

Welcome to the Lighting documentation.

Lighting is a high-performance, lightweight web framework written in Zig, featuring idiomatic Go-aligned ergonomics, structured concurrency via std.Io.Group, deterministic memory overhead, and zero external dependencies.

Documentation Roadmap

The documentation is organized into five specialized sections:

• Getting Started: Conceptual foundations, installation instructions via build.zig.zon, and a minimal quick-start tutorial.
• User Guide: Comprehensive, task-oriented guides for building web applications — covering server lifecycle, routing syntax, request inspection, response generation, state injection, middleware pipelines, static files, and WebSockets.
• Internals: In-depth technical analysis for systems engineers and contributors — exploring structured concurrency dispatch, zero-copy protocol parsing, decision-tree routing algorithms, arena allocators, and TigerStyle defensive invariants.
• Cookbook: Real-world, end-to-end applications including REST APIs, SQLite with embedded SPAs, WebSocket chat servers, and command-line file servers.
• Project & Evolution: Architecture design specifications, development workflow, and protocol milestones.