Skip to content

feat: refresh Key Features bento, docs bento grid, fix wiki 404s#12

Merged
gfargo merged 16 commits into
mainfrom
feat/www-site-redesign
May 9, 2026
Merged

feat: refresh Key Features bento, docs bento grid, fix wiki 404s#12
gfargo merged 16 commits into
mainfrom
feat/www-site-redesign

Conversation

@gfargo
Copy link
Copy Markdown
Owner

@gfargo gfargo commented May 4, 2026

Summary

Refreshes the marketing site's visual design across several sections — more visual personality, fewer bland grids.

Changes

Key Features section (homepage)

  • Replaced uniform 2-col card grid with a bento layout (3-col, varied spans)
  • Each feature card now has a unique mini terminal-style visual (command badges, view grid, progress bars, status indicators, bar chart)
  • Added TerminalAtmosphere background, hover glow effects, and bordered icon treatment

Docs index page (/docs)

  • Redesigned as a flat bento grid of individual page cards instead of nested category boxes
  • Featured "Getting Started" card spans 2 columns with prominent green accent
  • Each page card shows its category badge, description, and hover arrow
  • Consistent glow-on-hover treatment matching the homepage

Wiki manifest cleanup (fixes 404s)

  • Removed 5 pages from manifest that don't exist in the wiki (Roadmap category + audit pages)
  • Properly categorized pages that were auto-discovered but uncategorized (Coco UI, TUI Navigation, Interactive Log TUI → Terminal Workstation; Command Reference → Getting Started; Using OpenRouter → Configuration)
  • Added new "Terminal Workstation" category

Sidebar

  • Updated category icons to include Terminal Workstation
  • Removed defunct Roadmap category

Testing

  • npm run build passes cleanly
  • All doc pages generate without 404s (16 pages, down from 21 phantom entries)

gfargo added 15 commits May 4, 2026 09:47
- Restructure homepage: Hero, Toolbelt, Workstation Teaser, Key Features,
  WhatsNew, Install, Documentation, Community sections
- Add /workstation page with TUI views grid, chord navigation reference,
  key workflows accordion, theming presets, and migration comparison
- Add /changelog page with expandable release entries parsed from
  specs/RELEASE_NOTES_*.md at build time
- Implement dark terminal design system: JetBrains Mono + Inter typography,
  CSS-based TerminalAtmosphere replacing Three.js background, terminal-green
  accent palette, cursor-blink and fade-in-up animations
- Add wiki auto-discovery: prebuild scans .wiki/*.md, derives slugs,
  merges with manual manifest, assigns Uncategorized category to new pages
- Add property-based tests (fast-check) for slug derivation, manifest
  merge, and changelog version extraction
- Update Header with workstation/changelog nav links and mobile hamburger
- Update Footer with Product/Resources/Community column layout
- Add new components: CommandCard, KbdBadge, SectionHeader, ReleaseEntry,
  CopyCommand dropdown, WorkflowsAccordion
- Remove deprecated: ThreeJSBackground, Roadmap, FAQ, Feedback, old
  Features and Commands sections
- Responsive fixes across 320px-2560px breakpoints
- Accessibility: focus-visible rings on all interactive elements,
  WCAG AA contrast ratios, aria-labels on icon buttons
- Update sitemap with /workstation, /changelog, and all docs routes
- Update SEO metadata and JSON-LD structured data
…ew from homepage

- Restore the signature oxley green background and coco-cover.png hero
  image that defines the coco brand identity. The dark terminal aesthetic
  now starts below the hero with a gradient transition.
- Remove WhatsNew section from homepage — changelog lives at /changelog
  and is linked from the nav. Tightens the homepage flow to:
  Hero → Toolbelt → Workstation Teaser → Key Features → Install → Docs → Community
- Add ScreenshotPlaceholder component for image slots that show a styled
  placeholder when no screenshot exists yet, and render the real image
  when a src is provided
- Add screenshot placeholders throughout /workstation page:
  - Hero: full TUI screenshot slot
  - Views grid: per-view screenshot in each card
  - Workflows: full-width workflow screenshot after accordion
  - Theming: side-by-side theme comparison screenshots
- Remove the HeroTerminalMockup from workstation page (replaced by
  real screenshot slots)
…ark content

Instead of an overlay reaching up into the hero image area, the gradient
is now a separate band below the hero that starts green at the top and
fades down into the dark background.
Replace the neutral blue-tinted near-black background (220 15% 8%) with
a green-tinted dark palette (150 22% 10%) derived from oxley-950. All
background, border, muted, and code tokens now carry a subtle green
undertone that ties the dark sections back to the hero green identity.

Removed the gradient transition band — the green-tinted background
provides enough visual continuity with the hero that a hard edge works.
…eleases

- Add a footer card below the release entries with count and a link
  to the full release history on GitHub
- Update page subtitle to set expectations: "Recent releases and
  highlights. For the full release history, visit GitHub."
- The changelog is generated at build time from specs/RELEASE_NOTES_*.md
  files in the repo, so it naturally shows only recent versions
…/ files

The prebuild script now fetches the 20 most recent releases from the
GitHub Releases API (gfargo/coco) at build time. This removes the
dependency on specs/RELEASE_NOTES_*.md files which are temporary
working documents that get deleted after release.

- No auth required (public repo, 60 req/hr rate limit)
- Graceful fallback: if the API is unreachable, writes empty array
  and the page shows an empty state with a GitHub link
- Dates now come from the actual publish date on GitHub
- Release bodies are the full markdown from the GitHub release page
- Drafts are excluded
When filtering releases on the changelog page, matching text is now
highlighted with a green-tinted mark element throughout the entry —
in highlights, headings, list items, paragraphs, bold text, code
spans, and link text.
…ove accessibility

- Remove ThreeJSBackground, Roadmap, Faq, FaqAccordion, Feedback, Features, Commands
- Fix responsive issues at 320px (CopyCommand overflow, heading sizes, card padding)
- Add focus-visible ring styles to all interactive elements
- Bump terminal-green and muted-foreground contrast for WCAG AA compliance
- Add aria-labels to icon-only buttons and mobile nav triggers
Include tsconfig.tsbuildinfo to improve build caching and incremental compilation for faster development cycles.
@vercel
Copy link
Copy Markdown
Contributor

vercel Bot commented May 4, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
git-co-co Ready Ready Preview, Comment May 4, 2026 9:47pm

@gfargo gfargo merged commit efa2865 into main May 9, 2026
3 of 4 checks passed
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