Skip to content

[Product Homepage Design] Implementation#143

Open
yetone wants to merge 21 commits into
masterfrom
feature/product-homepage-design-nfzz-6166fa7
Open

[Product Homepage Design] Implementation#143
yetone wants to merge 21 commits into
masterfrom
feature/product-homepage-design-nfzz-6166fa7

Conversation

@yetone

@yetone yetone commented May 7, 2026

Copy link
Copy Markdown
Owner

Summary

This PR implements the requirements for Product Homepage Design.


Generated by Something

Yansu added 21 commits May 7, 2026 03:38
- Add QuickStartSection with 4-step clone/build/run/connect guide
- Add reusable CodeBlock component with syntax highlighting and copy button
- Add unit tests for QuickStartSection (11 tests, all passing)
- Add E2E tests for quick-start section (10 tests, all passing)
- Set up full Next.js project structure with shared files
- Include MirDB defaults: listen 0.0.0.0:12333, work dir /tmp/mirdb
Replace stub RoadmapSection with complete implementation showing:
- 4 implemented features with green checkmarks (tokio async, memtable
  with skiplist, minor/major compaction)
- 1 planned feature with amber pending icon (Raft consensus)
- Distinct visual styling between implemented and planned items
- Responsive two-column grid layout

Update ROADMAP_ITEMS constants with full descriptive titles
matching PRD specification. Add comprehensive unit tests.
- Implement DemoSection with usage.gif display and lazy loading
- Add CSS/JS animated terminal simulation showing SET/GET/DELETE
- Add comprehensive unit tests for DemoSection component
- Fix tsconfig to exclude playwright.config.ts from build
- Add sticky header with horizontal desktop navigation
- Implement multi-column grid layouts for Features, Protocol,
  Architecture, and Status sections
- Add max-width constraints (max-w-4xl, max-w-7xl) to prevent
  excessive stretching on wide screens
- Style Hero section with large typography and centered content
- Add responsive-desktop.spec.ts Playwright E2E tests covering
  viewport sizes 1280x800 and 1920x1080
Adds Playwright + axe-core test suite covering the full set of
accessibility scenarios for the MirDB homepage:

- axe-core audit (no critical violations, score >= 90)
- Keyboard navigation reachability for interactive elements
- Visible focus indicators on links/buttons
- Heading hierarchy (single h1, no skipped levels)
- Image alt text validation (descriptive, not empty)
- ARIA landmarks (header, main, nav, footer) with labelled navs
- Lang attribute on the html element

Also adds @axe-core/playwright + axe-core dev dependencies and copies
the logo.gif/usage.gif assets into the homepage public folder so the
page renders during e2e runs.
- Implement interactive hamburger menu with open/close state
- Add mobile navigation overlay with all section links
- Handle Escape key to close menu and prevent body scroll
- Add ARIA attributes for accessibility (aria-expanded, aria-controls, role=dialog)
- Write comprehensive E2E tests for mobile responsive design:
  - Single-column stacked layout at 375x667
  - Hamburger menu opens/closes overlay with all nav links
  - Code blocks are scrollable without page overflow
  - Content remains readable at 320x568
  - All sections stack vertically on mobile
…ari, Edge

- Configure playwright.config.ts with browser-specific projects scoped to
  cross-browser.spec.ts via testMatch (other tests still run only on chromium)
- Add 18 cross-browser E2E tests covering: page load, console errors, section
  rendering, CSS variables, flexbox, grid, sticky header, smooth scroll,
  backdrop-filter fallback, navigation accessibility, font fallbacks, asset
  loading, viewport meta, focus states
- Add CSS feature detection utility (supportsCSSFeature, supportsFlexbox,
  supportsGrid, supportsCSSVariables, supportsBackdropFilter, etc.) with
  graceful fallbacks for browsers without CSS.supports
- Add 27 unit tests covering feature detection logic and static analysis of
  globals.css / postcss.config.js / tailwind.config.ts
…ence

- Implement useTheme hook with React Context for theme state management
- Add ThemeToggle component with sun/moon icons and keyboard accessibility
- Update layout.tsx with anti-FOUC script to prevent theme flash on load
- Support system preference detection via prefers-color-scheme media query
- Persist theme selection to localStorage across page reloads
- Add comprehensive unit and e2e tests for all theme behaviors
Adds tests/e2e/static-generation.spec.ts which spins up an in-process
Node http server against the dist/ build output and asserts:

- next build completes successfully and emits dist/
- dist/ contains only static HTML, CSS, JS, and asset files
  (no server runtime artifacts like middleware-manifest.json)
- the build is renderable behind a generic static file server
- no /api routes resolve and no .node/.cjs runtime files are emitted

Confirms NFR-6 (Static Hosting) of the homepage PRD - the build must
deploy to GitHub Pages, nginx, etc. with no Node runtime required.
…nfzz-6166fa7' into feature/product-homepage-design-nfzz-6166fa7
…nfzz-6166fa7' into feature/product-homepage-design-nfzz-6166fa7
- Implement useScrollSpy hook backed by IntersectionObserver to derive the
  currently-visible section id from a list of section ids.
- Wire the desktop and mobile Header navigation to programmatic smooth scroll
  with header-height offset and history.pushState hash updates (no reload).
- Add scrolled-state tracking on the sticky header so it can transition between
  transparent-blur and solid-blur backgrounds as the user scrolls past the hero.
- Support deep-link / direct-hash navigation by smooth-scrolling to the target
  section after mount when window.location.hash is present.
- Add active-link highlighting via aria-current and a data-active attribute that
  tracks the scroll-spy active id on both desktop and mobile menus.
- New Playwright e2e suite tests/e2e/navigation.spec.ts covering desktop click
  scrolling, hash updates without reload, sticky background, scroll-spy active
  states, mobile menu close-on-click, and direct hash deep-linking.
…nfzz-6166fa7' into feature/product-homepage-design-nfzz-6166fa7
Adds complete SEO setup to the homepage layout including:
- Descriptive title and meta description (under 160 chars)
- Open Graph tags (og:title, og:description, og:type, og:image, og:url)
- Twitter Card tags (twitter:card=summary_large_image, title, description, image)
- Canonical URL via metadata.alternates
- JSON-LD structured data with SoftwareApplication schema
- Viewport meta tag for responsive rendering

Also adds e2e tests in tests/e2e/seo.spec.ts covering all SEO
requirements for discoverability and social sharing previews.
…nfzz-6166fa7' into feature/product-homepage-design-nfzz-6166fa7
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