mirror of https://github.com/storytold/figcraft.git synced 2026-10-26 03:16:53 -06:00

Files

T

BFlatandClaude Opus 5.5 435415770f M9: live sessions in the browser; join links and dialog polish (#106 )

- Browser client (step 4): the web build joins sessions a desktop app hosts
  through the browser's WebSocket API (web-sys, binary frames, the same
  message encoding). Its connection logic is a target-independent state
  machine (collab-net driver.rs): hello on open, changes and presence held
  until the welcome, throttled presence, keep-alive pings, a silent host
  counted as dropped, reconnect with backoff, final refusals. Tested natively
  against a scripted socket and a real host over loopback. Hosting stays
  desktop-only (LiveLink::can_host; collab.peers canHost). https pages are
  told up front that they can only reach ws:// sessions on this computer.
- Shared join logic (join.rs: GuestConfig, outcomes, taking in host messages)
  and transport limits (limits.rs) used by the native guest and the browser.
- Invite links: `figcraft figcraft://join?...` joins on start (a bad link
  opens the Join dialog with it); file:// arguments are paths. Windows
  registers a per-user figcraft:// opener (HKCU\Software\Classes\figcraft)
  behind a Registry trait (tests use a fake): collab.registerLinks {on?} and a
  Preferences checkbox, default on for installed builds, never for builds
  from source. macOS Info.plist declares CFBundleURLTypes; the Linux desktop
  entry declares x-scheme-handler/figcraft and passes %U.
- Join dialog: Escape closes it and no longer reaches the canvas (selection
  kept); its field has the keyboard when it opens.
- Docs: collab-protocol (browser client, links, mixed content), mcp,
  control-protocol, README, web hosting notes, collaboration wording in the
  progress docs (numbers unchanged).

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

2026-10-11 09:10:59 +07:00

7.4 KiB

Raw Blame History

FigCraft roadmap: milestones and what's next

Last reviewed: 2026-10-10 · Last updated: 2026-10-11 · Change: minor (wording: live sessions, the browser joins them, invite links open the app; numbers unchanged) · Target: Figma Design (desktop app 126.10.7)

Forward-looking plan. Where FigCraft stands today: ROADMAP.md and target-app-parity.md; the full ranked list: gaps.md. Hours are one Opus 5.5 agent; most milestones split across 4–6 agents on disjoint crates. There is no cargo xtask scorecard in this repo; the measured number is cargo xtask parity.

Current focus

.fig import (best effort) with a synthetic .fig corpus saved from the installed Figma: 30–60 h. Unblocks beta and every real-file measurement.
Real-file corpus and fidelity measurement: import real files, compare against Figma's own exports, turn estimated percentages into measured ones: 15–30 h.
Tool-by-tool interaction pass against the running Figma (ui-parity.md): 40–60 h, parallel by tool.
Localization layer, then Figma's own languages first (ja, ko, es, pt-BR, fr, de): 15–25 h for the layer, 3–5 h per language plus native review.
Multiplayer M9: a standalone server with TLS and sharing on top of the live sessions (the WebSocket transport, hosting from the app, invite links that open the app, document sync, live cursors, selections, avatars and follow, per-user undo, reconnect with offline edits and joining from the browser landed), per collab-protocol.md: 45–90 h.

Alpha gate

The core workflows a Figma Design user runs every day, checked end to end on macOS (the main platform) with work saved to .figcraft and reopened. Evidence is the repo's tests and the builders' side-by-side checks with synthetic files; nothing has been run on real Figma files yet.

Workflow	Works end to end?	Evidence	Hours to pass
Design screens: frames, shapes, vectors, text, auto layout, styles; save, reopen, export assets	yes	tools and panels in `crates/engine` and `crates/ui-egui`; `.figcraft` round trips (`crates/format/src/large_tests.rs`); PNG/JPG/SVG/PDF export tests	—
Build and use a design system: components, variants, properties, variables and modes, libraries	yes	`components_scale_tests.rs` (300 components, 2,000 instances), `library_tests.rs`, `library_variables_tests.rs`; libraries are local files, not shared	—
Prototype and present: interactions, flows, overlays, smart animate, variables	yes	`proto__tests.rs`, `present__tests.rs`	—
Hand off to developers: Dev Mode inspect, code, measurements, asset export, ready for dev	yes	`devinspect_tests.rs`, `component_codegen_tests.rs`, `devcompare_tests.rs`, `annotations_tests.rs`	—
Review with others: comments, versions, sharing the work	partial (not blocking)	comments with threads, mentions and resolve plus version history work inside a file (`comments_tests.rs`, `version_tests.rs`); the file is shared by passing it along; live sessions (preview: hosted from the desktop app, joined from the app or the browser) but no share links or per-person undo yet (collaboration-parity)	beta gap: 45–90
Continue existing Figma work (open `.fig`)	no (beta gap)	no `.fig` reader; REST JSON import works for files fetched through Figma's API (file-format-parity)	beta gap: 30–60

Passes, so FigCraft stays alpha: every daily design workflow works end to end on FigCraft's own files, which save and reopen, and ready for real work (~47%) is above the ~40% bar. The two gaps are real but don't break a workflow done in FigCraft: review works asynchronously through comments in a shared file, and opening .fig is the step that moves work across from Figma, which the standard requires for beta, not alpha. Both stay at the top of gaps.md as beta blockers.

Milestones

Milestone	Status	Left	Hours
M0 Foundation: workspace, model, renderer, engine, UI shell, app, control channel	done (2026-10-09)	—	—
M0.9 CLI + MCP, web build, release packaging, PDF export	done (v0.2.0 released 2026-10-10 for every platform)	—	—
M1 Core editing completeness (tools, panels, menus, clipboard, files)	~75%	Open recent, outline mode variants, keyboard box selection, interaction pass	8–14 + pass
M2 Layout depth	~80%	grid `fr` rows, real-file QA	6–12
M3 Components & styles depth	~75%	extended collections, variables import/export, real libraries	10–20
M4 Vector & text depth	~70%	live booleans, spell check, Figma Draw (brushes, pressure, text on a path, patterns)	24–40
M5 Prototype & present	~85%	media, gamepad, separate window	5–9
M6 Interop & Dev Mode	~55%	`.fig` import, video/HEIC/TIFF, CMYK intent, Code Connect	40–80
M7 Release & fidelity (signed builds, look & feel, shortcuts)	builds done; fidelity pass started	tool-by-tool pass	40–60
M8 Hardening & performance (bench, retained canvas, accessibility, idle)	~60%	real-file corpus, platform QA, GPU canvas, screen readers	60–110
M9 Real-time collaboration	core done (#103: ids, change sets, server ordering, convergence); live sessions (WebSocket transport with limits and reconnect, hosting from the app, invite links, document sync between apps, cursors, selections, avatars, follow, `collab.*` commands); per-user undo, rejection handling, offline queue and resuming after a reconnect; the browser client (joins desktop-hosted sessions); `figcraft://` links open the app and join (Windows registers per user; macOS and Linux packages declare the scheme)	standalone server with TLS, sharing	45–90
M10 Localization (new)	not started	layer + 11 languages	60–100
M11 Plugins	runtime, API, menu, manager and SDK done (#101)	run-time plugin UI, settings storage, distribution, widgets; Figma plugin compatibility is an owner decision	25–55
M12 AI features (new, owner decision)	not started	local models	30–60

Next, after the current focus

Shared libraries on top of the multiplayer server (10–20 h), branching (8–15 h).
GPU canvas held to the CPU renderer (30–60 h).
Figma Draw tools (10–18 h).
Mobile viewer and prototype mirror (20–40 h).

Revision history

Date	Change	Summary
2026-10-11	minor	Wording only: live sessions (#104), then the browser joining them and `figcraft://` invite links opening the desktop app; percentages and hours unchanged until the next re-measure
2026-10-10	minor	Merged main after #101–#103: WASM plugins (plugins area 0% → 35% breadth, 20% ready; ecosystem 5% → 20%) and the multiplayer core without networking (multiplayer 5% → 15% breadth, 5% ready; collaboration 8% → 12%); menu breadth 97.5% → 98.5% (200/203); ready for real work ~46% → ~47%; full parity 420–790 h → 390–745 h; beta 210–380 h → 200–365 h. Fixed the stated weight sums (areas 1–16 sum to 94, total 113; percentages were already computed with those)
2026-10-10	minor	Added the alpha gate (core-workflow table): passes, stage stays alpha
2026-10-10	major	Created: milestone table moved from ROADMAP.md with statuses re-checked; added M10–M12; current focus re-planned

7.4 KiB Raw Blame History Unescape Escape