githubnext/chopinPublic

Let's compose rich plans together

Guide first run and empty Chat #384

MergedMaggieAppletonmerged 7 commits intomainfromrefs/pull/384/head
  1. MA

    ## Why A new user needed clearer guidance around the first repository choice, and a user whose GitHub App sees no repositories hit a dead end with only a small footer link. An empty Chat gave no hint about `@chopin` or `#`.

    ## What changed - The Add project palette opens automatically on first run when there are no projects. The underlying empty workspace says "No document open" and offers **Add project** to reopen it. - The palette shows an empty state with a primary **Install the GitHub App for Chopin** button (`/auth/github/install`) when no repositories are installed. - After the first add, a project with no documents stays on the empty workspace with a primary **New document**. - Empty Chat shows a quiet centred hint (icon plus text, visible) teaching `@chopin` and `#`. It fades out with the first entry (opacity, `--duration-fast`, no transition under reduced motion) and is hidden for read-only and archived viewers. Copy adapts when the Planner or references are unavailable. - E2E specs cover the first-run auto-open and the explicit Add project action in later empty states.

    Note: the redirect from `/` to the last or first accessible document is intentional landing behaviour (`landingDocument`, unit-tested), so I kept it. Adding a project that already has documents still lands in one; a project with none stays on the empty workspace.

    ## Screenshots

    Before: ![before empty](https://github.com/user-attachments/assets/b10967ad-4696-49e3-8da5-78f736d9c18b) ![before palette](https://github.com/user-attachments/assets/51504dc8-0236-45a0-bfa3-4d82b7f62084) After add: ![after add](https://github.com/user-attachments/assets/bbbb6b9f-34de-42b5-bf3c-db7dfd7901bb) Empty Chat (Planner off in the fake server, so the `@chopin` sentence is omitted): ![chat](https://github.com/user-attachments/assets/6b88ee5e-4757-44a8-a7d1-e4aa657c5ddd) ![chat phone](https://github.com/user-attachments/assets/e74b88da-1798-42a4-9a09-194dfa6a5d53)

    ## Verification

    - Seven commits retain the first-run behavior and #382 focus integration; the last two renew reviewed source hashes after excluding unrelated non-author PRs. - Focused navigation and Chat tests: 43 passed. `bun run fix`, `bun run ci`, `bun run types`, and `bun run build` passed. - The reviewed design hashes are renewed. Fresh GitHub CI must run after the prepared head is published. - Initial JavaScript: 251,414 B raw / 79,339 B gzip, within budget.

    🤖 Generated with [Claude Code](https://claude.com/claude-code)

  2. MaggieAppletonhead-ref-force-pushed 597ecdb6f5c3last month on GitHub

  3. MA
    Author

    @copilot "Removed the auto-open of the Add project palette. The empty workspace now reads "Start with a repository" with a primary Add project and a ghost "Manage repository access" link." undo this change. Now, with this change the user has to do an extra click. They have to click "Add project" to pick a repo to begin, versus just having the repositories there to pick from. So that's a much worse change. But sure—I like the empty chat having a placeholder saying it's where they can talk with their collaborators. You can keep that piece.

  4. Copilotbotmentionedlast month on GitHub

  5. Copilotbotsubscribedlast month on GitHub

  6. MaggieAppletoncopilot-work-startedlast month on GitHub

  7. > @copilot "Removed the auto-open of the Add project palette. The empty workspace now reads "Start with a repository" with a primary Add project and a ghost "Manage repository access" link." undo this c...

    Restored the automatic repository picker and original empty workspace in f84a6a4, so first-time users can select a repository without an extra click. Kept the empty Chat placeholder. Type checks, CI checks, 529 web unit tests, and 33 targeted browser tests passed.

  8. Copilotbotmentionedlast month on GitHub

  9. Copilotbotsubscribedlast month on GitHub

  10. MaggieAppletoncopilot-work-finishedlast month on GitHub

  11. MaggieAppletonhead-ref-force-pushed f74d6f82f8d1last month on GitHub

  12. MaggieAppletonmerged 3070c24b81e3last month on GitHub

  13. MaggieAppletonclosedlast month on GitHub

  14. MaggieAppletonhead-ref-deletedlast month on GitHub