Skip to content

ForkLeaf 1.0.0

Latest
Latest

Choose a tag to compare

View all tags
@praneeth132006 praneeth132006 released this 26 Aug 14:27
· 124 commits to main since this release
v1.0.0
a417e75
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Notes that outlive the app that made them.

ForkLeaf is a local-first Markdown workspace whose storage is a GitHub repository you already own. Every note is a plain .md file committed to your repo — real version history, no database to be locked out of, and nothing to export because there was never anything to import.

Free, all of it, no tiers. The expensive part of a notes app is storage, and ForkLeaf has none.

Try it: forkleaf.vercel.app

What's in it

Writing — Three editing modes per note: Notion-style rich text, split source/preview, and raw Markdown. Slash commands, a command palette (⌘K), and a properties panel that edits the note's YAML frontmatter directly, so notes stay compatible with Obsidian, Jekyll and Hugo. Pasted code is recognised and fenced with the language it appears to be in.

Links — [[Wikilinks]] in the Obsidian dialect, resolved by path, filename or title. Backlinks that quote the line they were written on, so you see what was said about a note rather than only that something was.

Search — Full text across every note, ranked with BM25, running in the browser against the notes already on your machine. No server, no index to rebuild, works offline.

Diagrams — A Mermaid studio with three ways in: pick a diagram type and start drawing, drag shapes onto a canvas and let the source be written for you, or write Mermaid with autocomplete and errors explained in plain language. 14 templates; six types drawable rather than typed. Stored as ordinary ```mermaid blocks, so they render on github.com too.

Sync — Local-first: edits land in IndexedDB immediately and push in the background. Rapid edits coalesce into one commit instead of a thousand autosaves. Offline-safe queue, conflict prompts rather than silent overwrites, branch switching from the status bar, and notes that refresh themselves when someone else commits.

History and review — Every version of every note, read from the repository's own commit log and shown with a diff. No separate "version history" feature, because git already is one. Propose changes as a pull request against a repository you cannot push to.

Publishing — Render a note to one self-contained page, commit it to docs/, and switch on GitHub Pages. A published note keeps working if ForkLeaf goes away.

Exporting — PDF, Word, HTML, Markdown, plain text and JSON, rendered in the browser. One note or the whole workspace.

Desktop — Installs as an app and registers as a Markdown editor. xdg-open note.md opens it, and ⌘S writes back to the file it came from rather than a copy in Downloads.

Getting started

Sign in with GitHub, pick a repository (or let ForkLeaf make one), and start writing. Or run it locally:

git clone https://github.com/praneeth132006/ForkLeaf.git
cd ForkLeaf
pnpm install
pnpm dev

The full feature list is in the README; the changelog is in CHANGELOG.md.

Known limits

  • No real-time multiplayer editing.
  • Editing files on your own machine uses the File System Access API, which today means a Chromium-based browser. Everything else works everywhere.

Apache 2.0. Issues and pull requests welcome.

Assets 2
Loading