Chapter 5 · Where Your Work Lives
Connecting Google Drive
Google Drive works much as Dropbox does, with one difference to understand before you start: Storskarvia can only ever see the files it created itself. This chapter covers the handoff, the folder layout, the status chip, and what to do when Drive stops saving.
Connecting it
Two doors, same destination:
- From your Account page, under Connected storage: click Connect Google Drive. Google asks you to approve, then sends you back to the Account page with Storage connected. ✓
- From inside the editor: open the storage dialog and choose Google Drive. If you have not connected yet, the dialog says Connect your Google Drive first: beside a Connect Google Drive button. After you approve, Google returns you to the same document.
Storskarvia asks Google for offline access, so it can refresh the connection quietly instead of sending you back through the approval screen every hour. The stored access is encrypted.
If the handoff fails, you land on the Account page reading That connection didn't complete. Please try again. Three things cause it:
- You lingered. The token carrying you through the handoff expires after ten minutes. Click Connect again and go straight through.
- A different Storskarvia account is signed in to this browser. The handoff is tied to the account that started it, so if someone else signed in meanwhile, it refuses. Sign back in as yourself and try again.
- You cancelled on Google's screen. Nothing was connected; start again when you are ready.
What Storskarvia can see
The connection uses Google's drive.file scope, which grants access to files the application created and to nothing else. Your existing documents, shared drives, and folders stay invisible to Storskarvia. No setting widens this, and Google enforces the boundary.
The consequence surprises people: Storskarvia cannot open a manuscript you already keep in Drive. Download it, then bring it in with the ⬆ Import button in a project, as Importing Final Draft, Fountain, and Text explains. Drive storage is for documents Storskarvia writes from then on.
Where your files land
The storage dialog's field is labelled Folder & file name (in your My
Drive), and it starts with a Storskarvia/ folder. The last part of the path
is the file name; everything before it is folders. Storskarvia creates any folder that does not
exist yet, so you can type a structure instead of building it in Drive first.
| Path you set | What appears in My Drive |
|---|---|
Storskarvia/My Novel/Chapter 1 | Storskarvia/My Novel/
containing Chapter 1.skarvia.json and Chapter 1.txt |
Chapter 1 (no folder) | The same two files inside
Storskarvia/ |
The .skarvia.json file is the full document Storskarvia reads back. The
.txt is plain text you can open in anything, now or in thirty years. An empty field
is refused with Give a folder path like Storskarvia/My Novel/Chapter 1.
Chapter files and versions
For a novel with at least two detected chapters, Storskarvia also keeps one plain-text file per
chapter, named like 01 - The Crossing.txt, in a folder called
<document> chapters beside the document. A document called
Chapter 1 gets Chapter 1 chapters. Rename or remove a chapter in your draft
and the matching file is deleted from Drive on the next sync, so no orphans pile up. Other project
types, and documents with zero retention on, get no chapter files.
The naming differs from Dropbox, which uses a .chapters suffix, so the folders will
not look identical if you use both.
When you use Save version…, Storskarvia also writes a copy into a
.versions folder beside the document, named with the title, the date and time, and
the version's name. Automatic checkpoints stay on Storskarvia. Chapter 7 covers
both.
Reading the status chip
Storskarvia pushes to Drive as you write, at most once every ten seconds for any one document.
Choosing a destination, restoring a version, and reconnecting push at once. The chip in the
editor's status bar tells you where the last push got to, always followed by
Google Drive › My Drive/ and your path:
| Chip begins | What it means |
|---|---|
✓ saved to | Drive holds your latest pushed text. |
… saving to | A push is queued or under way. |
✗ retrying: | The last push failed for a reason other than the connection. The next save tries again. |
✗ reconnect: | Google refused the connection. See below. |
⚠ name already taken in | A file is already at that path. See below. |
When the name is already taken
The first time a document writes to a path, Storskarvia checks that nothing is there:
neither the .skarvia.json, nor the .txt, nor the chapters folder. If
anything is, it writes nothing, leaves the existing file alone, and shows ⚠ name already
taken in. Click the chip, change the file name in the storage dialog, and save.
When Drive stops saving
When a push fails, a bar appears above the page: Google Drive stopped saving your work. Your recent changes are safe on Storskarvia, but they aren't reaching Google Drive until you reconnect. It offers two buttons:
- Reconnect Google Drive takes you through Google's approval and back to the document.
- Save somewhere else opens the storage dialog, if you would rather move the document to Dropbox or a folder on this computer.
Your Account page shows the same warning, ⚠ Google Drive stopped saving, with its own Reconnect Google Drive button. The usual cause is that access was revoked from your Google account, or Google stopped accepting the stored grant.
Reconnecting does more than restore the connection. Every document whose Drive sync had failed is pushed again at once, so work that never reached Drive catches up without you opening each document. Nothing is lost while the connection is down: Storskarvia still holds your working copy and still takes checkpoints, as Chapter 3 describes.
Disconnecting
On the Account page, click Disconnect Google Drive (or Disconnect, beside the reconnect button, when Drive has stopped saving).
- Storskarvia forgets the connection and stops writing to Drive at once.
- Every file already in your Drive stays where it is. Disconnecting never deletes your manuscripts.
- Documents that live in Drive switch to
✗ reconnect:at once, and open with the Google Drive stopped saving your work bar until you connect again or use Save somewhere else. Connecting again pushes them all.
Deleting your Storskarvia account leaves your Drive files untouched too. If you would prefer a single folder of Storskarvia's own, Chapter 4 covers Dropbox.
Updated 2026-10-13 · Full contents · Something wrong or missing?