Fanta docs
Reference

Changelog

What this source-aligned Fanta documentation covers.

October 19, 2026 source alignment

These pages now track published fanta-edit main at e143440a. Changes merged after the previous checkpoint renamed the app's Cargo package and action namespace to fanta, its project-local configuration directory to .fanta, and its app link scheme to fanta://. The repository now builds explicitly with cargo run -p fanta; plain cargo run works through the workspace default. The local canvas MCP roster remains 13 tools with 43 design operations; no new format or generation behavior was found in this source interval.

The accepted signed Build45 installer is still bound to earlier source 57d86330. It uses .zed project settings, zed:: app actions in keymaps, and zed:// app links. Current source uses .fanta, fanta::, and fanta://. Custom configuration and links should be reviewed when moving to a future build; automatic migration and a newer public installer have not been verified.

October 15, 2026 source update

These pages track published fanta-edit main at 44584c26. The signed Fanta 1.0.0 Public Alpha installer remains bound to earlier source 57d86330; this source update is not a new accepted app build.

External MCP still registers 13 tools. get_editor_state now previews at most 100 components and reports the total and whether more remain. get_design_system pages variables, components, and variant sets independently, and batch_get rejects page listings whose traversal exceeds 1,000 nodes. Default page reads and screenshots follow the focused page or opened component. A batch_design batch containing only selection or viewport operations does not create an undo step; content edits still commit as one undoable batch.

Current macOS source prefers Skia Graphite on Metal, with Ganesh fallback if Graphite cannot start. Retained translation is enabled unless FANTA_RETAINED_TRANSLATION=0. Loading, scoped saving, canvas panning, and memory use have changed for large documents. Bounded benchmarks and source tests do not establish general responsiveness or behavior in the released Build45 installer. Native builds route new AI credit purchases to web Billing; existing Apple subscriptions still open Apple's subscription management.

October 13, 2026 source and release update

At this checkpoint the pages tracked fanta-edit main at 9e582bee. The signed Fanta 1.0.0 Public Alpha installer is bound to source 57d86330; that checkpoint had no later application-code changes. Source inclusion and installed-app acceptance are described separately. The official download page makes the Public Alpha available. Its matching Developer ID-signed and notarized DMG passed local installation and save/reopen checks, and an anonymous public download matched the accepted checksum. Clean-account installation and migration from an older version remain unverified.

Current source limits a native Agent turn to 64 model requests, preserving completed work at the visible stop. Other changes since the previous source baseline cover focused numeric draft handling before Save and close, fractional TextPath positioning, rounded-clip targeting, closed-tab restoration, narrow-canvas Crop controls, generated-audio completion feedback, gallery timestamps, and Settings search Escape behavior. The external MCP surface remains 13 tools with 43 design operations; FNX and import/export formats did not change in this interval.

October 11, 2026 source update

The docs now track published fanta-edit main at 22f73419. On direct-download macOS, a fresh .fig import stages and flushes a complete sibling project before publishing it; if publication fails, the parsed design remains open for a save retry. The project guide also clarifies received-folder Restricted Mode and the limits of concurrent external writes.

Canvas snapping now searches indexed layer targets in the active page or opened component subtree. A Select gesture cancels its pending move if the mouse press is lost, and editable Design Crop shows Ratio, Cancel, and Apply controls. Billing usage charts use one rolling UTC window for their 7, 30, or 90-day daily and key views. Project loading and text-layout caching changed internally; these source changes and mounted tests do not establish native responsiveness or complete installed-app acceptance.

Maintainers can opt into macOS release build diagnostics. The latest documented internal arm64 DMG check used earlier source 79cc2ef8 and an ad-hoc signature; its public release job was skipped. A Developer ID-signed, notarized download and clean-Mac installation remain unverified. The local canvas MCP interface remains 13 tools and 43 design operations.

October 9, 2026 source update

The docs now track published fanta-edit main at 79cc2ef8. A single editable TextPath layer offers Edit object in the inspector, and Select matching layers treats Sections as Sections on the active page. The canvas Properties menu also routes supported specialist layers to the Design inspector. These paths have mounted editor tests; installed-app acceptance remains separate.

JPEG export now uses fixed quality 95, remains lossy, and writes an opaque image. A focused bitmap regression passes, while the source coverage report still records an earlier native JPEG comparison failure. The renderer now retains unaffected effect layers during scene edits and invalidates affected layers; native responsiveness is still under validation.

For outbound account-backed MCP, a failed startup now preserves an unused endpoint OAuth session. Local canvas MCP remains 13 tools and 43 design operations. The release coverage report records bounded Audio and internal ad-hoc DMG checks, but cold MP3 preview was absent in its placement fixture. A Developer ID-signed public download, clean-Mac install, and live managed-service journeys remain unverified.

October 8, 2026 source update

The docs now track published fanta-edit main at d386b9f4. FNX printing now preserves finite numeric values exactly, including very small values that previously printed as zero. The media guides clarify placement routes: the local picker handles supported raster images and MP4 video; editable SVG can come from Project Assets or generation results, while audio placement uses Project Assets. Video preview and trim have bounded development checks, while arbitrary codecs and installed-release media behavior remain unverified.

The Mac packaging workflow now aligns both bundle version fields with the source version and retries the specific transient busy-disk-image error without replacing a prior finished DMG. These checks improve packaging reliability; the signed download and clean-Mac installation remain separate release gates. The external MCP interface remains at 13 tools and 43 design operations.

October 7, 2026 source update

The docs now track published fanta-edit main at a022ddb4. Structural canvas saves preserve authored FNX attributes and comments on surviving nodes; Save reports a preservation error if a destructive edit would lose source-only data. During an unsaved source draft, the accepted properties of one selected layer remain readable while canvas writing stays locked.

Canvas Cut, Delete, and Duplicate now respect layer locks more consistently. Paste checks component dependencies and can restore a captured component or complete variant set after its original definition was removed. The inspector shows more resolved variable values and independent corner fields; variant navigation and instance text editing follow the visible member and binding rules. Edit Path shows anchors on entry, and Escape can finish active canvas text editing. The external MCP roster remains 13 tools with 43 design operations.

The retained Metal translation renderer is opt-in and its native performance target remains unverified. The selected distribution is a direct-download Mac app, with mounted-DMG verification added to packaging; signed download and clean-Mac installation still require validation. The release coverage report distinguishes bounded checks from release readiness.

October 6, 2026 source update

The docs now track published fanta-edit main at 8fe28c69. Figma import now preserves supported Boolean operands and warns about known flattened or omitted structures. Canvas and keyboard duplication preserve copied component definitions, complete variant sets, and supported internal prototype links; same-document Paste retains existing definitions, while cross-document canvas Paste reports that it is unsupported. The inspector adds or repairs controls for mixed selections, bound paint, Boolean nodes, rotation, flipping, alignment, distribution, and Tidy up.

The Code workspace gains embedded Find, selected-buffer Discard draft, and source Save/Undo preservation. The editor also improves project/source reload ownership and layout preservation. The prototype detail's X closes the detail without deleting its interaction; Remove is the deletion action. Current time in Motion accepts a typed seek. The source release coverage report records bounded native checks alongside open large-project Save, draft recovery, final artifact, and distribution gates. These implementation changes do not establish a new packaged release.

October 5, 2026 source update

The docs now track published fanta-edit main at 23b1ff95. The editor implements grid auto-layout, node-aware double-click and canvas context-menu actions, and a separate Build mode for task-based agent design with review controls. Grid still has documented Figma behavior gaps. Variant sets gain a visible frame and operations to grow, shrink, arrange, and rename them; project layout v5 stores a set and its member components in one folder, migrating v4 on save.

The external server still exposes 13 MCP tools, with 43 batch_design operations. New operations cover fills and effects, constraints, shape creation, grid layout, and component/variant-set work. batch_get can return a summary, editable style projection, or raw node data. These pages describe merged implementation; packaged release and hosted-service availability require separate verification.

October 4, 2026 source update

The docs now track published fanta-edit main at af712551. The Code workspace can edit the active page or component's paired JSON alongside FNX, validate the complete candidate against the project, and reload the canvas. Modern FNX with explicit IDs can recover a missing or damaged sidecar. A failed external source reload keeps the last valid canvas and reports a repairable error.

External batch_design still exposes 33 operations through the same 13 MCP tools, but now streams each operation visibly while retaining one undoable, rollback-safe batch. An optional activity identity and richer report_agent_activity fields let Fanta follow an agent across the Canvas, Variables, and Code workspaces. The source also improves property editing, component-master navigation, and the in-app agent workflow. These are implementation claims, not a new packaged release announcement.

October 3, 2026 source update

The docs now track fanta-edit main at 182b111c. The external live MCP bridge registers 13 tools. New tools inspect the design system, prepare an image or SVG generation draft for user review, validate FNX without writing, import an image into the project, read and reply to comments, and report an agent's local canvas activity. batch_design also has operations for child layout, variables and modes, variant sets, component properties, and instance values.

The editor source adds direct local image and MP4 placement, proportional scaling, arrow drawing, Text on Path, Motion keyframes and playback, persistent measurements and annotations, and a guarded Dev inspection session. Project creation seeds a fanta.md design specification. Save As, media playback and trimming, account views, and source save recovery also changed. These pages describe the committed implementation; public packaging and service availability still depend on the build and deployment.

September 29, 2026 source update

The docs now track fanta-edit main at ebabb405. Its implemented changes include a persistent Project Assets panel; placement of generated image, SVG, MP4, and WAV/MP3/FLAC audio assets; audio preview, duration, seeking, and save fixes; catalog-driven generation controls; managed chat-model discovery; the in-app Jev evaluation tool; and a new Settings window with MCP, account, billing, and privacy sections.

The source also contains a Mac App Store feature build with process and Git restrictions. The distribution and packaged external-agent bridge are described conditionally because source and merged commits alone do not establish public availability or end-to-end release validation.

Current alpha documentation

This edition introduced the native Fanta app and its .fnx project workflow. It corrected earlier references to a separate fanta-app executable, fixed HTTP MCP port, and per-action MCP roster. At that source revision the external interface had six tools through fanta --mcp-stdio; the October 3 source revision above extends it to 13.

The docs cover project creation, Git review, Figma import, the agent build loop, source editing, and the supported alpha editor paths. The source and its known issues remain the record of implementation and validation status.

At that revision, several visible controls were not connected. The dated entries above supersede those observations where implementation changed. The issue log and release coverage report separate current source behavior from native-app and distribution validation.

On this page