Skip to content
praneeth132006 edited this page Oct 9, 2026 · 1 revision

FAQ

Short answers. The official FAQ has the longer versions.

Do I need an account?

No. The editor works immediately with notes stored in your browser. Connecting GitHub gives you a backup and sync across devices.

Where are my notes stored?

In two places: IndexedDB in your browser, and .md files in your GitHub repository. Nowhere else.

Is it really free?

Yes, permanently. Your notes live in your own GitHub account, so there is no storage cost to pass on.

Is it open source?

Yes, under the Apache 2.0 license.

Why does it ask for the repo scope?

repo is the narrowest classic GitHub OAuth scope that can write to a private repository. Nothing about your profile, email, organisations or gists is requested. If you only keep public notes, choose Public repositories only when signing in.

Can I use an existing repository?

Yes: any repository you can write to, on any branch, optionally limited to one folder.

Can I edit my notes outside ForkLeaf?

Yes. Edit them on github.com, in VS Code, in Obsidian, or from the command line. ForkLeaf picks up the changes on its next sync.

Will it flood my repository with commits?

No. Consecutive edits to a note are combined into one commit.

Does it work offline?

Fully. Writing, diagrams and exports all work without a network. Changes queue up and are pushed when you reconnect.

What if I edit the same note in two places?

ForkLeaf detects the conflict and asks which version to keep. It never silently merges.

Which diagrams are supported?

Flowcharts, sequence, class, state and ER diagrams, Gantt charts, mind maps, pie charts, user journeys, timelines, git graphs and quadrant charts.

Is there a mobile app?

Not a native one, but the web app works in a phone browser. The editor is designed desktop-first.

Can ForkLeaf read my notes?

No. There is no ForkLeaf database. Note content only passes through the API proxy on its way to GitHub.

How do I delete everything?

Delete the repository on GitHub, clear the site data in your browser, and revoke the ForkLeaf OAuth app in your GitHub settings.

Still stuck? Ask in Q&A or email support@forkleaf.in.