Back to browse
GitHub Repository

🌿 A file-based headless document build tool

4 starsTypeScript

Simpesys – A headless document build tool for digital gardens

by parksb·Mar 17, 2026·3 points·0 comments

AI Analysis

●●SolidNiche GemBig Brain

Headless docs separation when Quartz and Obsidian bundle everything together.

Strengths
  • Clean three-layer architecture separates core, app, and user space cleanly.
  • LSP support means NeoVim and other editors work without plugins.
  • Deno-based with JSR distribution for modern TypeScript workflows.
Weaknesses
  • Only 3 GitHub stars and 0 forks signals very early adoption stage.
  • Digital garden tooling is crowded with established alternatives.
Target Audience

Digital garden enthusiasts, technical writers who want editor flexibility

Similar To

Quartz · Obsidian Publish · Docusaurus

Post Description

I built a file-based headless document build tool called Simpesys. I've been running my own digital garden for a long time. I'm into topics like digital gardens, knowledge bases, second brains, Zettelkasten, so I've tried many different tools over the years, but eventually decided that Markdown files on the local filesystem are the most sustainable way to do it.

These days there are plenty of file-based digital garden tools. But many of them treat the document system and the UI as one bundle, which always bothered me. I mostly write in NeoVim, so I wanted the document system itself, the editing environment, and the application (usually a static site) to be separate things. I didn't need an all-in-one. I needed a system where I could fine-tune the rules programmatically, and since sharing my digital garden with others matters too, the application UI had to be customizable as well. So I created Simpesys.

Simpesys focuses only on the document system, things like hierarchy and cross-references between documents, and keeps the user interface as a completely separate layer. The document system is the trickiest part of building a digital garden, and Simpesys provides that as a headless tool. The UI is handled through a plugin system, so users can customize it however they want. The users could even use another tool's UI on top of Simpesys if they wanted. (Respecting the original authors and their licenses, of course.)

It's not perfect yet, but I hope it inspires anyone with similar needs. As the first user of Simpesys, I keep improving it.

Simpesys's homepage is itself built with Simpesys: https://pedia.simpesys.deno.net/

Similar Projects

AI/ML●●Solid

GAAI – One agent plans, one codes. A Markdown folder governs both

Discovery plans, Delivery executes — separation of concerns baked into folder structure.

Big BrainBold Bet
Fr-e-d
113mo ago