The library

The library is Oleafly’s home screen. Every project appears as a book on a shelf, sorted by most recently modified, and everything you need to manage projects happens here.

The shelf

Each project is a colored book with a spine and page edges, showing the project name and when it was last updated. Hovering a book tilts it in 3D; the ink color adjusts automatically so names stay readable on any cover color.

The grid adapts to your window: two, three, or four columns.

First time in the app? You’ll see a welcome card instead: “Create your first project” opens the template gallery.

Creating a project

Click New project in the header. The template gallery opens with 19 starting points across categories like Resume, Journals, Diagrams, Theses & Reports, and Presentations. Pick one, name the project, choose a cover color, and you’re writing. The gallery is covered in detail on the Templates page.

You can also open the gallery from anywhere with the search omnibar: press ⌘⇧F (Ctrl+Shift+F) and type /create.

Hover previews

Hover a book and the first page of its last compiled PDF slides across the cover, so you can tell your papers apart at a glance. Previews come from the real compiled output and are cached, so the shelf stays fast.

If you’d rather not see them, turn off Preview PDF on hover in Settings, Appearance.

Bookmarks

Hover a book and click its star to bookmark the project. The bookmark toggle in the header (Show bookmarked only / Show all projects) filters the shelf down to your starred set, which is handy once the shelf grows past a dozen projects.

The right-click menu

Right-click any book:

• Open project
• Change book color: eleven cover swatches (Blue, Cream, Peach, Rose, Pink, Lilac, Sky, Aqua, Cyan, Mint, Spring). The color is stored in the project itself, so it travels with the project if you sync it to another machine.
• Fork project: copies the project and its full Git history into a new project. The dialog suggests <name> (copy); give it any name you like. Forking is the fastest way to start “version 2” of a resume or to experiment on a paper without touching the original.
• Delete project: removes the whole project folder from disk after a confirmation. This cannot be undone, so if the project matters, push it to GitHub first.

Renaming a project

Open the project and click its title in the top toolbar. It becomes editable in place: type the new name and press Enter. The rename is saved to the project’s own metadata.

Search from the library

The header’s search icon (or ⌘⇧F / Ctrl+Shift+F anywhere) opens the search omnibar. It searches project metadata as well as the full text of every document in every project, jumping straight to the matching project, file, and line. Type / for scoped commands such as /projects, /docs, or /create.

Plain text matches any indexed project metadata. For a precise search, use a field:value filter:

Filter	Example	Matches
project_id:	project_id:abc123	Project ID
name:	name:resume	Project name
engine:	engine:typst	Tectonic, Typst, or Markdown engine
kind:	kind:image	Document or image project
main:	main:resume.typ	Main document path
created:	created:2026-07-18	Creation date
modified:	modified:7/18/2026	Last-modified date
color:	color:#1982c4	Cover color
bookmark:	bookmark:yes	Bookmarked or unbookmarked projects
preview:	preview:no	Compiled PDF preview availability
export:	export:pdf	Export filename, format, path, or date

Dates can use the ISO YYYY-MM-DD format or the date format used by your computer. Boolean filters accept values such as yes, no, true, and false.

Combine filters by separating them with spaces:

engine:tectonic bookmark:yes preview:true

You can also mix filters with ordinary words:

name:resume typst

Also in the header

• Theme toggle: switch light and dark mode.
• Settings: the gear opens the full settings window.

Where the shelf lives on disk

Every book is a plain folder under ~/.openleaf/projects/, with a human-readable random name like flying-pink-pikachu. Nothing about the library is proprietary: see Where your data lives.