Spatial Knowledge Workspace
WeftWarp is a local-first visual workspace for organizing creative and technical projects. Featuring layered hierarchy for navigation, a canvas for spatial thinking, wiki links for cross-referencing, and a single file storage format for portability.
Core Philosophy
WeftWarp makes decisions so you don't have to defer them forever.
01
Every entity lives in a flat ECS store. Placing it on a page is a reference, not a copy. Edit once — every appearance updates everywhere.
02
Every page has a defined size — 8.5×11 by default. Constraints force the organizational decision that infinite canvas defers indefinitely. Pages export as a direct consequence.
03
Your workspace is a single .wwz file on your machine. No login, no subscription, no servers watching your notes. Works offline after load.
04
A character in three works, a decision in a spec and a journal — reference it everywhere. Nothing drifts out of sync because nothing was copied.
The Problem
| Tool | What it misses |
|---|---|
| Joplin | Good hierarchy, no spatial canvas. |
| Milanote | Good spatial canvas, poor hierarchy |
| Both | SaaS-adjacent or cloud-dependent fragility |
| Obsidian | Good wiki links, no user direction |
"A place where the same idea can appear in multiple contexts without duplication, where every named thing can be referenced from anywhere, and where the structure of your knowledge is as visible as the content itself."
What's in MVP
Binders contain Pages. Pages contain entities. Navigate the shape of your work in a thumbnail gallery before diving into a page.
Place content on a fixed-size page with precise spatial control. Pan and zoom. Hard clip at page boundary. Three default layers: Markup, Content, Background.
Text with inline entity refs, Jots, Checklists, Images. Markup tools: Rect, Arrow, Label. All drag-from-strip onto the canvas.
Type [[e:uuid]] to reference any entity anywhere. Hover for a live preview card. Backlinks panel shows everywhere it's been used.
Bounded pages export cleanly to image — cropped exactly to the page boundary. PDF export is on the post-MVP roadmap.
Save and load .wwz archives. Drag to open. Autosave every 30 seconds. Your workspace is a portable zip you control.
Technical Pedigree
Served once, runs indefinitely. No API, no backend, no database server. Like Photopea — pure browser compute.
Once the HTML, JS, and CSS are served to the browser, the server's job is finished. All computation happens in the browser. All state lives in the .wwz file on your machine.
Host on any static CDN. Self-host trivially. Run offline indefinitely after the first load. The only legitimate network activity post-load is optional file sync — a post-v1 feature.
Future paths: PWA/Service Worker, Tauri native desktop (.app / .exe / .deb), WebDAV sync. Same application code throughout.
Roadmap
MVP — ships first
Post-v1