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 setWhat appears in My Drive
Storskarvia/My Novel/Chapter 1Storskarvia/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 beginsWhat it means
✓ saved toDrive holds your latest pushed text.
… saving toA 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 inA 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?

Start writing free