TinyChain-Inc / TinyChain-Inc/client

[Web][W2.3] Build responsive application shell and navigation patterns

Open
#81 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
0
Forks
0
Avg merge
3d 8h
Merged PRs (30d)
32

Description

Objective

Provide a reusable application shell for browser and React Native Web applications without coupling it to a TinyChain product domain.

Scope

Header, primary/secondary navigation, breadcrumb, side panel/drawer, content regions, skip links, status/notification region and authenticated-user slot. Support mobile, tablet and desktop layouts plus deep links and SSR.

Acceptance criteria

  • One example application uses only shared shell APIs.
  • Navigation order, landmarks, skip links, route focus and mobile drawer behavior pass keyboard/browser tests.
  • Hydration and responsive transitions do not duplicate content or lose focus.
  • Long labels, localization, RTL, zoom and safe-area behavior are represented.
  • Screenshot sets cover all canonical viewports and require human approval.

Parent: #8

Required visual evidence

The draft PR must provide a runnable component-gallery route plus before/after screenshots at 390×844, 768×1024, and 1440×900. Cover light, dark, high-contrast, default, hover, focus-visible, disabled, loading, empty, error, and overflow states applicable to the component. Playwright must exercise keyboard interaction and capture deterministic screenshots. A reviewer other than the implementing agent must approve intentional baseline changes; screenshot generation or a passing pixel threshold is not visual approval.

Tembo execution contract

automation:
  eligible: true
  executor_profile: tembo
  readiness: blocked
  primary_repository: TinyChain-Inc/client
  base_branch: main
  writable_scope:
    - web/src/ui/shell/**
    - web/src/ui/gallery/**
    - web/tests/**
    - web/src/example/**
  prerequisites:
    - "#77"
    - "#78"
  concurrency_group: ui-composites-shell
  required_commands:
    - "cd web && npm ci"
    - "cd web && npm run test:all"
  external_actions: none
  draft_pr_only: true
  completion_authority: human
  visual_validation:
    required: true
    browsers: [chromium]
    viewports: [mobile, tablet, desktop]
    evidence: [component-gallery-url, screenshot-bundle, playwright-report]
    baseline_update_requires: human-visual-approval
    failure_policy: never-auto-accept-diff
  budget:
    size: large
    max_revisions: 3
    max_wall_minutes: 120

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Read prerequisites #77 and #78 first, then inspect web/src/ui/shell/, web/src/ui/gallery/, web/tests/, and web/src/example/. Run cd web && npm ci followed by npm run test:all. Done requires a shared-shell example, passing keyboard and browser tests, a runnable gallery route, Playwright reports, deterministic screenshots at the specified viewports, and human approval of visual changes.

Written by the indexing model from the issue text.

Assessment

Tech stack
react, react-native
Domain
accessibility, frontend, internationalization
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.