The web home of Oleafly, the free, open-source, local-first LaTeX studio.
This repo is the website: the page you see at oleafly.com and the product docs at oleafly.com/docs. If you're looking for the app itself, that lives at Oleafly/Oleafly.
Built with Astro and Starlight. Everything is static. No server, no database, no third-party requests, and the only JavaScript that ships is for the animations.
You need Node 22+ and pnpm.
git clone https://github.com/Oleafly/oleafly-web.git
cd oleafly-web
pnpm install
pnpm devOpen http://localhost:4321 and you're looking at the site. Edits reload live.
The main page is one file: src/pages/index.astro. Markup, styles, and scripts are all in there, so if you want to change a section or its copy, that's the place.
The docs are markdown files in src/content/docs/docs/. One file per page. Fix a typo, save, done. If you add a new page, also add it to the sidebar in astro.config.mjs so people can find it.
A few other places you might touch:
src/components/holds the interactive pieces (the bento grid, the file tree, the confetti). Most are React with small CSS animations defined insrc/styles/magicui.css.public/media/has the screenshots and demo videos shared with the app's README.src/styles/theme.cssis the docs theme. The main page doesn't use it.
Typo fixes and small improvements: open a pull request directly, no need to ask first.
Bigger changes (new sections, layout changes, new pages): open an issue first so we can talk it through. The page is deliberately tight and we say no to most additions, not because they're bad ideas but because a short page that loads fast is one of our primary goals.
Run pnpm build before you push. If the build passes locally it will pass in CI.
Every push to main deploys automatically. A GitHub Action builds the site and uploads it to Cloudflare Pages, usually live within a minute. Pull requests don't deploy, so you can't break production with one.
www.oleafly.com and docs.oleafly.com both redirect to the main domain (docs.oleafly.com/faq lands on oleafly.com/docs/faq).
MIT. The Oleafly app itself is AGPL-3.0, but this website's code is free to reuse however you like.
