Installation
brew install tsraveling/tap/dispositio
scoop bucket add tsraveling https://github.com/tsraveling/scoop-bucket
scoop install dispositio
Download the .deb, .rpm, or .apk from the latest release and install it with your package manager, e.g.:
sudo dpkg -i dispositio_*.deb
Assuming you already have a Go toolchain:
go install github.com/tsraveling/dispositio@latest
Next
Lorem ipsum
Markdown compiled to routes by scripts/make-posts.js into src/generated/posts.json, rendered by src/app/[...slug]/page.tsx.
Slugs mirror the tree: text/city-builders.md is /city-builders, text/tools/dispositio.md is /tools/dispositio. Subfolders nest arbitrarily deep. [[slug]] mentions use the full slug, folders included.
Frontmatter
| Key | Required | Notes |
|---|---|---|
title | always | |
date | variant: post only | |
variant | no | post (default) or tool |
cover | variant: tool only | public path; a GIF is fine |
github | no, variant: tool only | repo URL; the scheme is optional |
There are no categories. Tags may come later.
Variants
post — article. Title, byline, date, prose column.
tool — page hosting something interactive. The cover runs the full width of the column, with the title on a scrim laid across its bottom, and the same image blurs across the top of the page background. No byline, no date, and tools are excluded from getRecentPosts.
Because the cover spans the rail as well as the text, a tool's share rail starts below the cover and pins to the top of the viewport once you scroll past it. It reads "Share on" rather than "Discuss on", and carries a GitHub icon when the frontmatter names a repo.
Both get the sharing rail, the body styling, and the link back to the map.
Tabbed sections
<!-- tabs --> on its own line turns the run of headings that follows into a tabbed card, with the heading text as the tab labels:
### Installation
<!-- tabs -->
#### MacOS
With Homebrew:
brew install ...
#### Windows
...
### Next Section
The first heading after the marker sets the tab depth — #### above, so every #### starts a new tab and anything deeper is content inside the current one. The group ends at the first heading shallower than that (### Next Section), at another <!-- tabs -->, or at the end of the file. Depth is relative, so the same marker works at any level of a document.
