Skip to content

Redesign codexbar.app landing page#1784

Merged
steipete merged 72 commits into
steipete:mainfrom
vyctorbrzezowski:feat/landing-redesign
Jul 3, 2026
Merged

Redesign codexbar.app landing page#1784
steipete merged 72 commits into
steipete:mainfrom
vyctorbrzezowski:feat/landing-redesign

Conversation

@vyctorbrzezowski

@vyctorbrzezowski vyctorbrzezowski commented Jun 29, 2026

Copy link
Copy Markdown
Contributor

Updated preview: https://codexbar-redesign-preview.vercel.app

Screenshots: full gallery

Summary

  • Full visual revamp of the codexbar.app landing: hero with SVG MacBook mockup + live HUD (menubar, popover, meters, chart), responsive mobile/tablet/desktop layouts, feature cards, widgets gallery, CLI section, and 21-locale i18n via site-locales.mjs.
  • Extracted redesign into docs/site.css and docs/site.js; docs/index.html is now markup-only (~780 lines).
  • Baked geometry tunes for desktop (1920), tablet (1001), and mobile (490) with a resize applicator for mockup X and tablet stage height.
  • Hero copy animations (staggered reveal + HUD entrance sequence); MacBook frame renders instantly (no fade).
  • Feature screenshots compressed to WebP (~16 MB → ~800 KB).
  • Cleanup: removed dev tuner, dropped unused raster hero assets and duplicate openclaw.svg; canonical mockup is hero-mockup.svg (notchless MacBook Air frame, same 6111×3239 artboard).

Visual QA

Desktop / main sections

Hero (EN) — headline, download/brew CTAs, menu-bar HUD mock desktop hero EN
Providers (EN) — “53 providers, one menu bar” grid desktop providers EN
Features (EN) — resets, credits/spend, status/incidents desktop features EN
CLI (EN) — terminal output + bundled binary copy desktop CLI EN
Widgets (EN) — WidgetKit gallery mock desktop widgets EN
More + footer (EN) — install, CLI, privacy, permissions desktop footer/more EN

Locales

Hero (PT-BR) hero PT
Hero (KO) hero KO
Hero (DE) hero DE desktop
Hero (CA, narrow) hero CA narrow

Responsive viewports

Hero (DE, narrow/tablet) hero DE narrow
Hero (DE, narrow focused) hero DE focused
Hero (DE, mobile) mobile hero DE
Hero (EN, mobile) mobile hero EN
Providers (EN, mobile) mobile providers EN
Features (EN, mobile) mobile features EN

Review notes

  • Geometry constants are baked in :root CSS vars + applyHeroDesktopLayout(); tuned values are documented in site.js / site.css.
  • Scripts/check-site-locales.mjs validates locale parity and provider logo assets.

Test plan

  • Desktop 1440/1920: hero overlay, HUD alignment, providers grid, features, widgets, CLI, footer
  • Tablet ~1001px: MacBook right margin, hero copy padding, popover position
  • Mobile ≤768: stacked hero, full-bleed stage, right-anchored MacBook, brew pill, header controls
  • Dark + light theme toggle
  • Spot-check locales: en, pt-BR, pl, ar (RTL)
  • node Scripts/check-site-locales.mjs

Maintainer validation (2026-07-01)

Validated on head 4c41840e76d24753fdc61b6a0e67ac025735b507 after rebasing the proposal onto current main and addressing review findings.

Changes made during review

  • Replaced the runtime Tailwind CDN with a pinned, reproducible local CSS build.
  • Restored all current provider cards, documentation links, and provider-specific auth labels.
  • Added keyboard-accessible language selection, persistent theme/language preferences, visible focus states, copy-button feedback, RTL support, and screen-reader labels.
  • Corrected stale provider/model copy and anonymized example account data.
  • Fixed reveal thresholds so tall mobile sections cannot remain permanently hidden.
  • Extended site validation to reject runtime CDN use and require local styles/provider navigation.

Proof

  • make check — pass (SwiftFormat, SwiftLint strict, locale/site checks)
  • make test — pass (43/43 shards)
  • node Scripts/check-site-locales.mjs — pass (21 locales, 139 messages)
  • node --check docs/site.js — pass
  • ./Scripts/build-site-css.sh — pass and reproducible
  • Branch autoreview — clean, no accepted/actionable findings
  • Existing-Chrome local QA — desktop dark/light, mobile, Arabic RTL, all deferred sections, 37 provider links, copy/theme/language interactions, zero console errors, no horizontal overflow

Follow-up preview polish (2026-07-02)

Follow-up commit 6692ab9365df7e30b9ba5736f37e0e552206d325 keeps the preview-only landing polish scoped to four docs files:

  • Prevented first-paint flashes in the hero mockup: raster menubar icons now start with the intended light filter, the MacBook mockup has a CSS fallback for its JS-computed X offset, and the theme toggle icon follows the early data-theme-preference value from the inline head script.
  • Restored lowercase download copy for the header CTA in English and pt-BR.
  • Fixed mobile provider cards after provider links were restored, so linked cards stack icon/text cleanly instead of squeezing labels into per-letter columns.
  • Tightened the hero entrance timing so the menubar, CodexBar mark, popover, meters, and chart read as one overlapping cascade instead of separate delayed beats.

Proof for this follow-up:

  • git diff --check — pass
  • node --check docs/site.js — pass
  • node Scripts/check-site-locales.mjs — pass
  • make check — pass; existing locale coverage warnings only
  • Local browser QA at ?lang=en&theme=dark: desktop hero timing/state, dark theme icon first state, lowercase download label, mobile provider grid, zero console errors
  • Stable preview redeployed: https://codexbar-redesign-preview.vercel.app

Landing decision

Mechanically ready, but held for owner design approval. This is a broad brand/landing-page direction change and introduces a generated CSS build step; VISION.md requires signoff for that scope. Recommendation: approve the visual direction and local Tailwind build, then land this exact head once CI is green.

Refresh docs/index.html with the new dark landing layout, coordinated hero animations, features/technical sections, language picker shell, and lossless hero mockup assets for GitHub Pages.
Introduce a shared section-inner max-width wrapper and hero title line spans so the headline stays readable at wide breakpoints.
Replace the stacked feature list with a responsive card grid, red image placeholders, and a focused three-item layout without CLI/widgets copy.
Introduce a terminal output mock on the left with CodexBar on CLI copy on the right, including bundled binary messaging and session privacy footnote.
Recreate the macOS widget picker on the right with copy on the left, using red placeholders for small, medium, and large widget previews.
Add eleven transparent widget crops for the landing page macOS gallery mock.
Replace red placeholders with widget PNGs, group them in scrollable rows, and keep the gallery viewport height fixed.
Match the shield icon to CodexBar blue instead of muted gray.
Replace the tan usage bar fill with CodexBar blue across the terminal mock.
Stretch each card and pin the image placeholders to a shared baseline so differing copy lengths no longer throw off the row.
Replace the hollow shield outline with a tinted shield and checkmark that reads better at small size.
Let the gallery fill mac-widget-main without growing the sheet, and add a bottom scroll fade so more widgets read as discoverable.
Group each card title and body so they sit on a shared baseline with consistent spacing before the image row.
Lock mac-widget-sheet__body to a fixed viewport instead of growing with all rows, and tighten row spacing so content scrolls within the fade.
Use the correct titles and descriptions for all eleven widgets and order rows History, Burn Down, Usage, then Switcher.
On desktop split layouts with copy on the left, align text to the right so it faces the widget sheet.
Pull the scroll layer out of mac-widget-main side padding so the fade spans the full column while title and tiles keep their inset.
Drop aspect-ratio boxes that added uneven gaps and use a fixed margin below each preview before the title.
Only show the bottom fade while more content is below the fold and remove it when the gallery is fully scrolled or not overflowing.
Crop PNG halos with a slight scale inside rounded clips and a dark preview background until assets can be re-exported.
Revert the unintended 1–11 sequence reorder and keep the original Metric/History, Usage, Switcher, Burn Down grouping with updated labels.
Inset the bottom fade from the right so it no longer covers the scrollbar track.
Use text-wrap balance and tighten the Home Screen line break so desktop is not left alone.
Add resets, credits, and status screenshots for the three feature cards.
Replace red placeholders with the new feature screenshots using cover fit inside the 4:3 frames.
Remove forced line breaks and nowrap the Know before you commit title.
Use the new resets screenshot for card one and move the misty landscape asset to the status card.
@clawsweeper clawsweeper Bot added the proof: 📸 screenshot Contributor real behavior proof includes screenshot evidence. label Jun 29, 2026
@vyctorbrzezowski vyctorbrzezowski marked this pull request as ready for review June 29, 2026 12:46
@clawsweeper clawsweeper Bot added rating: 🦪 silver shellfish Thin PR readiness signal; proof, validation, or implementation needs work. merge-risk: 🚨 other 🚨 Merging this PR has meaningful risk outside the owned taxonomy. and removed rating: 🧂 unranked krab Not merge-ready due to missing proof or serious correctness/safety concerns. merge-risk: 🚨 security-boundary 🚨 Merging this PR could weaken sandboxing, authorization, credentials, or sensitive data. merge-risk: 🚨 availability 🚨 Merging this PR could cause crashes, hangs, restart loops, stalls, or process outages. labels Jul 1, 2026
@clawsweeper clawsweeper Bot added proof: sufficient Contributor real behavior proof is sufficient. rating: 🐚 platinum hermit Good normal PR readiness with ordinary maintainer review expected. status: 👀 ready for maintainer look ClawSweeper has no concrete contributor-facing blocker left for this PR. and removed proof: 📸 screenshot Contributor real behavior proof includes screenshot evidence. rating: 🦪 silver shellfish Thin PR readiness signal; proof, validation, or implementation needs work. status: 📣 needs proof The PR needs real behavior proof before ClawSweeper can clear the contributor ask. labels Jul 2, 2026
@clawsweeper clawsweeper Bot added rating: 🦐 gold shrimp Decent PR readiness signal, but merge confidence is limited. status: 📣 needs proof The PR needs real behavior proof before ClawSweeper can clear the contributor ask. merge-risk: 🚨 other 🚨 Merging this PR has meaningful risk outside the owned taxonomy. and removed proof: sufficient Contributor real behavior proof is sufficient. status: 👀 ready for maintainer look ClawSweeper has no concrete contributor-facing blocker left for this PR. rating: 🐚 platinum hermit Good normal PR readiness with ordinary maintainer review expected. merge-risk: 🚨 other 🚨 Merging this PR has meaningful risk outside the owned taxonomy. labels Jul 3, 2026
@steipete

steipete commented Jul 3, 2026

Copy link
Copy Markdown
Owner

Maintainer landing pass complete on exact head c6566a539ea70c4761663a9e76237c8c479f2349.

Improvements before landing:

  • merged current main and resolved the redesign conflicts without dropping the new layout
  • refreshed the public provider count to 56 across all 21 site locales and generated docs
  • added the 0.38.1 changelog entry and contributor credit
  • regenerated docs/llms.txt from source after the first CI pass caught the stale generated title

Proof:

  • ./Scripts/lint.sh lint-linux
  • node Scripts/check-site-locales.mjs
  • node --check docs/site.js
  • ./Scripts/build-site-css.sh
  • node Scripts/check-documentation-links.mjs
  • structured autoreview: clean, no accepted/actionable findings
  • existing-Chrome QA: desktop and narrow mobile, English and Arabic RTL, dark/light toggle, Homebrew copy control, no horizontal overflow, and no broken images after lazy sections loaded
  • exact-head CI: 10/10 successful, including all four macOS test shards and both Linux CLI builds

Strong redesign. Thank you, @vyctorbrzezowski!

@steipete steipete merged commit 289ae20 into steipete:main Jul 3, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

merge-risk: 🚨 other 🚨 Merging this PR has meaningful risk outside the owned taxonomy. P2 Normal priority bug or improvement with limited blast radius. rating: 🦐 gold shrimp Decent PR readiness signal, but merge confidence is limited. status: 📣 needs proof The PR needs real behavior proof before ClawSweeper can clear the contributor ask.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants