Leaflet Manual

Leaflet is a tool for writing and publishing together!

Collaborative writing: make Leaflets, documents / posts / pages — even tiny websites — that are fast, flexible & fun

Social publishing: make Publications, like blogs or newsletters, that others can follow — built on Bluesky/atproto [new!]


You're reading a Leaflet doc now — they can be one page, or as many as you like, and are super easy to make & share.

🍃 try it with one click, no account needed:

📖 or, login via atproto to make a pub:



How Leaflet Works

Leaflet Basics

Using the block editor, navigating the app, etc.


Leaflet Basics

Using the block editor, navigating the app, etc.


Leaflet's core design principles

We want Leaflet to be:

fast: highly performant, with ~instant page loads

delightful: a writing experience that nails the basics, with fun touches layered on

expressive: low floor + high ceiling; flexible for a range of creative use cases

social: great for conversation and community

Getting Around

Block menu: hit "+" from an empty block, or type "/"

Editor toolbar: format text and find other block options from the bottom toolbar while editing

Nav / actions: in the sidebar (desktop) or footer (mobile)

Share: copy an edit link (to send collaborators) or view link (for anyone to read)

Theme: customize your color scheme and background image

About: useful links & shortcuts

Home: see all your docs and pubs — log in to sync across devices; otherwise saved in localstorage

Publications only items:

New Draft (from dashboard)

Making Docs

Quick shared docs, no account needed


Making Docs

Quick shared docs, no account needed


Delightful doc primer

Leaflet docs are quick to make

Make a doc at leaflet.pub/new — no account needed

If you sign in, we'll save your docs to your home, and sync seamlessly across devices

Make one page, or many

Docs start with a single page

You can add subpages, linear document or visual canvas, and open them side by side

Compose with blocks: text, images, lists, links, embeds…

Collaborative and easy to share

Multiple people can edit together; anyone with the edit link can add or change things

Share the view link for a read-only version

Advanced options

You may like to play with…

Custom themes: to make each Leaflet unique

Subpage options: theme each subpage separately, or share a link directly to any page! (see the menu in the upper right)

Custom domains: add a custom domain from the share menu — we'll give you DNS settings to add, and once your domain is confirmed you can link a leaflet to the root domain or a path

Making Publications

Social publishing for blogs, newsletters & more


Making Publications

Social publishing for blogs, newsletters & more


Publications are built on the AT Protocol, which powers Bluesky, to publish your data openly & enable things like comments, discovery, and (soon!) memberships across the open social graph.

We recently launched the first version…stay tuned for more!


How to get started:

Connect your Bluesky/atproto account from leaflet.pub/home

Make a new publication — you can make as many as you like

Make draft posts, and when you're ready, hit publish!

Your publication data lives on your PDS — same place your Bluesky data lives, open and under your control.

Other features:

custom domains — by default you can use a Leaflet subdomain…but you can also add a custom domain you own!

subscribing to publications — readers can subscribe and follow via custom Bluesky feed (or RSS); email coming soon

theming options — to give your pubs a unique look and feel

sharing quotes — via Bluesky or as embeds in other pubs

Coming soon:

email subscription — so anyone can follow a publication, even if they're not yet on atproto



Explore Examples

We're making Leaflet because we want delightful documents and playful, powerful publishing.

There are lots of ways to use Leaflet — from quick collections, to project notebooks, to wikis and syllabi…not to mention publications!

Here are a few favorites so far. We're excited to see yours ✨

Leaflet Docs:

Leaflet example library
Welcome to the Leaflet Library — a gallery of great documents as examples and inspiration.
https://leaflet.pub/bfed2569-f9c0-4c2a-a281-9f57bc372082

Leaflet Publications:

Leaflet Discover
Explore publications on Leaflet ✨ Or make your own!
https://leaflet.pub/discover


More about Leaflet

Read about what we're exploring & help us figure out what's next!

Share ideas & feedback

We'd love to hear more about how you'd like to use Leaflet! Directions we'd like to explore more include…

Expressive docs — new block types like audio, file uploads, or tables; options for things like fonts, export, and block actions

Share ideas & feedback

We'd love to hear more about how you'd like to use Leaflet! Directions we'd like to explore more include…

Expressive docs — new block types like audio, file uploads, or tables; options for things like fonts, export, and block actions

Social publishing — expressive ways to share and respond to docs and posts, in particular with publications

Specific to our new publishing features, built on atproto, there's a lot we'd like to add:

Subscription options, so readers can get updates via email, or perhaps directly via Bluesky / atproto

Social features, building on existing features like quotes and comments, to make Leaflet more useful for communities

Monetization, e.g. Substack or Patreon style memberships

Please send us a note if you have thoughts on what would make Leaflet more fun, more powerful, or better for whatever particular ways you're looking to use it!

Behind the scenes

Leaflet is a project from Hyperlink Academy, a school–software studio–research lab making tools for learning and collaboration.

We're a team of three based in Brooklyn, NY and we've been working on Leaflet since mid-2024.

Behind the scenes

Leaflet is a project from Hyperlink Academy, a school–software studio–research lab making tools for learning and collaboration.

We're a team of three based in Brooklyn, NY and we've been working on Leaflet since mid-2024.

We're exploring some fun directions for Leaflet; see the previous page for more detail!

For our NYC friends, we sometimes host writing sessions, bringing people together to draft & publish particular types of docs…like manifestos, recipes, or poems.

We share updates every couple weeks to our email list. You can also view our GitHub repo for WIP issues & known bugs.

If you have any questions or feedback please reach out :)

—Brendan, Jared, and Celine

Leaflet is currently in alpha — technically pretty stable, but evolving and experimental. Things you'd find useful? Let us know!

We'd particularly like to hear from writers, academics, publishers, community leaders, and others interested in longform social publishing on atproto.



Subscribe for Leaflet Updates

We usually send updates every week or two. Follow along to learn more & play with Leaflet as we build it:



Leaflet Longevity Statement

Leaflet is a new product and at this stage there's inherent uncertainty about it's long-term future. That said, we place a lot of importance on stability and peace of mind for the documents we create.

While we can't guarantee zero bugs or infinite lifespan, we can make the following commitment to you. If the hosted Leaflet app (leaflet.pub) shuts down in the future, we'll provide:

Leaflet Longevity Statement

Leaflet is a new product and at this stage there's inherent uncertainty about it's long-term future. That said, we place a lot of importance on stability and peace of mind for the documents we create.

While we can't guarantee zero bugs or infinite lifespan, we can make the following commitment to you. If the hosted Leaflet app (leaflet.pub) shuts down in the future, we'll provide:

at least six months notice before switching to read-only, and at least twelve months of hosting read-only documents

a way to download Leaflets (JSON file + attachments) that can be imported into a self-hosted version of the app (source here)

There's more we'd like to do, like additional export options, but this feels like a reasonable baseline! Please reach out with any questions.

Brendan, Jared, & Celine

~

update log

initial version posted 9.26.24

Terms of Service & Privacy Policy


Further questions, bug reports, ideas?