Ocelot πŸ†

Read-only Obsidian reader for public and private GitHub vaults

GitHub

Project goal

Read public and private Obsidian vaults from GitHub in a quiet, single-user web reader. Browse folders, follow wiki links and outlines, render math and diagrams, and apply new Git revisions explicitly while the source vault stays read-only. Production configuration is prepared; no deployed homepage is verified.

Tech stack

  • TypeScript / React / Vite β€” MVVM web reader and static frontend builds
  • Basalt 2.1.7 / Pierre Trees β€” Controls, application layout and virtualized vault navigation
  • react-markdown / unified β€” GFM, frontmatter, Obsidian links, callouts and sanitized HTML
  • KaTeX / Mermaid β€” Mathematical notation and diagrams
  • Cloudflare Workers / Access β€” Owner authentication and read-only GitHub requests
  • Cloudflare D1 / private R2 β€” Repository metadata and a rebuildable private cache
  • Vitest / Playwright / Biome β€” Runtime coverage, browser accessibility and static checks