• Refinement and adaptation of the marketplace layout: design system, WCAG accessibility, cross-browser compatibility and performance

    22 hours ago
    • Desired budget up to 850.33 USD
    • Waiting for a performer...
  • Initial situation: there is an existing B2C marketplace (catalog, product card, shopping cart, checkout) with a partially assembled layout. The layouts in Figma are up-to-date, but the current layout is different: different indents and typography on the pages, the grid at 768-1024px breaks, there are problems with scrolling modal windows, the viewport height jumps on iOS Safari, and sticky does not work correctly on older Chromium versions. Project on Next.js 14 (App Router) + TypeScript, styles on SCSS Modules, part of the UI on Headless UI, assembly via Vite for Storybook. The production uses SSR, so it is important to avoid solutions that rely on window at the rendering stage.

    Subject area: e-commerce, including the cart and checkout pages that are critical for conversion.

    Task: to bring the layout to a single standard and adaptive behavior according to the layouts, to ensure accessibility and predictable behavior of UI components in different browsers. The work involves analysis of the existing code base and step-by-step edits with regression.

    Specific result:
    1) Normalized design system at the layout level: a single indent scale, typography, basic UI tokens (colors, radii, shadows) via CSS custom properties with light/dark support (dark is already partially there, but inconsistent).
    2) Fixed adaptability for key pages: /catalog, /product/[slug], /cart, /checkout. Statuses: empty, loading (skeleton), error, long names, many options/photos, promotional code, free shipping, disabled payment methods.
    3) Refactoring of problematic layout components: header with mega menu, catalog filters (drawer on mobile, sidebar on desktop), product gallery (thumbs), modal windows (auth, size guide), sticky summary block in the cart.
    4) Improving layout performance: eliminate layout shift on loading images/fonts, reduce the number of forced reflows in interactive blocks, minimize heavy box-shadow/blur where it affects FPS.

    Restrictions:
    - You cannot change the business logic, API and routing structure. Editing JSX markup at the component level is allowed if necessary for semantics/accessibility/stable layout.
    - You cannot connect heavy UI frameworks (Bootstrap/MUI/Tailwind) and rewrite the entire project. Point utilities and polyfills are allowed when justified.
    - It is important to maintain SSR compatibility and not introduce flashing styles during hydration.
    - Browser support: the latest 2 versions of Chrome/Edge/Firefox, Safari 16+, iOS Safari 16+, also checked for Chromium 109 (as a minimum for some corporate users).

    Measurable acceptance criteria:
    - Pixel perfect match with Figma within: deviation of indents/sizes no more than 2px at control breakpoints 360, 390, 768, 1024, 1280, 1440.
    - There is no horizontal scrolling at widths 320-1440 on the specified pages.
    - Lighthouse (Mobile) for /product and /checkout: Performance no lower than 75, CLS no higher than 0.05 (excluding external analytics that are already connected).
    - Accessibility: correct focus styles, logical tab-order, modals with focus trap and focus return, aria attributes for interactive elements, text contrast at least AA for main content.
    - Visual Regression: Provide before/after report/screenshots on key screens and list of affected components.

    Execution steps:
    - Audit and plan: identify sources of discrepancies (tokens, mixins, components), compile a list of edits and implementation order.
    - Implementation of tokens and basic rules (variables, typography, spacing) with minimal risk of regression.
    - Screen-by-screen adaptation and edits of components, while simultaneously closing cross-browser bugs.
    - Final polishing: accessibility, performance, regression screens and short documentation on layout rules (what is set where and how to add new components).

    Access/materials: GitHub repository, Figma, preview stand. Working through PR with clear commits is expected.
  • How would you rate this task?

    Sign in to leave your rating.

    Total ratings: 0

Your offer

You have not submitted an offer for this order yet.
Click “Submit an offer” to send your offer.

Need a similar task?

If this project is close to your need, you can view ready services in the category or post your own task with the required budget, deadline and requirements.

The project «Refinement and adaptation of the marketplace layout: design system, WCAG accessibility, cross-browser compatibility and performance» can be used as a reference for your own brief: what should be done, what result is needed and what budget to set.