PolicyEngine / PolicyEngine/policyengine-app-v2

Calculator launch page heading hierarchy skips from h1 to h3

Open Beginner friendly
#954 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
HTML
Stars
1
Forks
3
Avg merge
1d 50m
Merged PRs (30d)
39

Description

Summary

The calculator launch page heading structure skips from the main h1 to feature-card h3 headings before any h2 appears.

Reproduction

  1. Run the calculator locally with WEBSITE_PORT=3000 CALCULATOR_PORT=3001 bun run dev.
  2. Open http://localhost:3001/us.
  3. Run Lighthouse accessibility.
  4. The page fails heading-order.

Expected

Heading levels should follow a coherent hierarchy.

Actual

The feature cards render as h3, while the first h2 headings appear later under sections like Recommended first steps.

Relevant code

  • app/src/components/calculator/CalculatorLaunchPage.tsx
    • FeatureCard uses Title order={3}

Suggested direction

Either:

  • promote those feature-card headings to h2, or
  • demote them to non-heading text if they are not real sections

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

Start by running WEBSITE_PORT=3000 CALCULATOR_PORT=3001 bun run dev, open /us, and inspect app/src/components/calculator/CalculatorLaunchPage.tsx, especially FeatureCard and its Title order={3}. Decide whether the cards are sections or presentation text, then make the heading hierarchy coherent and rerun Lighthouse until the heading-order check passes.

Written by the indexing model from the issue text.

Assessment

Tech stack
bun, typescript
Domain
accessibility, frontend
Issue type
Bug
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
85/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.