Formats & interoperability
Choose an editable Fanta project, a snapshot, FNX source, Figma import, or rendered export.
Fanta's editable document is a project directory with a fanta.json manifest. In layout version 5, each variant set has one folder containing its set definition and member masters. Pages, standalone components, variables, metadata, and assets also live in separate files. The persistent Project Assets library can store named media before it is placed on a page. A canvas edit updates the affected project files, and valid saved source changes reload in the canvas.
Choose the right output
| Format | Main purpose | Editable in Fanta? |
|---|---|---|
| Fanta project directory | Continue designing and version source and assets in Git | Yes |
.fant snapshot | Package a design and its assets as one file | Import into an editable project |
.fnx source | Review or edit a page or component master as static JSX-like source | Yes, within a project |
.fig import | Bring an existing Figma design into Fanta | Imported into an editable project |
| PNG, JPG, SVG, PDF | Share a visual result | Rendered output |
The Code workspace can edit FNX and its selected page or component JSON header when the canvas is clean, validate the complete project, and reload the canvas on save. An external editor or agent can edit other managed project files too; validate typed JSON and references before writing. New projects include a fanta.md design brief, AGENTS.md editing guide, and FNX editor support files.
Save and version
Keep the project manifest, page and component source, ID sidecars, shared document data, asset library metadata, and media bytes together in Git. An external file edit is reconciled into the open editor; invalid source leaves the last valid canvas visible with a diagnostic. If a canvas change and file change overlap, Fanta presents a conflict.
File → Save As… creates a new local project copy, including current edits and assets, and points subsequent saves to that copy. The original project stays intact. The .fant handler supports import and export at the format layer, but a snapshot is not the editable working directory. The confirmed editor export controls produce visual files. See project and snapshot details.