Is there an existing issue for this?
Summary
📌 Overview
Integrate Eraser.io into Plane to enable engineering teams to seamlessly embed, view, and link technical architecture diagrams, flowcharts, and technical specs directly within Plane Issues, Pages, Modules, and Project Settings.
💡 Why this Feature? (Problem & Value Proposition)
- Problem: Developers and architects design software architecture, sequence diagrams, and flowcharts in Eraser.io, but have to copy-paste static screenshots into Plane issues, which quickly become outdated.
- Value:
- Live Diagrams in Plane: Keeps architecture docs and technical specs dynamic and up-to-date inside Plane.
- Faster Context Switching: Developers can view architecture models directly in issue descriptions without navigating away.
- Visual Task Breakdown: Architecture diagram nodes or flows can be linked to corresponding Plane issues/modules.
📅 Phased Milestones
| Milestone |
Title & Objective |
Key Deliverables |
Affected Codebase Modules |
Acceptance Criteria |
| Milestone 1 |
Architecture Design |
• Research Eraser API & oEmbed schemas • Draft API data flow RFC |
Spec / RFC Document |
• Approved Architecture design • Verified Eraser API endpoints |
| Milestone 2 |
Editor Embed & Slash Command |
• Add /eraser slash command • Build TipTap iframe embed node • Auto-unfurl Eraser URLs |
packages/editor |
• Paste Eraser link to embed live diagram • Interactive diagram preview in issues/pages |
| Milestone 3 |
Backend Models & Webhooks |
• Add Django EraserIntegration model • Build connection & metadata APIs • Webhook receiver for updates |
apps/api |
• API stores & validates Eraser API keys • Metadata endpoint fetches title & thumbnail |
| Milestone 4 |
Settings UI & Issue Sidebar |
• Eraser card in Workspace Settings • Connection modal (API token input) • Issue sidebar diagram links widget |
apps/web
packages/shared-state |
• Admins can connect/disconnect integration • Issues show linked Eraser architecture docs |
| Milestone 5 |
Testing, Specs & PR Ready |
• Write backend pytest & frontend tests • Run pnpm check (oxlint, types) • Prepare PR & documentation |
apps/api/tests/
docs/ |
• Clean test pass & pnpm check • Ready for maintainer review |
Why should this be worked on?
Most dev teams use Eraser for architecture diagrams and Plane for tracking tasks. Integrating Eraser lets us embed live, auto-updating diagrams inside issue descriptions instead of static screenshots. It keeps tech specs up to date in one place.
Is there an existing issue for this?
Summary
📌 Overview
Integrate Eraser.io into Plane to enable engineering teams to seamlessly embed, view, and link technical architecture diagrams, flowcharts, and technical specs directly within Plane Issues, Pages, Modules, and Project Settings.
💡 Why this Feature? (Problem & Value Proposition)
📅 Phased Milestones
• Draft API data flow RFC
• Verified Eraser API endpoints
/eraserslash command• Build TipTap iframe embed node
• Auto-unfurl Eraser URLs
packages/editor• Interactive diagram preview in issues/pages
EraserIntegrationmodel• Build connection & metadata APIs
• Webhook receiver for updates
apps/api• Metadata endpoint fetches title & thumbnail
• Connection modal (API token input)
• Issue sidebar diagram links widget
apps/webpackages/shared-state• Issues show linked Eraser architecture docs
• Run
pnpm check(oxlint, types)• Prepare PR & documentation
apps/api/tests/docs/pnpm check• Ready for maintainer review
Why should this be worked on?
Most dev teams use Eraser for architecture diagrams and Plane for tracking tasks. Integrating Eraser lets us embed live, auto-updating diagrams inside issue descriptions instead of static screenshots. It keeps tech specs up to date in one place.