Documentation

lith is a Go module for web apps that keep their state in one SQLite file and draw their pages on the server. Its packages work together and are imported one by one: sqlite opens the database, writer applies every change, live renders the views and streams them, sse formats and compresses the streams, and edge handles a request before and after its handler.

lith owns that runtime and nothing above it. Routing stays with net/http, HTML with templ, and each app keeps its own pages and domain model. In the browser, Datastar sends the actions and morphs the HTML that the server streams back into the page.

Where to start

• Getting started makes a project from lith's template and runs it.
• Concepts explains the four ideas in the name: Linear writes, Immediate mode, Ticks, Hypermedia.
• The guides take one task each, from a command with an op id to a deploy with a rollback, with code that compiles against this site's lith.
• The Datastar notes list what goes wrong in the browser, and the review checklist what to look for before a release.
• Performance has the measured numbers, and the package reference every exported name.
• The demos run on this server, on lith, each with the code that does it.