---
title: "Getting Started with Ed — Visual Design Studio 0.1 documentation"
description: "Open Ed at https://ed.spiff.works . If you have access to more than one workspace, choose the workspace that contains the process models you want to edit."
source_url: https://spiff.works/docs/ed/getting_started.html
---

☰ Menu

# Getting Started with Ed[](#getting-started-with-ed "Link to this heading")

Open Ed at `https://ed.spiff.works`.
If you have access to more than one workspace, choose the workspace that contains the process models you want to edit.

![Ed Editor Interface](_images/EDeditor.png)

## Basic Workflow[](#basic-workflow "Link to this heading")

1. Create or open a workspace.
2. Create or open a process.
3. Create or open a BPMN file.
4. Edit the diagram and supporting files.
5. Run the diagram to check behavior while you build.
6. Sync the process model files to GitHub when your workspace is configured for sync.

![Create Workspace](_images/Create_Workspace.png)

## What You Can Create[](#what-you-can-create "Link to this heading")

An Ed workspace can contain BPMN diagrams and supporting files such as:

- JSON Schema files for User Task forms.
- UI Schema files for form layout and widget settings.
- DMN decision tables.
- JSON data files used by data stores or examples.
- Markdown or other process documentation files.

## Good First Checks[](#good-first-checks "Link to this heading")

Before making a large change, confirm:

- You are in the correct workspace.
- You are editing the intended process and file.
- The BPMN diagram opens without import errors.
- User Tasks that use forms reference both a JSON Schema file and a UI Schema file.
- The process can run at least to the next user input or expected wait state.

## Related Documentation[](#related-documentation "Link to this heading")

- [Author BPMN in Ed](author_bpmn.html)
- [Forms in Ed](forms.html)
- [Run and Debug Diagrams](run_debug.html)
- [GitHub Sync](github_sync.html)
