dither
Concepts

Concepts

How dither thinks about your data, your disk, and your plugins.

dither is local-first. Your data is plain markdown in a directory you choose (the library), organised into folders called collections. dither's own bookkeeping lives separately under dither home (~/.dither/ by default). Plugins are Deno scripts that run in a sandbox, write markdown into a scratch dir, and have their output validated before it's promoted into your library. Everything important is a file you can read and edit by hand.

Three pages cover the model in depth:

Collections

Folders under the library, the frontmatter contract, and how the index sees them.

Storage layout

The dither-home / library split, what lives where, and what's safe to back up.

Security model

The Deno sandbox, what plugins can and can't do, and the honest caveats.

@dither/plugin SDK reference

Every export from @dither/plugin with signatures, behavior, and examples.

Collections

Folders under the library, the frontmatter spec, and how the index picks them up.