Working with the Editor
Writan uses TipTap as its prose editor — a rich text editor that supports formatting, inline annotations, and real-time editing.
Auto-Save
The editor auto-saves with a 500ms debounce. After you stop typing for half a second, your changes are persisted to the local database and queued for sync to Supabase. No manual save needed.
The Output Layer
When you write prose in the editor, you’re working on the output layer of a node. This is the text a reader will eventually encounter. Importantly, writing prose does not destroy the underlying data or generation layers — the beat notes, data blocks, and AI logs all persist alongside the finished text.
Selecting a Node to Edit
- Click any node in the document tree (centre panel)
- The editor loads that node’s prose content
- Write or edit as needed — changes save automatically
Craft Analysis
As you write, the writing rules engine analyses your prose in real-time. When a rule violation is detected (passive voice, adverb overuse, dead metaphors, etc.), an orange pip appears on the node. See Using Pips for how to respond to these.
Non-Destructive Editing
Writan’s fundamental principle: nothing is ever destroyed. The data layer and generation layer of a node survive independently of the output layer. When you write prose over a beat, the beat notes remain.