Recovery and save nudges

#When it happens

A player's name, scores and rank live under a hidden id on the phone. A cleared browser or a new phone would lose them, so every player gets a short code the moment they exist, made in the background, and the app asks them to save it at the moments when there's something worth keeping.

#Composition

#The code

Six characters in two groups of three, written K7P-RX4, drawn from 20 letters and 5 digits (ACDEFGHJKMNPQRTUVWXY34679). Everything a child could misread is left out: 0 and O, 1, I and L, 2 and Z, 5 and S, 8 and B. A code has at least two digits and never four letters in a row, so it can't spell a word, and one that trips the name filter is drawn again. That leaves about 240 million codes. In Firebase, rc/CODE holds { id, name, at } (create-only, and the node can't be listed), rcu/id holds the code and rcs/id marks it saved. The old long code (word-word-id) still restores forever, and the sheet shows it if a short code can't be made.

#The parts

#Flow

No recovery screens have been captured yet; the specimens above use the shipping CSS.

Saving the code

1. Open it. Tap the key on Home, or meet it in Keep your spot. The sheet is titled "Your code" and says what it's for: it brings back your name and scores if this phone forgets you, and lets you play as you on another phone.
2. Copy it, by tapping the tiles. "Copied" replaces "Tap to copy" for 1.8s. Copying alone doesn't count as saved.
3. Save it, to Photos or Notes. Either opens the phone's share sheet. A finished share counts as saved; Cancel changes nothing.
4. Done. Once both are saved the link reads "Done". "Saved" is stored on the account, so the nudges stay gone after a restore or on a new phone.

Getting back in

1. Find the way in. "I already have a code" in the sheet, I have a code on Played before?, or a ?code= link, which opens with the code filled in. Each one means you've played, so the tutorial doesn't open, then or after the switch.
2. Type or paste the code. The next empty tile shows a caret; autofill works. Paste reads what you copied (iPhone asks first) and takes the code out of it: the code alone, "acd 347", or the whole saved note with its link. Pasting into the tiles does the same. A long code pasted in switches to the older field on its own.
3. Find my account. It stays tappable throughout. Tapped early, it focuses the tiles and, if anything is typed, says "Your code has six characters."
4. Is this you? The name the code belongs to, in tiles, with a warning when this phone already has a player of its own. Saving this phone's code first is offered, never forced.
5. Yes, that's me. The phone switches to that player and reloads; Home says "Welcome back, NAME", and today's cards come back with their boards. The tutorial stays closed.

#Save paths and their fallbacks

#The nudges

#States

#Why it's built this way

#Known issues and gaps

• "Copied" lasts 1.8s, not two seconds. The 3.21.0 changelog says two seconds; the spec and the code (1800ms) say 1.8. The code wins.
• The saved picture is always dark. The Photos picture is drawn with the dark values written in (#202845, #F2F0EA), whichever mode the player uses.
• No captures. screens/ has no recovery, nudge or Played before? screens.

#Related

• Home and Compete: where every nudge appears
• Tile: why a code is shown as tiles
• Celebration: the moment map that sizes these moments
• Update reel: the other ask that shares the one per visit
• Color: --danger for a code that isn't found

#Changelog