Skip to content

feat(ios): open on a setup screen, then keep setup in Settings - #236

Merged
alexkroman merged 6 commits into
jhe/ios-statsfrom
jhe/ios-first-run
Oct 15, 2026
Merged

feat(ios): open on a setup screen, then keep setup in Settings#236
alexkroman merged 6 commits into
jhe/ios-statsfrom
jhe/ios-first-run

Conversation

@he-james

@he-james he-james commented Oct 2, 2026

Copy link
Copy Markdown
Contributor

What & why

Setup moves to the first screen, and into Settings once it's done, matching the blurt-ios prototype.

  • First-run screen: shown in place of the tabs until Blurt is set up. It has the wordmark, a serif headline, and the three numbered steps in a card.
    • The API key is pasted inline: a secure field, Continue, Get a free key, and a line on where the key and the audio go.
    • The microphone and keyboard steps follow.
    • Without a key the screen can't be left. With one, Start dictating goes to the tabs, and the other two steps can wait.
    • Anyone already set up skips the screen entirely.
  • Dictate tab: no longer shows the setup card.
  • Settings › Setup: keeps the steps. When everything is done they're hidden by default, behind "Blurt is set up ✓ · Show steps". When anything is missing they're open.
  • Code: the routing rule is SetupProgress in BlurtiOSCore, and it's tested. The setup card became the reusable SetupSteps. A debug-only -BlurtNoKey flag shows a fresh install's screen with an in-memory key store, without touching the Keychain.

iPhone only. Stacked on #234.

How it was tested

  • scripts/ios-check.sh: 146 tests (routing is new), BlurtiOSCore 97.0%, analyze, periphery and the probe build all pass.

  • design-sync.sh --check, check-invariants.sh and swiftlint --strict are clean.

  • Simulator:

    • The first-run screen with no key. Stacking the two key buttons stopped "Get a free key" wrapping.
    • Settings › Setup folded when everything is done, and expanded.
    • The app goes straight to the tabs for an existing setup.

  • scripts/check.sh passes (or CI will, if I'm not on a Mac)

  • I read AGENTS.md and this doesn't reintroduce anything deliberately removed

  • Docs updated if behavior changed

🤖 Generated with Claude Code

he-james and others added 5 commits October 2, 2026 18:15
@he-james @claude
feat(ios): add the easter egg
44a2676 
A quiet "How fast can you type?" link at the foot of Settings opens a
30-second sprint over common words, ported from the blurt-ios
prototype: the clock starts on the first key, turns orange and thumps
through the last five seconds, and the result shows WPM, a rank,
accuracy, the best, and how talking at 150 wpm compares.

The latest result becomes the typing speed time saved is measured
against, in place of the 36 wpm phone average, with a "Reset to
average" link beside it. Scoring and the speed live in BlurtiOSCore
(TypingTest, TypingSpeed) and are tested.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@he-james @claude
fix(ios): present the Easter Egg once from Settings
da9969d 
The cover and the reset confirmation were attached to their sections,
and a section's modifiers apply to each of its rows, so the About
section's five rows each tried to present the Easter Egg at once. Both
now hang off the form.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@he-james @claude
feat(ios): open on a setup screen, then keep setup in Settings
80f0046 
As in the blurt-ios prototype, a first-run screen replaces the tabs
until Blurt is set up: the wordmark, a headline, and the numbered steps
in a card, with the API key pasted inline (Continue, Get a free key,
where the key and the audio go). Without a key it can't be left; with
one, Start dictating goes to the tabs and the microphone and keyboard
can wait. Whoever was already set up skips it.

The setup card leaves the Dictate tab. Settings › Setup keeps the
steps, hidden behind "Blurt is set up ✓ · Show steps" once everything
is done and open while anything isn't.

The rule is SetupProgress (BlurtiOSCore, tested); -BlurtNoKey shows a
fresh install's screen in debug builds without touching the Keychain.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@he-james @claude
Merge jhe/ios-stats into jhe/ios-easter-egg
cf59676 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@he-james @claude
Merge jhe/ios-easter-egg into jhe/ios-first-run
64bd0a1 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@nbisht-aai
nbisht-aai marked this pull request as ready for review October 14, 2026 21:07
Base automatically changed from jhe/ios-easter-egg to jhe/ios-stats October 15, 2026 00:04
@alexkroman
alexkroman merged commit 5f7ee3a into jhe/ios-stats Oct 15, 2026
1 check passed
@alexkroman
alexkroman deleted the jhe/ios-first-run branch October 15, 2026 00:16
alexkroman pushed a commit that referenced this pull request Oct 15, 2026
@claude
Merge jhe/blurt-design into jhe/ios-stats
afe7a68 
Conflicts were all the iPhone app's own newer work beside the base's older
copy; kept this branch's side throughout: the stats and typing-test tokens
(tokens.json, DesignTokens.swift, DESIGN.md), RootView and SetupView in place
of the home SetupCard (#236), and the stats/typing state in Settings. The
base's engine changes (inputSilent, the latch key action) and project.yml
came through without conflict.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Tys59LNGo4prHRnc8w28Xy
alexkroman pushed a commit that referenced this pull request Oct 15, 2026
@he-james @claude
feat(ios): show lifetime dictation stats (#233)
6117e24 
* refactor(sdk): move key terms and text shortcuts into the AssemblyAI SDK

KeyTerms (parse a comma-separated list, fit it to keyterms_prompt's
caps; was KeytermsBoost plus KeyTermsStore.parse) and TextShortcut with
its on-device TextShortcutExpander now live in Sources/AssemblyAI, so
any app on the SDK gets them. BlurtEngine keeps Blurt's storage:
KeyTermsStore and TextShortcutStore, their UserDefaults keys and limits.

The iPhone's duplicate KeyTermList is replaced by KeyTerms. The Mac app
only gains an import; its behaviour and stored data are unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* feat(ios): add a Words tab for key terms and text shortcuts

The app gets Dictate and Words tabs under a brand tab bar, as in the
blurt-ios prototype. MainView owns what works on either tab: Settings
from each tab's gear, the consent sheet and shared key-term lists.

Words, on the AssemblyAI SDK's KeyTerms and TextShortcut:
- Key terms as pills with an inline add field (commas add several,
  duplicates drop, capped at the request's 100), the contact-name
  count, and Share. They move here from Settings.
- Text shortcuts with an inline "When I say / Type this" form;
  re-adding a phrase replaces it. Expanded on the phone, never sent.

BlurtDesign gains BrandTabBar, FlowLayout, brandInput() and
brandFootnote(), and brand buttons fade while disabled.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* feat(ios): show lifetime dictation stats

A stats card at the top of the Dictate tab, as in the blurt-ios
prototype: dictations, words, and time saved against the 36 wpm phone
typing average, as serif numbers with mono units. Time saved shows in
full and moves to its own row past an hour; every value takes the
largest of four sizes that fits.

Every dictation counts, from the app or the keyboard. The coordinator
times the recording phase and records on the main actor when the
dictation's terminal phase renders, so the spoken time is the right
one and a reset can't race a record. Totals stay on the phone
(DictationStats, BlurtiOSCore); Settings › Data resets them.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* style(sdk): keep KeyTerms.join's doc comment on its declaration

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(ios): drop the Words tab pointer from Settings

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* feat(ios): add the Easter Egg (#234)

* feat(ios): add the easter egg

A quiet "How fast can you type?" link at the foot of Settings opens a
30-second sprint over common words, ported from the blurt-ios
prototype: the clock starts on the first key, turns orange and thumps
through the last five seconds, and the result shows WPM, a rank,
accuracy, the best, and how talking at 150 wpm compares.

The latest result becomes the typing speed time saved is measured
against, in place of the 36 wpm phone average, with a "Reset to
average" link beside it. Scoring and the speed live in BlurtiOSCore
(TypingTest, TypingSpeed) and are tested.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(ios): present the Easter Egg once from Settings

The cover and the reset confirmation were attached to their sections,
and a section's modifiers apply to each of its rows, so the About
section's five rows each tried to present the Easter Egg at once. Both
now hang off the form.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* feat(ios): add a Words tab for key terms and text shortcuts (#232)

* feat(ios): add a Words tab for key terms and text shortcuts

The app gets Dictate and Words tabs under a brand tab bar, as in the
blurt-ios prototype. MainView owns what works on either tab: Settings
from each tab's gear, the consent sheet and shared key-term lists.

Words, on the AssemblyAI SDK's KeyTerms and TextShortcut:
- Key terms as pills with an inline add field (commas add several,
  duplicates drop, capped at the request's 100), the contact-name
  count, and Share. They move here from Settings.
- Text shortcuts with an inline "When I say / Type this" form;
  re-adding a phrase replaces it. Expanded on the phone, never sent.

BlurtDesign gains BrandTabBar, FlowLayout, brandInput() and
brandFootnote(), and brand buttons fade while disabled.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(ios): drop the Words tab pointer from Settings

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* feat(ios): open on a setup screen, then keep setup in Settings (#236)

* feat(ios): add the easter egg

A quiet "How fast can you type?" link at the foot of Settings opens a
30-second sprint over common words, ported from the blurt-ios
prototype: the clock starts on the first key, turns orange and thumps
through the last five seconds, and the result shows WPM, a rank,
accuracy, the best, and how talking at 150 wpm compares.

The latest result becomes the typing speed time saved is measured
against, in place of the 36 wpm phone average, with a "Reset to
average" link beside it. Scoring and the speed live in BlurtiOSCore
(TypingTest, TypingSpeed) and are tested.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(ios): present the Easter Egg once from Settings

The cover and the reset confirmation were attached to their sections,
and a section's modifiers apply to each of its rows, so the About
section's five rows each tried to present the Easter Egg at once. Both
now hang off the form.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* feat(ios): open on a setup screen, then keep setup in Settings

As in the blurt-ios prototype, a first-run screen replaces the tabs
until Blurt is set up: the wordmark, a headline, and the numbered steps
in a card, with the API key pasted inline (Continue, Get a free key,
where the key and the audio go). Without a key it can't be left; with
one, Start dictating goes to the tabs and the microphone and keyboard
can wait. Whoever was already set up skips it.

The setup card leaves the Dictate tab. Settings › Setup keeps the
steps, hidden behind "Blurt is set up ✓ · Show steps" once everything
is done and open while anything isn't.

The rule is SetupProgress (BlurtiOSCore, tested); -BlurtNoKey shows a
fresh install's screen in debug builds without touching the Keychain.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@he-james @alexkroman @claude