Files Service

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 Files-backed projects when a team needs shared durable storage, live multi-user authoring, revision history, and immutable deployment snapshots for Spiff Arena.

What Changes

  • Project files are stored by the Files service instead of only in the browser or local directory.

  • Multiple authors can work in the same project with live presence and autosave.

  • Every file update creates a revision.

  • Deployment to Spiff Arena uses immutable project snapshots, so production instances are not affected by later draft edits.

What Does Not Change

  • 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

Files support is disabled by default. Set filesUrl in Ed configuration only for workspaces that should use the Files service:

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

The development service also accepts local URLs such as:

config = {
    "filesUrl": "http://127.0.0.1:8374",
}

Deployment Model

Spiff Arena should deploy a Files 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 Files snapshot identifier used to create it.