Clarify first-document creation

[Krzysztof-Cieslak]

Summary

Fixes #148.

• Create in the current or sole writable project, with a dedicated project chooser and access guidance when needed.
• Add an explicit first-document action, pencil tooltips, and visible creating/opening feedback on desktop and compact layouts.
• Keep per-project creation guards through opening, retry existing documents after opening failures, and prevent late responses or competing landing redirects from taking over newer navigation.
• Document the behavior and add browser regression coverage for first use, permissions, retries, overlapping requests, and focus.

Validation

• 39 focused unit tests
• 50 targeted Chromium tests across creation, document navigation, and hosted flows
• Re-ran all 13 creation tests after the final empty-state adjustment
• bun run types
• bun run ci
• Production web build
• CI validation, full browser integration, and container build
• Live preview creation/navigation smoke test (scope and limits below)

Live preview verification

Tested https://153-chopin.githubnext.com at 7a37d629f052a3b5753b96e2e10996e113d23744. The trusted deployment-ready timestamp followed PR creation, with no intervening push.

The restricted browser worker verified the configured dedicated test identity (CHOPIN_PREVIEW_GITHUB_USERNAME) and sole writable sandbox (CHOPIN_PREVIEW_REPOSITORY). Three empty sandbox documents were created within the approved scope.

Passed:

• Empty project displays its explicit first-document action.
• Global New document creates and opens the first document directly.
• The project pencil creates and opens a second document.
• Switching documents and reloading preserve the created documents.
• Global creation works at 390×844; compact sidebar navigation and document controls remain reachable.

No application or interaction failures were observed, and no manual authentication step remains. The browser was restored to desktop size.

Limits: native tooltip display and transient creating/opening feedback were not observed with the restricted browser tools; pixel-level overflow/layout was not verifiable. Multi-project selection and forced delay/failure/race scenarios remain covered by local E2E rather than the single-sandbox live smoke test.

[coolify-githubnext-app]

The preview deployment for chopin is ready. 🟢

Open app | Open Build Logs | Open Application Logs

Last updated at: 2026-09-10 14:47:22 CET