Saving, opening, and sharing projects

A project is one .openchip file — plain JSON you can read, diff, and put in a repository next to the paper. See The .openchip file format for what is in it.

Saving

⌘S / Ctrl+S, or Save in the top bar.

What happens depends on your browser:

Chromium-based browsers (Chrome, Edge, Arc, Brave) support the File System Access API. The first save asks where to put the file; every save after that overwrites it in place, the way a desktop application does.

Firefox and Safari do not. Every save is a download, so you end up managing versions in your downloads folder. It works; it is just less pleasant.

The app tells you which mode it is in, and the state beside the project name is honest about it: green and “Saved to …openchip” means it is on disk. Anything else means it is only in browser storage.

⇧⌘S is Save as…, which always asks for a new location.

Note

A file handle does not survive a page reload. After reloading, the first save prompts for a location again even in a browser that supports saving in place — the browser requires a fresh permission gesture, and there is no way around it.

Opening

⌘O / Ctrl+O, or Project → Open.

The file is validated on load. If something is wrong, the message names the field and says what was expected — the loader rewrites raw validation paths into sentences for exactly this reason.

Two kinds of problem are rejected outright:

• Structural. A required field missing or the wrong type.
• Referential. An edge pointing at a node that is not there, or two nodes sharing an id.

Everything else is accepted. A file from an older build gets defaults for fields that did not exist yet; a file from a newer build keeps its unrecognised fields through a save round-trip.

Draft recovery

The app writes your work to browser storage as you go, debounced so a drag is not serialising on every frame.

Close the tab mid-design and it is there when you come back. If what was restored had never been written to a file, the app says so on load rather than letting you assume it was saved.

This is a safety net, not a backup:

• It is per-browser and per-machine.
• Clearing site data clears it.
• A private window may not keep it at all.

Save to a file. The draft is there to stop you losing an afternoon, not to hold your work long-term.

If your browser has storage disabled entirely, the app says so when you start a project and tells you to save as you work.

Sharing

Send the .openchip file. It carries:

• the channel network, chip parameters and every dimension;
• the printer profile it was designed against, so the recipient’s checks measure the same things you did;
• fluid profiles and the run setup;
• drainage vents;
• any saved images.

It does not carry anything about you or your machine. No paths, no identifiers, no settings.

Tip

Because it is plain JSON with stable field names, it diffs usefully. Committing .openchip files alongside a paper’s analysis code gives you a real history of how a device evolved — and a reviewer can see exactly what was printed.

Exports are not projects

An STL is a mesh. It has no channel graph, no parameters, no checks. You cannot open one in OpenChip and get your design back.

Keep the .openchip. Send both if the recipient needs to print and modify.

See Exporting.