---
title: "Filestore — Visual Design Studio 0.1 documentation"
description: "files.spiff.works is an optional collaborative project backend for Ed. When it is not configured, Ed continues to work with browser storage, local project directories, and GitHub sync exactly as before."
source_url: https://spiff.works/docs/ed/filestore.html
---

☰ Menu

# Filestore[](#filestore "Link to this heading")

`files.spiff.works` is an optional collaborative project backend for Ed.
When it is not configured, Ed continues to work with browser storage, local project directories, and GitHub sync exactly as before.

Use Filestore-backed projects when a team needs shared durable storage, revision history, and immutable deployment snapshots for Spiff Arena.

## What Changes[](#what-changes "Link to this heading")

- Projects can be uploaded to and loaded from Filestore instead of only using the browser or a local directory.
- Uploading through Ed’s manual Sync action creates file revisions and an immutable snapshot.
- Deployment to Spiff Arena uses immutable project snapshots, so production instances are not affected by later draft edits.

## What Does Not Change[](#what-does-not-change "Link to this heading")

- Local Ed-only projects remain supported.
- Local disk projects remain supported.
- Existing GitHub sync remains supported.
- Spiff Arena can continue loading process models from its current filesystem or Git-backed configuration.

## Configuration[](#configuration "Link to this heading")

Filestore support is disabled by default.
Set `filesUrl` in Ed configuration only for workspaces that should use Filestore:

```
config = {
    "filesUrl": "https://files.spiff.works",
}
```

The development service also accepts local URLs such as:

```
config = {
    "filesUrl": "http://127.0.0.1:7007",
}
```

## Deployment Model[](#deployment-model "Link to this heading")

Spiff Arena should deploy a Filestore project snapshot rather than the live draft.
This keeps production stable while authors continue making changes in Ed.

Each deployed process instance should record the Filestore snapshot identifier used to create it.