Repository navigation
Stage J4-b: first-run game cards, getting-started tips and a hideable search box - #110
Merged
Merged
Conversation
A first install now marks the dashboard's getting-started tips as pending (new beta-shell.json field GettingStartedTipsPending). They are handed to the dashboard once the startup dialogs are closed and stay pending until closed or finished, so closing the app keeps them. Configs from before have no such field, so upgrades never see them. The tour's steps and rules are in Core (GettingStartedTips) with unit tests. The first-install check, the system language, the chosen game's repository fields and "Set up later" are unchanged. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The first-run dialog shows each game as a card, two to a row, and a note on what comes next. On the dashboard one TeachingTip points at New repository, the paths and Open Mod management in turn ("Step 1 of 3", Skip tips, Next/Done). It takes the keyboard focus and announces the step for Narrator; Esc, Skip tips, its close button or Done close it for good.
UI test: the tips come back after a restart until Esc closes them, then stay closed. The screenshot script gains the gettingstarted page.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- A first install counts the current feature set as seen (WhatsNewPolicy, with unit tests), so the tips come straight after the game; upgrades still see "what's new" once.
- Narrator reads each tip through the language file's GettingStarted.Announcement format ("{0}。{1}" in Chinese) instead of a fixed ". ".
- Step 1 of the tips opens below the New repository button (BottomLeft), so it no longer covers the title bar's search box.
- Settings > Appearance and language gains "Show the search box in the title bar" (on by default, saved as ShowTitleBarSearch; older configs count as on). Ctrl+K opens the palette either way.
UI tests: the first-install test now checks that no what's-new dialog appears; a new test turns the search box off, opens the palette with Ctrl+K and checks it stays hidden after a restart. The screenshot script gains the nosearch page.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This was referenced Nov 9, 2026
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.
Summary
Stage J4-b of the Fluent design plan (
docs/development/UI-Fluent-Design-Plan.md, "仪表盘(J4)"), plus follow-ups from the maintainer's review.6d3439b: remembers the getting-started tips after a first install. The rule is inCore/Configuration/GettingStartedTips.cs, with unit tests.GettingStartedTipsPendinginbeta-shell.json; older settings files don't have the field, so upgrading users never see them.d71973b: the first-run dialog shows each game as a card, two per row, with a note on what comes next (set the paths, then open Mod management).TeachingTipon the Dashboard points in turn at New repository, the paths and Open Mod management, with "Step 1 of 3", Skip tips and Next/Done.961d04d: review follow-ups.WhatsNewPolicy, with unit tests), so the tips come straight after the game choice. Upgrading users still see the dialog once.GettingStarted.Announcement({0}。{1}in Chinese).ShowTitleBarSearch(older settings count as on). Ctrl+K still opens the command palette when the box is hidden.PreferredPlacement="BottomLeft").Unchanged: how a first install is detected, the language following Windows, the fields saved for the chosen game, and "Set up later" leaving the repository without a game.
Not done: the plan's in-page "Getting started" card with a check mark per step. Ticking steps would need new rules for what counts as "paths set" and "Mods imported"; the tips point at those places instead. The reasoning is in the J4-b section of the plan.
Test plan
scripts\test-all.ps1: 1,688 Core tests (new ones for the tips and what's-new rules), Release build 0 warnings, coverage threshold unchanged-Application). New tests:🤖 Generated with Claude Code