---
title: "Workspaces, Processes, and Files — Visual Design Studio 0.1 documentation"
description: "Ed organizes work into workspaces, processes, and files. Keeping those levels clear helps prevent accidental edits to the wrong model."
source_url: https://spiff.works/docs/ed/workspaces_files.html
---

☰ Menu

# Workspaces, Processes, and Files[](#workspaces-processes-and-files "Link to this heading")

Ed organizes work into workspaces, processes, and files.
Keeping those levels clear helps prevent accidental edits to the wrong model.

## Workspaces[](#workspaces "Link to this heading")

A workspace is the top-level container for related process models.
Use separate workspaces when projects have different repositories, audiences, or configuration needs.

Common workspace patterns include:

- One workspace for a product or client project.
- One workspace for shared examples.
- One configuration workspace for Ed sync configuration.

## Processes[](#processes "Link to this heading")

A process groups related files.
A process usually contains one primary BPMN file and any supporting files that BPMN file references.

Supporting files often include:

- `*-schema.json` files for RJSF forms.
- `*-uischema.json` files for form display settings.
- DMN files used by Business Rule Tasks.
- JSON files used by data stores or examples.

## Files[](#files "Link to this heading")

Ed can edit BPMN diagrams and supporting text files in the browser.
When a User Task references form files, keep the schema and UI schema paired by form purpose.

For example:

- `request-details-schema.json`
- `request-details-uischema.json`

Avoid reusing an unrelated UI schema with a copied User Task.
A mismatched pair can still run but render a confusing form.

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

Some workspaces use an Ed configuration process to define sync and connector proxy settings.
Keep configuration files separate from ordinary process model files when possible so they are easier to find and less likely to be synced accidentally.

See [GitHub Sync](github_sync.html) for the public configuration pattern.