The share sheet
Press Share in the header. It is one column, read top to bottom: who has access, what that access is, and the button that hands the link over. Everything sharing can do is on that one path.
People with access
At the top, a field placed Add people: an email address, a Can edit or Can watch choice, and Invite. Under it are circles for you and everybody in the room, and a + that puts the cursor back in the field.
Inviting by email needs a signed-in account, on any plan, the same as starting a room. What the plan changes is how many people the room holds: you and one other person on Free, and no people limit on Pro, the student price, Teacher and a school's plan. The mail carries the room's standing link for that role, so there is one thing to take back rather than two, and the reply goes to you and not to a noreply address.
Signed out there is nobody to add and nothing to add them to. The sheet says No account needed. Copy the link and the circuit goes with it. and offers Publish with a free account at the foot.
Access level
One row with an icon and a sentence, and the sentence is the state:
- Private: only you can open it. On Pro and the other paid plans you can choose it for any project. On Free the row says (Pro); ones you already made private stay private.
- Link: anyone with the link can open it. It shows on your profile page but not in the gallery, and search engines are asked to leave it out. Like Private, it comes with Pro.
- Gallery: anyone can find it and open it. Where every new project starts, on every plan. It is in the gallery at /projects too. A student's projects in a class and a child's under 13 are always private instead: nobody else can open one by link or find it in the gallery.
- Anyone with the link can watch live.
- Anyone with the link can edit live.
The last two start a live room, and leaving them ends it. A student in a class sees Private alone, with Class projects stay private.: their projects cannot be opened by link or put in the gallery. A child under 13 sees the same row with Projects on this account stay private. One of their projects that was public before opens for nobody else now, whatever it was set to; a teacher still opens work handed in to their class.
If a project anyone can open has a word the filter does not allow, the save still goes through, and the sheet says Only you can open this until the flagged words are removed. The next save without them puts it back where it was. Moving a project into the gallery with such a word is refused. Signed out there is one line rather than a choice: Anyone with the link can open it. The project is saved in the link.
Public and private wait for the server before the row changes: what you read is what the account says, not what was clicked. A level that could not be reached puts the row back where it was and says why underneath.
While a live level is on, a small New link sits under the row. See watch links and edit links.
Somebody who joined a room they did not open gets their own state there instead: You are watching this live, with Ask to edit and Leave the room.
Copy link
One full-width button. It says Copied for two seconds. Under it, Show link opens the link itself if you would rather read it or select it by hand.
The link the button hands over is the one for the level the row is on, so a watch link and an edit link are never mixed up.
What the link carries
Signed out, the link carries the whole project inside its own fragment. Nothing is uploaded; the link is the document. It works, and it can be long.
Signed in, the link points at the project on your account, at /p/<id>.
Opening someone else's project
It opens in the editor and runs, with no sign-up. The editor is read-only for
it, and pressing Save forks it into a project of your own. The fork is named
by the server, which adds (fork) to the original's name, and the heart count
on the original stays with the original.
When a friend opens your link
Every link you share carries your invite code (see Invites). Somebody who opens it without an account sees one card first: Ada shared Traffic light with you, with a picture of the circuit (or the live room behind it), and two buttons.
- Sign up and claim makes an account and comes straight back to your project: into the room, with the pen, for an edit link.
- Open it without an account opens it as it is. It is there for a watch link and a public project; an edit link needs an account to edit.
While you can still be rewarded for a friend, the card also says Ada is giving you a free week of Pro. Claim it by signing up. and, in one line, what it takes: Confirm your email and save a circuit with at least one part on two different days, and you both get 7 days of Pro. Once five friends have been rewarded for you, the card shows your project without the offer. Somebody already signed in never sees the card, and nor does anybody opening a class's or a student's link.
Shared with you
Projects other people shared with you are under Shared with you on your account's Projects tab: an edit or watch link you opened while signed in, an invite emailed to your address (also one sent before you had an account, once you confirm that address), and projects whose owner marked you a collaborator. Each row says who owns it, Can edit or Can watch, and when you last opened it, and Open takes you back into its live room.
When the owner takes the access back (a new link, an invite taken back, the mark removed, the room ended), the row goes. Hide takes a row off for good. Only you see this list; the owner's controls are the same as before.
Embed and Clip
Two quiet rows sit at the foot of the sheet.
- Embed puts the circuit, running, on another website, with the code to paste. It needs a signed-in account and a saved project that anyone with the link can open; on a private project the row offers to open it up first. Embedding a circuit has the options.
- Clip makes 5 seconds of the running circuit as a GIF or a video, with the project's link beside it, to download or send. It shows while the circuit runs, and the clip is made in your browser.
Pictures, code and other files are under Export, next to Share: see export and download.
Keeping a copy as a file
Any project can be saved to a file and opened again later, on any machine, with no account: Download JSON in the Save menu writes it, and Open JSON or SPICE… opens it. That is deliberate: a portfolio should not depend on us still being here in five years.