Use Fablewright #
Fablewright is a place to write a novel. Your words live on a server that you, or someone you trust, controls. This is your instance. The editor saves as you type. Download a project archive to keep a copy outside the instance.
This guide is for writers using an existing instance. The same guide appears at /help. Press ? in the workspace for keyboard shortcuts.
For setup, use the installation guide. The operations guide covers server backups and account recovery.
Start #
Create an account with an email address and a password. On a new instance, the first person to create an account becomes the admin, and sign-up closes. The admin can open sign-up again for other people.
- Open the address of the instance.
- Create an account, or sign in with the one that someone made for you.
- The library opens. Choose New project and give it a name.
The first account also gets an example project with books, chapters, scenes, front matter, notes and a plot grid. Read it, or delete it. Any writer can add a fresh copy from Your account.
Write a first scene #
- Open the project you just created, or choose New project in the library to create one.
- Select its scene in the manuscript tree on the left.
- Type a short paragraph in the center editor.
- Wait for the status bar to report that the words are saved.
- Open Scene to add a summary, status, or viewpoint.
- Open Notes to create a reference note beside the prose.
- Use the project menu to open Read-through or Export.
The title of a scene is separate from its prose. Rename the scene through its tree row rather than typing its name into the paragraph. Save a scene version before trying a large revision.
Your account #
Open Your account from the header to change your name, password, passkeys, or reading preferences, or to sign out other sessions. You can also add a fresh example project or delete your account here. To change your display name, edit Name and choose Save the name.
Choose Change the password, enter the current one, and enter the new password twice. The new password ends every other session on the account.
The session list shows when and where you signed in. Choose Sign out everywhere else to end every session except the one you are using. Sign out in the header ends this session.
Passkeys #
A passkey signs you in with the fingerprint, face, or screen lock on a device. On Your account, choose Add a passkey and give it a label. Keep your password as a fallback if you lose the device or remove the passkey.
A passkey belongs to one address. If the instance answers on more than one domain, add passkeys at the address the admin names, and use the password on the others. The browser will only create a passkey over HTTPS or on localhost.
To add a passkey, you must have signed in within the last day. If the page asks you to sign out and back in, do that first.
Moving an instance to a new domain leaves its passkeys bound to the old one. Remove each passkey at the new address and add a replacement.
The example project #
The example uses the public-domain novel The Wonderful Wizard of Oz, with notes, storylines and a plot grid. Delete it from your library whenever you like. To start over with a fresh copy, add it again on Your account.
Leaving #
On Your account, Delete this account is immediate and cannot be undone. It removes the account, its sessions and its passkeys. It also removes every project only that account could open, with every word in them.
Before deleting your account, transfer any project you own that has a co-author. Choose which co-author becomes the owner. The manuscript stays as it is. If a project you own has readers but no co-author, delete the project or add a co-author before continuing.
The only account on an instance cannot delete itself from the web. With no accounts left, anyone who opens the instance can claim it. The page explains how to erase the instance instead. An operator can also delete the account from the command line.
If you are the last admin who can sign in, appoint another admin before deleting your account. Export projects you need first. Deletion does not remove copies already held in backups, downloaded archives, or someone else's files.
The library #
The library lists the projects you can open. Each card shows the books, the scenes and the word count. A coloured square beside the title is the project's card colour, so you can tell one draft from another at a glance.
- Choose a card to open its workspace.
- Details, in the card menu, changes the title, the subtitle, the author, the description and the card colour. Word and EPUB exports use this author name.
- Export, in the card menu, downloads the project in one of its three formats.
- Delete, in the card menu, moves the project to the Deleted projects list in the library, where you can bring it back.
- Delete forever, in that list, removes a trashed project, its notes and its history. Export the project first if you might want a copy.
The subtitle and description appear under the title. Changing them does not change the manuscript.
The project menu at the top of the workspace opens Write, Read-through, Feedback, Sharing, the plot grid, Recovery and Export.
An invitation to someone else's project also appears in the library. Accepting adds the project to the list. Declining grants no access.
Sharing and feedback #
Open Sharing from the project menu or a library card. Only the project owner manages access. A secret link can cover the whole project or one book, chapter, or scene. Account invitations always cover the whole project.
Invite a reader or co-author #
Enter the email address of an existing account and choose Reader or Co-author. The invitation appears in the recipient's library and expires after 30 days. Accepting adds the project to that library. Declining grants no access.
A Reader can read the manuscript, use the outline, and leave feedback. A reader cannot open the editing workspace. A Co-author can also write, plan, export and use recovery. A co-author cannot manage sharing or delete the project. The owner can change a member's role or remove access at any time.
The invitation grants no access until accepted. The app does not send invitation email. Ask the recipient to look in their library. An instance admin does not automatically have access to every project.
Secret links #
A secret link lets someone without an account read the project or one part of it, comment, or edit scene prose. Choose what the link opens, a permission, and an expiry date, and add a label if you want one. A book link includes its front and back matter. A chapter link includes every scene in that chapter. A scene link includes only that scene. The scope is fixed when you create the link. Copy the link when it appears. You cannot retrieve it later, so create another link if you lose the original.
Choose one of these permissions:
- Read only lets the guest read the part the link names.
- Read and comment also lets them leave feedback and suggested replacement text on that part.
- Edit manuscript and comment also lets them change scene prose in that part through the editor.
Links expire after 1, 7, 30 or 90 days. Revoking a link blocks further requests, including pending editor saves. It does not erase prose that a guest already downloaded or has on screen. Give each editor a separate link if you need to remove their access individually.
A guest needs no account. The link grants access to anyone who holds it, and guest names are not verified. Secret links expose the live prose in the part the link names. They do not expose notes, planning fields, deleted work, project archives, or recovery history. They cannot change structure or membership.
Use HTTPS when you share outside a local machine, and ask the operator to keep query strings for /s/ requests out of the proxy and access logs. The first request carries the secret in its address.
Feedback #
Open Feedback from the project menu. Owners and co-authors have Responses and Reading tabs. Readers go straight to Reading and do not see the response queue.
Responses lists scene and chapter feedback in manuscript order. Choose Open to see only what is unresolved, or All to include what is resolved. Open scene opens a scene in the workspace. Resolve takes the response out of the open list. Delete removes it.
Reading shows comments beside the manuscript. Use its scene index to jump to a scene, or read straight through.
A reader can select words and choose Comment on passage. Scene feedback and Chapter feedback collect responses about the whole section instead. A chapter link permits Chapter feedback. A scene link does not. A suggested replacement stays in feedback. It does not change the manuscript. The writer applies it by hand.
Owners and co-authors can resolve or delete feedback. Readers cannot moderate it. A project holds up to 10,000 feedback items. Delete old items if the project reaches that limit.
Feedback records which version of the scene the reader saw. It tells you if the scene changes or the quoted text disappears. The original quote stays with the feedback, but it does not follow the text through edits.
The manuscript #
A project holds one or more books. A book can hold parts, then chapters, then scenes. You write in scenes.
The manuscript tree on the left shows how your project is arranged. Each row shows a word count, including the words in everything beneath it. Drag a row to move it, or press Alt with the up and down arrows.
Press F2 to rename the focused row, Insert to add a child, and Delete to request removal. Deletion asks for confirmation. A chapter keeps at least one scene, and a project keeps at least one book. A book can be empty until you add a chapter.
Press Shift + F10 to open the focused row's actions. Move up and Move down work without dragging. Press M, or choose Move to, to move an item under another valid parent. On a touch screen, use the visible actions button beside the row.
Use the add row at the bottom of the tree for a new book. A book or part also has add controls for its children. Use a chapter's add control for a new scene.
Front and back matter #
Each book also has Front matter and Back matter groups. These hold unnumbered pages before and after the story. Choose Add page in either group, select a page type, and enter its name.
Front matter offers Title page, Copyright, Dedication, Epigraph, Foreword, and Preface. Back matter offers Acknowledgments, About the author, Afterword, Appendix, and Also by the author. You can also name a custom page. Every page opens directly in the prose editor.
Page text uses the same autosave and versions as scenes. Use the row actions to rename, reorder, or delete a page. Move to front matter and Move to back matter also move an existing chapter without changing its words. Make chapter returns a page to the main manuscript. Deleted pages remain in Recovery.
A project opens in the story, not on a front matter page, unless that page was the last one you had open. Reading, printing, Word and EPUB keep front matter before the chapters and back matter after them. Project archives keep the page text, placement and history. Their Markdown files use front-matter and back-matter folders.
Writing #
The writing workspace opens a five-step tutorial the first time you use it. Your account remembers that visit across projects and browsers. The tutorial introduces scenes, formatting, autosave, notes and focus mode. Typing and clicking outside the tutorial do not close it. Choose Skip tour to leave it.
To replay it, open Keyboard shortcuts and choose Writing tutorial. On a phone, Keyboard shortcuts is in Page actions. You can replay the tutorial in any project.
Find your way around #
The manuscript tree sits on the left, prose in the center, and reference panels on the right. Scene holds planning fields. Notes, Versions, Search, and Progress open their own panels. Grid opens a compact plot surface beside the draft. The project menu also opens the full plot grid.
On a wide screen, click a panel's dock button to bring it forward. Shift-click keeps another panel beside it. Choose Bring forward on a panel behind the others to bring it to the front. On a smaller screen, only one panel shows over the prose. Close it to return to writing.
On a phone, open the manuscript drawer to choose a scene. Header controls move into the Actions menu. You do not need a mouse or a drag gesture to move manuscript items.
A scene opens in the middle of the workspace. Type two asterisks around a word to make it bold, or one to make it italic. Type a heading mark at the start of a line to make a heading. Select words to open a formatting bar for bold, italic, underline, strikethrough, inline code, and links. The bar also sets a heading, quote, or list for the selected blocks. Body text removes a heading, quote, or list but keeps the text formatting. Clear formatting removes all text and block formatting. If a link address has no scheme, the editor adds https://.
The editor saves as you type. Press Ctrl + S to save immediately.
The footer under the prose shows whether your words are saved. Unsaved words carry heat. Saved text stays ink while you type. A word starts hot, turns warm when the save is sent, and cools to ink when the server confirms it. If a save fails, unsaved words turn the failure colour and stay on screen.
When a save fails #
The footer says what happened and offers the next action. Retrying does not discard your unsaved words. Download words saves a text copy without rich formatting or project history. If the server cannot save, download your words before troubleshooting.
If the instance is unreachable, leave the tab open and try again when the connection returns. The browser keeps the words between saves. Do not close the tab or switch to editing the scene in another tab while it still holds unsaved words.
The local backup buffer #
When browser storage is available, the editor keeps a local copy between saves. After a closed or crashed tab, reopening the scene can offer that draft back. Read the prompt before restoring or discarding it.
Restoring a draft waits for any save already in progress. If Fablewright cannot preserve your current unsaved words, it leaves them on screen. Download them or save them before you try again.
The buffer is a safety net for the open scene, not a project backup. It stays in that browser profile at that instance address. It does not follow you to another device. Blocked storage, cleared site data, private browsing, or a device failure can remove it.
Fablewright needs a connection to save and does not support offline drafting. Keep a failed-save tab open. Do not clear its storage or sign out before downloading the unsaved words.
Two tabs #
If two tabs load the same scene, the first save advances its revision. The other tab's stale save is refused. This also applies to two writers editing the same scene.
Keep my version replaces the server copy with your words. Use saved version adopts the server copy. Download mine keeps a text file without resolving the conflict. Download first if you need to combine both versions by hand. Fablewright does not automatically merge them.
Focus mode #
Choose Focus in the header to give the scene the whole window. The workspace controls fold into a rail along the edge. You can still move to the next scene with the keyboard. Press Esc to leave.
Reading and the outline #
Choose Read-through from the project menu. The Read tab shows the project, one book, or one chapter as continuous prose, without opening an editor. Print it, or use your browser's print command to save a PDF.
The Outline tab lists every chapter and scene with its word count, summary and status. Edit the summary from the outline or the scene panel. A summary is planning text and does not change the prose.
In the editor you can split a scene at the caret, or merge the following scene into the one you have open. Both actions keep a project version and a scene version, and both ask the open editor to save first.
Notes #
Choose Notes in the dock. Notes hold the planning behind the prose: characters, places, objects, and your own types. A note type carries a name, a plural, a colour and a template. Manage note types from the Notes panel. Choose Types, then New type, and set the name, plural and colour.
A template is a starting form. A new note begins with the template body. You can apply the template later, but only to a note that has no text, because applying it replaces the body.
Changing a note's type does not apply that type's template. Deleting a type leaves its notes Unfiled and keeps their words, but permanently removes the type and template. Templates do not have version history.
A note can hold one image, with a description for readers who cannot see it. PNG, JPEG, WebP, AVIF, and GIF work, up to 10 MB. The display copy fits within 1600 pixels and uses WebP. Large pixel dimensions can also cause a refusal.
The admin decides whether new uploads can preserve full-size originals. If that control is available, clear Keep the full-size original when you do not need it. Replacing a picture does not preserve the previous picture in note history.
Use the scene panel to link a note to the scene it belongs to. The note then lists that scene, and the scene lists the note.
The plot grid #
Open the plot grid from the project menu. It puts storylines in rows. The columns are chapters or scenes.
Each cell holds a card. A card carries what happens and why it matters, and it can link a note. Choose a card to open the scene it belongs to. A chapter card opens the chapter's first scene.
Drag a storyline row to reorder it, or press Alt with the arrow keys on a focused row.
On a phone the grid turns sideways: scenes run down the page under their chapter, and storylines run across as columns that scroll sideways.
Search #
Choose Search in the dock to search every scene and note in the project. The scene and note tabs each show a result count. Each excerpt highlights the matching text.
Ctrl + F finds a word in the open scene. Ctrl + H opens find and replace. You can undo a replace-all in one step.
Versions and recovery #
Ctrl + Shift + S saves a version of the scene. Choose Versions in the dock to see earlier versions, compare changes, or restore one.
A version records the server's copy, so the app saves your latest edits first. If the save fails, no version is created. A message explains why.
Open Recovery from the project menu or a library card. It holds the rest:
- Deleted books, parts, chapters, scenes, notes, plot cards and storylines.
- Earlier versions of a note or a plot card.
- Project versions. A project version opens as a separate copy, so trying an older arrangement never touches the project you are writing in.
A project archive includes this history along with the manuscript. Word and EPUB exports do not. The recovery guide walks through each restore.
Recovery uses the same database as the draft. It is not a backup outside the server, and it cannot survive the loss of the disk. An operator backup covers that.
Automatic history uses a 365-day window by default. Scene versions you save yourself, and project versions you save by hand, do not expire automatically. A guest's edits appear in Versions and expire like automatic versions. Each item also keeps a minimum of its newest versions, regardless of age. An admin can change the window or keep all history. An operator can explicitly remove protected versions, so keep an external copy of important work.
Goals #
A goal is a daily word target for one writer in one project. It is optional, and a project without a target has no goal to miss.
Choose the days you do not write, and turn on the streak if you want one. The status bar counts the words you added today against the target. Choose Progress in the dock for the last two weeks and the settings.
A goal can also carry a deadline: a number of words to add by a date. The count starts on the day you set the deadline. The panel shows the words added against the target, how many writing days are left, and the pace a writing day needs. Editing the target or the date keeps the count, so an adjustment does not throw away progress. Clear the deadline and set a new one to start again. A deadline does not change your daily target.
A day counts words added in the scene editor, using your local date. Deleting words does not reduce that day's total. Notes, imports, a co-author's words and guest edits do not count toward your goal.
The count increases when a save adds to the scene's word count. It does not count keystrokes. Replacing a paragraph with one of the same word count adds nothing. Writing front and back matter can count too. Goals and daily counts belong to your account and are not included in project archives.
Proofreading #
The spelling and grammar check is off until you turn it on from the status bar. It runs in your browser and sends no manuscript to another service. First use downloads about 20 MB from the instance. A browser can cache it, but clearing that cache requires another download.
Choose the dialect you write in: American, British, Australian, Canadian or Indian English. Words the check flags can be fixed, ignored, or added to your own dictionary. Comments about style and readability are left out on purpose.
Press F7 to fix an underlined word. Press the check control again to turn proofreading off. While it is on, the browser's own spellcheck is off, so two checkers do not draw under the same word.
Listening to a scene #
Read aloud uses your browser's speech engine. It reads the open scene from the top, including unsaved words, and stops at the end. It does not read the scene title, synopsis or notes. Changing scenes, splitting or merging a scene, restoring a scene version, or leaving the workspace stops playback.
- Open a scene in the writing workspace.
- Press Listen in the status bar.
- Press Pause to pause, Resume to continue, or Stop to stop.
- Press Voice to choose a voice or speed and move between sentences.
The voice and speed stay in this browser when browser storage is available. They are not account settings. Fablewright prefers an on-device voice that matches the page language. If the browser reports no matching on-device voice, the first use asks before it uses an online voice. Choosing an online voice in the picker also gives consent. An online voice can send the scene to the browser's speech service. If your browser cannot speak, the control does not appear.
Appearance #
Safe Mode is the light theme. Use the theme switch to change between dark and light. Fablewright remembers your choice. Until you choose, it follows your operating system's preference.
The heat is the save state. Unsaved words are hot when you type them, warm once sent, and ink when the server has them. To keep the prose quiet, choose Reduced heat on Your account. The prose stays ink and the save state moves to the status mark. Follow this device uses reduced heat when the device asks for less motion. The choice is saved with your account, so it follows you to another browser.
The body font is the face for prose, notes and fields. It is Literata by default. On Your account you can change it to Lexend, a face designed for reading proficiency. Some dyslexic readers find its wider spacing and simpler letterforms easier. The choice is saved with your account, so it follows you to another browser. Headings, labels and readouts keep their own faces.
Export #
Open Export from a library card, or Export project from the project menu. You need write access to export. Choose one of three formats. Word, EPUB, and print can cover the whole project or one book, chapter, or scene. The project archive always covers every live book in the project.
- Word: a submission manuscript. Times New Roman at 12 point, double spaced, one inch margins, a page break per chapter and a running header. The header prints the author from Details, then the title, then the page number. Leave the author empty and it prints
Author. - EPUB: a book with a table of contents, for reading on a device. Reading apps can use the author and description to list the book in your library.
- Project archive: a zip that holds
manuscript.jsonand the manuscript as Markdown, one file per scene. The JSON is the complete, lossless copy of the structure and the history. The Markdown is for reading, git, and other tools.
To export one part, open Read-through and choose a book, chapter, or scene. The Export control there offers Word and EPUB for that scope. Print saves the same scope as a PDF.
The archive format is 1. It keeps front and back matter placement, and a newer format is refused by name.
Import #
Choose Import on the library page. You can import a Scrivener project, a Fablewright archive, a standalone manuscript.json, a Word document, Markdown, or plain text. Scrivener, Word, Markdown, and plain text show proposed structure and conversion warnings before you approve the import. A Fablewright archive or standalone manuscript imports directly.
An import always makes a new project. It never merges into one you already have. The instance keeps your original file and writes a report of what was imported and what was left out. You can download both from the library card.
A Word file loses formatting that Fablewright cannot represent. Lists become plain paragraphs, and table text becomes paragraphs without cell layout. Images, footnotes, and comments are omitted. Tracked insertions are kept and deletions dropped, without their revision history. Read the preview warnings before accepting.
A standalone manuscript file carries no pictures. Import the .zip archive instead when the notes have images. The import limit is 100 MB. If an archive is larger, keep it and ask the operator for a database backup.
For Scrivener, choose Choose a Scrivener folder and select the complete .scriv folder. You can also upload a ZIP of that folder. A .scrivx file alone does not contain the prose. The browser packages a selected folder as a ZIP before upload. Fablewright keeps that ZIP for download. Research and extra metadata become notes. Deep nesting, page layout, compilation features, and some attachments do not have exact equivalents. Read the preview and report before relying on the imported copy.
Word Heading 1 starts a chapter and Heading 2 starts a scene. Markdown uses one heading mark for chapters and two for scenes. Plain text follows the same rules as Markdown. If opening text becomes a chapter named Front matter, it still needs to be moved into the book's Front matter group.
An import can succeed even if the response or source-file storage fails. Refresh the library before retrying after an uncertain result. Keep your original file until you inspect the imported words. The import and export guide has preparation examples and format limits.
Keyboard #
Press ? for the list of shortcuts, including the manuscript tree, the panels, and the scene keys.
Ctrl+Ssaves the scene at once.Ctrl+Shift+Ssaves a scene version.Ctrl+Ffinds a word in the open scene.Ctrl+Hopens find and replace.Escleaves focus mode, closes a panel, or dismisses the current action.F2renames the focused manuscript row.Insertadds a child to the focused row.Deleteremoves the focused row after a confirmation.Altwith an arrow key moves the focused manuscript row or storyline.F7fixes an underlined proofreading mark.Shift+F10opens the actions menu for the focused manuscript row.Mopens Move to for the focused manuscript row.
When something goes wrong #
- A save fails. Keep the tab open. The footer offers Download words, and the save retries with the same words. If the instance is unreachable, try again when it returns.
- Two tabs hold the same scene. If one tab saves first, the other must resolve a conflict before saving. The app offers both copies so you can choose which to keep.
- The proofreader does not load. Press the check control again to retry. It needs one download from the instance, and the browser must allow WebAssembly.
- A passkey is not offered. The browser needs HTTPS or localhost, and the passkey must be used at the address where you created it. After a domain change, remove it and add a new one.
- You forgot your password. Use the link on the sign-in page. If mail is off, ask the admin to set a password on Instance → Accounts.
- A secret link expired. Ask the owner for a new link. A revoked link cannot be restored.
- An import is refused. Make sure that the file type is supported and the file is within the 100 MB limit. A damaged zip or a newer archive format is refused by name.
- An upgrade left the instance down. The operator restores the backup taken before the upgrade. The operations guide covers the steps.
What is not here yet #
- Offline drafting.
- Real-time co-editing.
- Email delivery of invitations or secret links. The app shows a link for you to send.
- A hosted service. Every instance is one you or someone you trust runs.
- A mobile app. The web app works on a phone.
- Generative AI. This is a commitment, not a gap.