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 Publications:
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
Further questions, bug reports, ideas?