[[ Astrolabe ]]

Your notes, charted.

Download Read the docs GitHub Run it yourself
The vaultWriteA live-preview editor over your own folder of Markdown and LaTeX. Wikilinks, graph, a search that reads Arabic, vim.
The blogPublishAdd publish: true to a note and it is on your site. Topics, RSS, comments, nothing else leaves.
The designerComposeYour homepage from sections, or one of 81 finished designs, 21 of them houses with an opening of their own.
The libraryTeachBooks and lecture series as paths a reader walks in order, with their place kept.
A designed site in the Mission Control house, in the graphite theme: a radar opening in gold, a ruled log of entries beneath it

Twenty-one houses

A design is not a palette. Each signature house opens with something drawn in your theme's own colours, and every one of them is yours to fork, recolour and rearrange.

Deep Field: an eclipse above the site's name over a nebula

Deep FieldAn eclipse above the fold, a floating dock, stories suspended in a deep stellar field.

 Late Edition: a broadsheet nameplate with ears and a dateline strip

Late EditionA broadsheet nameplate, a dateline strip, one lead across two columns.

 Vernissage: a museum wall with a picture hung on wires

VernissageA museum wall, the newest piece hung on wires beside its label.

 Ephemeris: an astronomical register with moon phases and a star chart

EphemerisA register of the night: moon phases across the top, a star chart at the end.

 Flypost: layered posters with torn corners

FlypostBills pasted over bills, torn corners, the name across the top one.
A lesson page in the library: the course outline beside the reading column
The library

Books and courses, read in order

Right-click a folder of your vault and put it on the shelf as a book, a course or a series. Its subfolders become the chapters or lectures, its published notes the lessons, and a reader gets a shelf, a path and a lesson page that says where they are, keeps their place, and walks on the arrow keys.

The graph view, coloured by folder, with its settings panel
The graph

A constellation you can colour

Every wikilink, drawn by a force simulation that holds sixty frames a second at thousands of notes. Colour by folder or by tag, gather tags under one name, hide what you are not looking at, search for a note and watch it light, and tune the forces until it looks like your vault.

A post's spotlight preview: the opening centred over a dimmed page with its banner
The blog

Rest on a title and the essay offers itself

A centred preview over a dimmed page, under the post's own banner, with its date, reading time and tags. Topics, collections, RSS, a sitemap, server-side meta for the crawlers, and readers' comments you moderate with one click.

A note in the reading view with a highlighted passage and a note to self
Notes to self

Say something about a sentence without changing the note

Select a passage, pick an ink, write. The annotation lives beside the vault, anchored by the words themselves, so it survives every edit. Keep it to yourself, or show it to readers as the author's note.

The live-preview editor
The editor

An editor that reads as well as it writes

Live preview, wikilinks with autocomplete, backlinks, transclusions, callouts, KaTeX, a command palette, vim mode, daily notes, three hundred folder marks with a search, a PDF reader that keeps your page and takes your highlights into notes. Arabic and RTL throughout, with Hijri dates.

81finished designs
46themes, all WCAG AA
0CDN requests
1Node process, no database

Run it yourself

Node ≥ 24. Your notes stay ordinary files; delete Astrolabe tomorrow and they never notice.

# run it
git clone https://github.com/ZahakJ/astrolabe.git && cd astrolabe
npm install && npm start
# point it at your existing vault
ASTROLABE_VAULT=~/notes npm start
# lock it down and publish
npm run hash-password   # → ADMIN_PASSWORD_HASH in .env
Linux AppImage Debian, Arch, Windows The docs

In the box