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 devon a phone andduolith 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 lintand 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.