Importing Wireframes and Saving Version Snapshots

StretchWire lets you import an existing wireframe as a JSON document and capture versions so you always have point-in-time history to return to. This guide covers both the import flow and version snapshots.

Importing a wireframe

If you already have a wireframe document — exported from another StretchWire board or produced by a tool that speaks the wireframe format — you can bring it in to seed a new project and board.

Import step by step

1. From the dashboard, click the Import tile, or choose Import in the left navigation.
2. Enter a project title (required) for the imported wireframe.
3. Provide the document JSON one of two ways:
- Click Choose .json and select a file, or
- Paste the JSON directly into the Wireframe document JSON editor.
4. StretchWire validates the JSON as you go. It must be a JSON object with wireframe document fields (for example {"frames":[],"sections":[]}), and the file must be under 2 MB.
5. Click Continue import. StretchWire creates a new project (typed as an imported wireframe) and an imported board containing your document.

Tip: The import expects a document object, not an array or a bare value. If validation complains, wrap your content in { } and confirm it's valid JSON.

What gets created

Importing produces a new project plus a board whose layout is your imported document — so the frames and blocks in your JSON appear immediately on the canvas, ready to edit.

Saving version snapshots

A version snapshot is a saved, point-in-time copy of a board's document. StretchWire keeps a running version history so you can experiment freely and always return to a known-good state.

How versions are created

• Automatically — saving your work and autosaves during a live collaboration session each capture a version, building history without any manual step.
• Manually — capture a deliberate, named Snapshot from the Boards table (or as you save) at a milestone, so important checkpoints are easy to find later.

Each version is numbered sequentially and can carry a title (for example Pre-review v1) and a note of who created it.

Save a named snapshot

1. Open the project and find the board in the Boards table.
2. Choose Snapshot for that board.
3. Give the snapshot a meaningful title — Client review 2026-07-10, Before nav rework.
4. Confirm. The snapshot is added to the board's version history and the board reflects the saved document.

Roll back to an earlier version

Because every save is preserved, you can return to any earlier state: open the version you want from the board's history and re-save its document as the current one. That creates a new version from the old content — so rolling back never destroys the versions in between; it simply moves the known-good document to the top.

Example

You're reworking the Home board's hero. Before you start, you capture a snapshot titled Home - before hero rework. You spend an hour trying three layouts; the client prefers the original. You open the Home - before hero rework version and re-save it — the board is back to the approved layout, and all three experiments remain in history in case you want them later.

Tips

• Snapshot before any risky change and after any approval, so your history reads like a decision log.
• Give snapshots descriptive titles — Version 7 is far less useful than Client-approved pricing v2.
• Keep imports under 2 MB and valid JSON; validate externally first if you're unsure.

Troubleshooting

"JSON is too large. Keep imports under 2 MB." Your file exceeds the limit. Trim unused frames/blocks or split the wireframe into multiple boards.

"Import JSON must be an object with wireframe document fields." The content isn't a JSON object. Wrap it in { } and ensure it has document fields like frames.

"Project title is required." Enter a title before importing — every imported wireframe starts a titled project.

I don't see a Snapshot option. Saving and versioning require write access — Pro on the workspace surface, step-up on admin. Check for an access banner.