Skip to content

docs: add RESPONSIVE.md codifying breakpoints and per-page grid rules#467

Open
Devadakene wants to merge 1 commit into
CredenceOrg:mainfrom
Devadakene:docs/responsive-contract
Open

docs: add RESPONSIVE.md codifying breakpoints and per-page grid rules#467
Devadakene wants to merge 1 commit into
CredenceOrg:mainfrom
Devadakene:docs/responsive-contract

Conversation

@Devadakene

Copy link
Copy Markdown

This PR closes #446

Description

This PR introduces docs/RESPONSIVE.md, codifying the responsive layout contract for the Credence frontend application. Prior to this document, responsive styling rules and grid template behaviors were scattered across inline page declarations, Figma design specs, and style migration notes.

This document serves as the source of truth for the viewport thresholds (360px, 640px, 768px, 900px, 1280px) and establishes clear design token rules to prevent hardcoded layout values.

Key Additions

  • Breakpoint Thresholds: Clear mapping of viewports to CSS media queries, expected behaviors, and source code references.
  • Per-Route Grid Rules: Detailed documentation of reflow behavior on primary views:
    • Home: Natively wrapping flex CTAs.
    • Bond: Dynamic grid auto-fitting cards (repeat(auto-fit, minmax(min(100%, 22rem), 1fr))).
    • Trust Score: Autolayout column reflows (repeat(auto-fit, minmax(300px, 1fr))).
    • Settings: Responsive transition at 900px (1fr 360px columns) and narrow-mobile overrides.
  • Layout Spacing & Radius Tokens: A comprehensive index of --credence-space-* and --credence-radius-* tokens from src/index.css.
  • Edge Case Handling: Codifies rules on vertical table/nav collapsing and preventing horizontal scrolling on 360px layouts (using ellipsis truncations for long hashes/addresses).
  • Manual QA Checklist: A 3-step checklist (Narrow Mobile, Tablet, Desktop) for contributors to manually review layouts.

Verification

  • Staged, checked file references, and successfully pushed the new branch docs/responsive-contract to origin tracking.
  • Verified that all absolute links resolved correctly to real code sections.

Documents the 360px/768px contract, per-route grid reflow citing real sources, the layout spacing-token rule, and a manual responsive QA checklist.
@drips-wave

drips-wave Bot commented Jun 29, 2026

Copy link
Copy Markdown

@Devadakene Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

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.

Author docs/RESPONSIVE.md codifying the breakpoint contract and per-page layout grid rules

1 participant