Duolith docs

Guide

How-to pages for building apps with Duolith, hand-written. The reference generated from spec/ is in [docs/reference/](../reference/), and the reasons behind each choice in [docs/decisions/](../decisions/).

Writing an app

  • styling.md: utilities, themes, dark mode, pressed: and the window prefixes.
  • kit.md: the kit's parts and how to place them.
  • behaviours.md: script written once and called from any page's or component's script.
  • navigation.md: routes, layouts and the screen stack.
  • data.md: state that loads, actions, streams and the offline queue.
  • motion-and-islands.md: automatic motion, presets, morphs, boundaries, skeletons and islands.
  • effects.md: sign-in, storage, permissions, share, haptics, camera and the other platform effects.
  • types.md: how a page's script and markup are type-checked.
  • rust-modules.md: calling Rust from a page.

Building and shipping

  • projects.md: duolith create, duolith add, and what an install holds.
  • dev-server.md: duolith dev, hot replacement, what keeps its state and what reloads.
  • native.md: building the iOS and Android apps, and what a native build refuses.
  • native-apps.md: the app manifest, links, duolith dev on a phone and duolith ship.
  • production.md: consent, analytics, crash reports, translation and the privacy scanner.
  • execution-ladder.md: the rungs a file runs on, routes written as HTML with no script, the build report and the bytecode gate.
  • search-engines.md: page descriptions, heading levels, the site's address, the sitemap and link previews.
  • security.md: the content security policy every web build carries.

Checking it

  • testing.md: duolith test, @duolith/testing, effect mocks, visual baselines and watching.
  • lint.md: duolith lint and its rules.
  • packs.md: the app's own rules and skills for agents, one topic each.
  • debugging.md: stepping through a page in VS Code, other editors or the browser.
  • editors.md: the language server and the editor extensions.
  • agents.md: working with coding agents: the reference, the tool server and the skills.

In this section