AI-native design editor. Open-source Figma alternative.
docs: centralize roadmap
Danila Poyarkovbf232bac8b02
diff --git a/AGENTS.md b/AGENTS.mdindex c596d8671..0fd6c8d3a 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -2,7 +2,7 @@Vue 3 + CanvasKit (Skia WASM) + Yoga WASM design editor. Tauri v2 desktop, also runs in browser.-**Compatibility tracking:** `packages/docs/development/figma-compatibility.md` tracks known Figma feature gaps and raw metadata coverage. Current architecture and commands live in this file.+**Roadmap:** `packages/docs/development/roadmap.md` tracks product direction, Figma compatibility gaps, and raw metadata coverage. Current architecture and commands live in this file.## Monorepodiff --git a/README.md b/README.mdindex 21bbf1237..2221f6d4a 100644--- a/README.md+++ b/README.md@@ -229,6 +229,8 @@ Figma is a closed platform that actively fights programmatic access. Their MCP sOpenPencil is the alternative: open source (MIT), reads .fig files natively, every operation is scriptable, and your data never leaves your machine.+See the [roadmap](https://openpencil.dev/development/roadmap) for product direction and current Figma compatibility gaps.+## Contributing### Setupdiff --git a/packages/docs/.vitepress/root-theme.ts b/packages/docs/.vitepress/root-theme.tsindex db0ff7dcd..c3838fc9a 100644--- a/packages/docs/.vitepress/root-theme.ts+++ b/packages/docs/.vitepress/root-theme.ts@@ -34,7 +34,7 @@ export const rootThemeConfig = (): DefaultTheme.Config => ({items: [{ text: 'Contributing', link: '/development/contributing' },{ text: 'Testing', link: '/development/testing' },- { text: 'Figma Compatibility', link: '/development/figma-compatibility' },+ { text: 'Roadmap', link: '/development/roadmap' },],},],diff --git a/packages/docs/.vitepress/sidebars.ts b/packages/docs/.vitepress/sidebars.tsindex 62ebeca59..1b5dba920 100644--- a/packages/docs/.vitepress/sidebars.ts+++ b/packages/docs/.vitepress/sidebars.ts@@ -92,8 +92,8 @@ export const developmentSidebar = (prefix: string, label: string): DefaultTheme.items: [{ text: 'Contributing', link: `${prefix}/development/contributing` },{ text: 'Testing', link: `${prefix}/development/testing` },+ { text: 'Roadmap', link: `${prefix}/development/roadmap` },{ text: 'Renderer Profiler', link: `${prefix}/development/renderer-profiler` },- { text: 'Figma Compatibility', link: `${prefix}/development/figma-compatibility` },{ text: 'Vector Conversion', link: `${prefix}/development/vector-conversion` },],},diff --git a/packages/docs/development/figma-compatibility.md b/packages/docs/development/roadmap.mdsimilarity index 83%rename from packages/docs/development/figma-compatibility.mdrename to packages/docs/development/roadmap.mdindex d8134e2de..5449c1f17 100644--- a/packages/docs/development/figma-compatibility.md+++ b/packages/docs/development/roadmap.md@@ -1,11 +1,62 @@----title: Figma Compatibility Matrix-description: Current OpenPencil support for Figma design features, including import, rendering, UI editing, export round-trip, and raw Kiwi metadata coverage.+title: Roadmap+description: OpenPencil product roadmap and Figma compatibility tracking.----# Figma Compatibility Matrix+# Roadmap-This page tracks OpenPencil's current compatibility with Figma Design features. It is based on Figma's public Help Center feature areas and the current OpenPencil scene graph, Kiwi import/export, CanvasKit renderer, UI panels, CLI, and MCP tools.+OpenPencil is moving toward production-grade Figma compatibility while keeping design workflows scriptable, local-first, and fast on large files.++## Current focus++- Improve `.fig` import/export fidelity against real Figma files and Figma's own rendering.+- Keep large design systems responsive in the browser and desktop app.+- Make every important editor operation available through the CLI, MCP server, and SDK.+- Keep files on the user's machine unless collaboration is explicitly enabled.++## Near-term work++### Figma fidelity++- Preserve and round-trip more Figma metadata safely.+- Add visual regression coverage for full multi-page `.fig` documents.+- Close high-impact renderer gaps: masks, blend modes, corner smoothing, pattern fills, and variable font axes.+- Improve boolean operation import so Figma `BOOLEAN_OPERATION` nodes remain editable where possible.++### Editor depth++- Complete variable inspector coverage for common numeric/text/layout fields.+- Improve component and instance editing: variant switching, property editing, and override inspection.+- Add first-class layout grid and guide rendering/editing.+- Expand vector editing workflows without regressing imported vector fidelity.++### Automation++- Tighten the inspect → act → render/measure → compare loop for agents.+- Improve deterministic CLI/MCP export and comparison tools for CI.+- Add more design linting and migration helpers for batch `.fig` and `.pen` workflows.+- Package desktop-side MCP integration so local agent workflows do not require global installs.++### Performance and scale++- Incremental layout and render invalidation for large documents.+- Better renderer profiling surfaces for slow nodes, effects, masks, and imported files.+- Smarter raster/retained caching that preserves fidelity during zoom and pan.++## Later++- Prototyping: frame connections, triggers, overlays, transitions, and preview mode.+- Comments: pins, threads, resolution state, and collaboration-aware display.+- Shared libraries: publish, consume, and update components/styles across files.+- More platform polish: Windows code signing, PWA support, and packaged updater improvements.++## Non-goals++- Cloud-first storage or mandatory accounts.+- Read-only automation surfaces that cannot modify documents.+- Feature work that sacrifices `.fig` import/export fidelity for convenience.++This section tracks OpenPencil's current compatibility with Figma Design features. It is based on Figma's public Help Center feature areas and the current OpenPencil scene graph, Kiwi import/export, CanvasKit renderer, UI panels, CLI, and MCP tools.Legend:@@ -27,7 +78,7 @@ Figma's design documentation groups features into these areas:- Dev Mode: inspect, measurements, annotations, Code Connect, dev resources, ready-for-dev states, and Figma MCP.- Collaboration/file workflows: comments, version history, thumbnails, branches, library publishing, and multiplayer metadata.-## Feature matrix+## Figma compatibility matrix| Area | Import | Render | UI edit | Export round-trip | CLI/MCP | Notes ||---|---:|---:|---:|---:|---:|---|@@ -155,3 +206,4 @@ These are parsed or visible in Figma docs and most likely to cause visible diffe| Property panels | `src/components/properties/**`, `packages/vue/src/controls/**` || CLI | `packages/cli/src/index.ts`, `packages/cli/src/commands/**` || MCP/tools | `packages/core/src/tools/**`, `packages/mcp/src/tool/registration.ts` |+