Repository navigation
A short welcome on the first visit, and What's new after an update - #8
Merged
Merged
Conversation
The first time someone opens Shell:B, a three-screen welcome (always skippable) says what it is and how agents work; its last button leads to the new chat page's own What Shell:B can do section. After an update, the new chat page shows a small What's new card once, built from an optional `news` line on docs/changelog.json entries. Both are remembered on the server (kv "onboarding"), so they don't come back on another device; a guest's cell keeps its own. People who already have chats skip the welcome and see the latest news instead. French for every new string, appended to fr.json. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018go55qk4ihWMhkzn8r7rpK
docs/changelog.json: both sides added an entry at the top; this branch's first, then main's. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018go55qk4ihWMhkzn8r7rpK
EveAeternam
marked this pull request as ready for review
October 13, 2026 03:19
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Requested by Evie · project thread
What changed and why
Before: someone opening Shell:B for the first time landed on a new chat with no introduction, and changes only showed up in Settings → Changelog.
After: on a person's first visit, a three-screen welcome (Skip on every screen) says what Shell:B is, how agents work, and where to start. Its last button, Show me, scrolls to the new chat page's existing What Shell:B can do section instead of repeating it. After an update, the new chat page shows a small What's new card once, with up to three plain sentences and a See all changes link to Settings → Changelog.
How:
server/onboarding.pyservesGET /api/onboardingandPOST /api/onboarding/seenand keeps the state in the kv table, so it is remembered per person on the server and doesn't come back on another device. Each guest cell has its own database, so each guest is remembered separately.docs/changelog.json. An entry gets onto it through a new, optionalnewsline (one plain sentence). Entries without one stay in the Changelog only. I wrotenewslines for the new chat page, the Agent Store, Thalassa, and the French interface.NewChatHomerenders both on desktop and phone, and everyone sees the same UI.newsfield.How you tested it
scripts/check.sh: compile, pyflakes and tsc pass. Two tests fail in the cloud container and also fail onmainthere:/api/modelswith no Ollama, and an unreadable-file backup test that breaks when run as root.docs/changelog.jsont('…')with a French line inui/src/i18n/fr.json. These are appended, not re-sorted. A new test checks that everynewsline has French.New tests in
tests/onboarding_test.pycover the first-run cases, news showing only once, and the welcome counting as having seen the news. I also tried it in Chromium against a scratch server. Finishing the welcome in one browser meant a second browser didn't get it, and the card showed on both desktop and phone widths.Screenshots
Screenshots of the welcome, the card, and the card on a phone are in the project thread.
New dependencies
None.
🤖 Generated with Claude Code
https://claude.ai/code/session_018go55qk4ihWMhkzn8r7rpK
Generated by Claude Code