Deprecate and remove the legacy workflow editor
Open
@doc-han is already working on this.
Since Jul 14, 2026.
deprecation
Epic
Status: review
tech debt
- Dominant language
- Elixir
- Stars
- 296
- Forks
- 86
- Avg merge
- 1d 13h
- Merged PRs (30d)
- 50
Description
Overview
The collaborative editor (WorkflowLive.Collaborate) has been the default since late 2025, and the legacy editor (WorkflowLive.Edit) has been showing a deprecation banner. This issue tracks the work to fully remove the legacy editor.
Background
- The new collaborative editor lives at
/w/:idand is backed by Yjs CRDTs for real-time multi-user editing. - The legacy editor lives at
/w/:id/legacyand is only reached when a user hasprefer_legacy_editor: truein their preferences. - A deprecation banner and "switch to new builder" button have been in place since v2.15.
Removal Checklist
1. Migrate remaining legacy-preference users
- Write a migration to clear
prefer_legacy_editor: truefrom all users (mirrors the earlierclear_prefer_collaborative_editormigration)
2. Remove the redirect hook
- Delete the
check_legacy_preferencehook inlib/lightning_web/hooks.ex(lines 142–164) that readsprefer_legacy_editorand redirects to/legacy
3. Remove legacy routes
- Drop
/w/new/legacyand/w/:id/legacyfromrouter.ex - Decide on handling for bookmarked URLs (redirect to new editor, or informative 404)
4. Remove WorkflowLive.Edit
- Delete
lib/lightning_web/live/workflow_live/edit.ex - Remove
deprecated_warning/1component fromcomponents.ex - Remove any helpers/components only used by the legacy LiveView
5. Remove the legacy frontend bundle
- Delete
/assets/js/workflow-editor/(old React workflow editor) - Audit
/assets/js/editor/— if only used by legacy editor, delete it too - Remove
CollaborativeEditorPromoBannercomponent and its tests (no longer needed once legacy is gone)
6. Remove the switch_to_legacy_editor channel handler
- Drop the
handle_in("switch_to_legacy_editor", ...)clause inworkflow_channel.ex
7. Remove URL conversion helpers
- Delete
legacy_editor_url/2andcollaborative_editor_url/2fromlib/lightning_web/live/workflow_live/helpers.ex(only needed for cross-editor redirects)
8. Remove legacy editor tests
- Delete
test/lightning_web/live/workflow_live/editor_test.exs(~2,000 lines) - Remove all
/legacyroute references from other test files (e.g.new_workflow_component_test.exs,collaborate_test.exs)
Out of Scope
- Changes to the collaborative editor itself
- Worker or runtime changes
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.