Saving, sharing and export

Saving#

Press Ctrl+S (Cmd+S on a Mac). Diagravo handles the shortcut itself, so the browser’s own “Save page as” dialog never opens. The same save happens from File → Save, from the terminal’s save command, and when you rename the diagram and press Enter in the name field.

You can create an account with an email and password or with Continue with Google. If you use both with the same email address it is one account, not two, and Google counts as verifying that email. One thing to know: if a password account’s email was never verified, joining it with Google removes that password (Google has proved the inbox, and anybody who only typed the address in must not keep a way in) — use Forgot password? on the sign-in form to set a new one. The same button adds a password to an account you created with Google. The email we send to confirm your address works for 24 hours; if it has expired, open the account menu and choose Resend verification email.

After the first save the address changes to /app/… with the diagram’s id, so refreshing the page or bookmarking it brings the same diagram back. A short message beside the diagram name says what happened — for example “Saved on this device”, “Saved · synced to the cloud” or why the cloud copy could not be updated.

There is also a safety net underneath: if the page is refreshed or crashes with changes you have not saved, a banner offers to restore them the next time the editor opens, and the browser asks before you close a tab with unsaved work.

My Diagrams#

File → My Diagrams — or the window that opens when you press Create Diagram on the home page — lists everything you can open. Each diagram shows where it lives:

• This device only — saved here, not in the cloud.
• In the cloud — saved here and synced to your account.
• Cloud only — in your account but not on this device yet. Opening it keeps a copy here.
• Shared with you — somebody else’s diagram you were invited to.

New diagram starts a blank canvas. The list shows the most recently changed diagram first.

Cloud sync and the 20-diagram limit#

You can create as many diagrams as you like on your device. A signed-in account can keep up to 20 of them in the cloud, and you choose which: each diagram has a cloud button that turns sync on or off. If the cloud is full, saving still works on your device and a message explains that the cloud is full; remove one from the cloud (it stays on your device) to make room. Diagrams other people shared with you do not count towards your 20.

• Turning sync off removes the cloud copy and keeps the one on your device. Be aware that a published share link and any collaborators stop working, because they rely on the cloud copy — Diagravo asks you to confirm first. After that, Ctrl+S will not quietly switch sync back on; only turning it on yourself, or publishing or sharing, does.
• Deleting a diagram removes both the device copy and the cloud copy. If the cloud cannot be reached at that moment, the cloud delete is remembered and finished the next time you are signed in, so it is never left half-done.
• Which copy wins. When you open a synced diagram, the cloud copy is used (it may have been edited elsewhere or by a collaborator) unless the copy on your device is newer — for instance because you saved while offline — in which case yours is kept and sent up. If the cloud cannot be reached you simply get the device copy.
• Size. A diagram stored in the cloud can hold up to 40 components.

Publishing a read-only link#

Publish (top right of the toolbar, or publish in the terminal) makes a public link of the form diagravo.com/share/…. Anyone with the link can open the diagram, move around it and press Play — no account needed — but cannot change it. You need to be signed in, and publishing puts the diagram in the cloud if it was not already.

• The link always shows the diagram’s current cloud copy, so it stays up to date as you save.
• On the free plan, published views carry a small “Made with Diagravo” mark.
• Your custom icons are included, so the viewer sees the diagram as you drew it.
• Deleting the diagram from the cloud (or removing it with My Diagrams) takes the link down.

Inviting collaborators#

File → Share… (or share in the terminal) invites a specific person by email, as an Editor or a Viewer. They need a Diagravo account with a verified email; if they have none yet, or have not verified it, Diagravo says which, so you can ask them to sign up or to verify. Inviting someone who is already on the list changes their role. Only the diagram’s owner can invite or remove people.

• Editors change the diagram together with you in real time; you can see who else is in it and what they have selected.
• Viewers see changes live but cannot change anything, and terminal commands that edit are refused for them.
• The shared diagram appears in each person’s My Diagrams as “Shared with you”.

Your account and your data#

Click your initial at the top right to open the account window. It is arranged in sections:

• Your name — click the pencil to change it. The small tag next to it is your plan.
• Plan & usage — how many of your 20 cloud diagrams you are using (diagrams shared with you do not count) and how many components a diagram may hold.
• Sign-in & security — whether Google is connected, adding or changing a password (we email you a link), and Signed-in devices, which lists every device your account is signed in on (a browser and system such as “Chrome on Windows”, when it signed in and was last used). Sign out any one of them, or all the others at once; the device you are using stays signed in.
• Personalize — your custom component icons.

Download all my data#

Download builds a zip in your browser containing every diagram — the ones in the cloud and the ones saved only on this device — each as its own .json file you can load again with File → Import, an index of them (with share links), your custom icons, and your profile. Nothing in it is a password or a sign-in token.

Delete your account#

Delete… permanently deletes your account, your cloud diagrams, their share links and your custom icons. People you shared diagrams with lose access and your published links stop working. To be sure it is deliberate, you must type your email address first. Diagrams saved only on your device stay there. It cannot be undone, so download your data first if you want a copy.

Export#

Everything under the Export menu is made in your browser, needs no account, and downloads a file. The same actions are available as export json, export png, export gif, export video and export code in the terminal.

Starter code#

Export → Export Code turns the diagram into a real project scaffold: one file per component, wired together, with the dependency list and a README. It is a starting point for your own project, not a working app — and nothing is generated for things that are not application code.

• Files are generated for: Backend, Database, Object Storage, Cache, Proxy, Queue, API Gateway, Auth/Identity Service, Search Index, Serverless Function, Email Service, SMS/Push Notification, Payment Gateway, Edge Gateway.
• Mentioned in the README instead: clients, load balancers, and the physical, electronic and managed-service components (for example a CDN or a monitoring service), each with a line on why it is not code you would write.
• Illustrative settings such as a cache hit rate or a security flag are named in comments but never baked in as real configuration.
• The files are built on Diagravo’s server from the diagram you send, and nothing is stored. Downloading the .zip is part of the Pro plan.