Skip to content

feat(landing): docs page + restructured download + demo fix + windows test unflake#32

Merged
GuilhermeVozniak merged 1 commit into
mainfrom
fix/website-and-ci-flake
May 21, 2026
Merged

feat(landing): docs page + restructured download + demo fix + windows test unflake#32
GuilhermeVozniak merged 1 commit into
mainfrom
fix/website-and-ci-flake

Conversation

@GuilhermeVozniak
Copy link
Copy Markdown
Collaborator

@GuilhermeVozniak GuilhermeVozniak commented May 21, 2026

Summary

Rebased onto current main (was conflicting with PR #29 which already shipped real provider logos — my earlier monogram placeholders were dropped during the rebase since the real assets supersede them). Squashed to one commit for a tidier diff.

Docs

  • New /docs page — single-page documentation covering quick start, per-OS install (macOS, Windows, Linux), provider configuration, hotkeys, privacy summary, troubleshooting. Sticky on-page TOC. Cross-links to the deeper /docs/*.md files on GitHub for the long form. Scoped .prose-docs styles in globals.css.
  • Docs link added to header + footer nav.

Download section

  • Whole-card anchor is gone. Download is now a discrete button; each card also exposes a Setup guide → link that deep-links to /docs/#install-<os>. Two distinct actions for the user (and for screen readers).
  • Linux subtitle no longer points at a non-existent /install-linux page. The section header now points at /docs/ as the canonical guide.
  • Coming-soon cards still expose the Setup guide so visitors on platforms without binaries can read the install steps.

Landing — empty Demo section

/demo.gif was a 43-byte stub that rendered as a broken image. Swapped the <Image> for a self-contained CSS/SVG mockup of the dictation flow.

CI — Windows-only flake

MainWindow.test.tsx → "switches to the Settings panel when its tab is clicked" was timing out at the 5s default on windows-latest (settled in ~6.4s). Bumped per-test timeout to 15s and switched to findByTestId.

Test plan

  • bun --cwd packages/landing test:unit passes (35/35)
  • bun --cwd packages/landing run build/docs exports cleanly as a static route
  • bun --cwd packages/desktop test passes (475/475)
  • bun run lint clean
  • bun --cwd packages/landing typecheck clean
  • Manual QA — /docs reads well in light + dark; Download buttons + Setup guide links land on the right anchors
  • CI green on Test desktop / windows-latest + Test landing

🧙 Built with WOZCODE

@GuilhermeVozniak GuilhermeVozniak changed the title fix(landing,ci): rebrand placeholder logos, replace broken demo, unflake windows test feat(landing,ci): docs page, restructured download, rebranded logos, fixed demo, unflaked windows test May 21, 2026
…indows test unflake

- New /docs page covering quick start, per-OS install (macOS/Windows/Linux),
  provider configuration, hotkeys, privacy, and troubleshooting. Sticky TOC.
  Scoped .prose-docs styles in globals.css. Header + footer nav updated.

- Restructured the Download section so the whole platform card is no longer
  a single anchor — Download is a discrete button + each card surfaces a
  "Setup guide →" link that deep-links into /docs/#install-<os>. Coming-soon
  cards still expose the setup guide. Linux subtitle no longer points at a
  nonexistent /install-linux page.

- Replaced the broken demo section (/demo.gif was a 43-byte stub) with a
  self-contained CSS/SVG mockup of the dictation flow. home-sections test
  asserts on the accessible region.

- Bumped the MainWindow > "switches to Settings panel" test timeout from
  the 5s default to 15s and switched to findByTestId. The test was settling
  in ~6.4s on windows-latest (Radix Tabs + 7 settings sub-components is heavy)
  and flaking CI on every PR.

Co-Authored-By: WOZCODE <contact@withwoz.com>
@GuilhermeVozniak GuilhermeVozniak force-pushed the fix/website-and-ci-flake branch from e7e67f3 to d505ec8 Compare May 21, 2026 20:02
@github-actions
Copy link
Copy Markdown

Landing preview will be available at https://bluemacaw.com/previews/pr-32/ once AWS infra lands (Plan D).

@GuilhermeVozniak GuilhermeVozniak changed the title feat(landing,ci): docs page, restructured download, rebranded logos, fixed demo, unflaked windows test feat(landing): docs page + restructured download + demo fix + windows test unflake May 21, 2026
@GuilhermeVozniak GuilhermeVozniak merged commit cc44bf4 into main May 21, 2026
9 checks passed
@GuilhermeVozniak GuilhermeVozniak deleted the fix/website-and-ci-flake branch May 21, 2026 21:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant