📊 Full opportunity report: Disk Is the Contract: Inside Threlmark’s Local-First Architecture on ThorstenMeyerAI.com — validation score, market gap, and execution plan.
TL;DR
Threlmark employs a unique local-first architecture where JSON files on disk serve as the definitive data source, eliminating the need for a server or database. This approach enhances portability, interoperability, and safety, with implications for future AI integration.
Threlmark has introduced a project management architecture where all data resides on disk as JSON files, with the files themselves serving as the definitive record. This approach eliminates the need for a server or database, emphasizing local control, portability, and interoperability. This approach eliminates the need for a server or database, emphasizing local control, portability, and interoperability. The system is designed to support AI integration and external tool participation without central infrastructure.
The core design choice is that the on-disk layout functions as the API, with a directory structure that includes a manifest, dependency graph, project metadata, and individual item files. Each project has its own folder containing metadata, lane orderings, and one file per roadmap card, making the entire system inspectable, portable, and restartable. This design enables external tools to read and write directly to the files, facilitating interoperability and avoiding lock-in.
Threlmark employs two key patterns to ensure data safety: atomic file writes, which prevent corruption during crashes, and read-merge-write updates that preserve unknown fields for forward compatibility. The system’s self-healing board reconciles actual files with lane orderings, automatically adjusting for missing or deleted items. This architecture supports multi-project hubs that are fully portable and can integrate with other tools or backups easily.
Disk is the contract: inside a local-first roadmap hub
A Next.js app on top of plain JSON files — no database, no cloud, no accounts. The key decision: the on-disk layout IS the API. Everything else cascades from taking that seriously.
There is no server-of-record — the files are the record
The UI and any external tool reach the same files through the same discipline. The data root defaults to ~/.threlmark — home-based, because it’s a shared hub every one of your apps points at.
Inspectable
Every artifact is a file you can cat, diff, grep, commit.
Portable · no lock-in
Back up with cp, sync with Dropbox / git, migrate trivially.
Interoperable
Any tool in any language joins by reading / writing files.
Restartable
No in-memory state to lose — stateless over the files.
TOPCJ Accordion File Organizer,Expanding File Folder Portable Filing Folders,13 Pockets File Box with Handle for Documents,Special Design for Carrying,A4/Letter Size,Colored Tabs
✔【HIGH CLASS】Advanced sealing all edges, Visable Window for quick classification, Perfect high class file folders organizer for Carrying…
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Two disciplined patterns instead of a database
“Just use files” is easy to get wrong. These two patterns — ported from a battle-tested sibling app — are what make file-based state sound rather than reckless.
Atomic writes
Write to a temp file in the same dir, then rename() over the target. Rename is atomic on one filesystem — a crash mid-write leaves the complete old file or the complete new one, never a half.
The board heals itself
A single roadmap.json array races when two tools write at once. One file per card makes writes collision-free. Lane order lives in board.json and reconciles on read.
board.json. It writes an item file — the board fixes itself on Threlmark’s next read. Unknown keys are preserved, so the contract is forward-compatible.![DeskFX Free Audio Effects & Audio Enhancer Software [PC Download]](https://m.media-amazon.com/images/I/41fXbDohyuS._SL500_.jpg)
DeskFX Free Audio Effects & Audio Enhancer Software [PC Download]
Transform audio playing via your speakers and headphones
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
The numbers can’t drift from the files
Anything computable from item state is computed — so the displayed numbers can never disagree with the underlying JSON. Priority is the clearest example: it’s calculated on read, never persisted.
priority — computed on read
Impact weighted heaviest; effort the only axis that subtracts. Reused verbatim from the original tool, so imported cards rank identically.
![Free Fling File Transfer Software for Windows [PC Download]](https://m.media-amazon.com/images/I/41Vq6ZqHfjL._SL500_.jpg)
Free Fling File Transfer Software for Windows [PC Download]
Intuitive interface of a conventional FTP client
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
A handoff is a first-class flow event
The genuinely 2026-shaped part: most building is done by AI agents, so Threlmark closes the loop. Watch a card go from ranked to Done without anyone dragging it.
Handoff → report → self-move
The brief carries a reporting protocol. The agent reports through REST or the filesystem — and a done report moves the card itself.
POST /api/projects/:id/
items/:itemId/reportDirect call. Applied immediately.
drop reports/.json
→ ingested on read Robust even if the server’s down at finish time.
eufy Security eufyCam S330 (eufyCam 3) 4-Cam Kit, Security Camera Outdoor Wireless, 4K with Integrated Solar Panel, Face Recognition AI, Expandable Local Storage, Spotlight, No Monthly Fee
Crystal-Clear Night Surveillance: Achieve superior night vision with the eufy 4k camera's Starlight system, delivering 4K quality and…
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
A small formula, and an honest hosting caveat
Because items are globally addressable (
Portfolio ranking — status-weighted
In-flight work floats to the top; bottlenecks cost the most, so blockers get nudged up.
Static read-only demo
Seeded data, writes to localStorage. Try-before-you-clone.
Personal Node instance
Password-gated, persistent backed-up THRELMARK_DATA_DIR.
Multi-tenant SaaS
Add accounts + per-tenant isolation. A separate build.
src/lib/*/store.ts is the natural seam — the same boundary that keeps the local tool simple is the one you’d extend for multi-tenancy. The architecture doesn’t fight that future; it just doesn’t pay for it until you need it.
Why Disk-First Design Transforms Project Management
This approach matters because it shifts the paradigm from centralized, server-based systems to a decentralized, file-based model that enhances control, flexibility, and resilience. By making the data portable and inspectable, Threlmark reduces vendor lock-in and facilitates integration with external tools and AI agents. This architecture could influence future project management tools to prioritize local-first, serverless designs, especially as AI-driven automation becomes more prevalent.
The Evolution of Local-First and JSON-Based Systems
Traditional project management tools rely on centralized servers or cloud services, often leading to fragmentation and lock-in. Building on the local-first movement, Threlmark extends it by making the disk layout the actual API. Threlmark builds on the local-first movement, which emphasizes storing data on user devices, but extends it by making the disk layout the actual API. This design draws from previous work on JSON-based apps that prioritize portability and safety through atomic writes and tolerant merging, now applied at a broader system level for multi-project hubs. The concept aligns with ongoing trends toward decentralized data ownership and AI integration in productivity tools.
“The on-disk layout is the API. Files are the record, and that simplicity cascades into everything else — concurrency, external participation, and AI automation.”
— Thorsten Meyer, Threlmark developer
Unanswered Questions About Scalability and External Integration
It remains unclear how well this architecture scales for very large projects or teams, or how it performs under high concurrency. Additionally, while the system is designed to be interoperable with external tools, the specifics of integration with existing project management platforms or AI agents are still being developed. Further testing and real-world use will clarify these aspects.
Next Steps for Adoption and Development
Threlmark plans to release more detailed documentation and tooling to facilitate broader adoption. Future developments may include enhanced AI automation capabilities, improved multi-user support, and integrations with popular project management ecosystems. Watch for updates as the system matures and gains real-world usage.
Key Questions
How does Threlmark ensure data safety without a database?
Threlmark uses atomic file writes, where data is written to a temporary file and then renamed, preventing corruption during crashes. It also employs read-merge-write updates that preserve unknown fields, ensuring forward compatibility and data integrity.
Can external tools modify Threlmark data?
Yes, since the data is stored as JSON files in a structured directory, any tool that can read and write JSON can participate, enabling interoperability and external participation without special permissions.
What are the advantages of a disk-based contract over traditional databases?
Advantages include inspectability, portability, lock-in resistance, and restartability. Users can back up, migrate, or modify data directly through the filesystem, reducing reliance on centralized servers.
Will this architecture support multi-user collaboration?
Currently, the design is optimized for single-user or local-first workflows. Multi-user support and real-time collaboration are areas for future development, but details are still emerging.
How does this approach impact AI automation in project management?
The architecture facilitates AI agents to read and modify project data directly, enabling automated workflows like closing loops on tasks or updating roadmaps without intermediary servers.
Source: ThorstenMeyerAI.com
