pendulum-chain / pendulum-chain/vortex

Improve UX form errors

Open
#1,007 0 comments 0 reactions 1 assignee View on GitHub

@Sharqiewicz is already working on this.

Since Jan 12, 2026.

type:chore type:enhancement
Dominant language
TypeScript
Stars
6
Forks
5
Avg merge
1d 7h
Merged PRs (30d)
33

Description

Task summary

Standardize form error timing across the app using the "reward early, punish late"

Problem / context
  • Currently validation is inconsistent: some fields show errors on change, some on blur, some only on submit.
  • This creates UX noise, makes WCAG compliance harder (3.3.1 Error Identification), and complicates implementation
Acceptance Criteria

Validation timing:

  1. Before interaction: No errors shown until form submitted
  2. On submit: Validate all, show error summary + inline errors, focus first error
  3. On input: Clear error immediately when field becomes valid (don't wait for blur)
  4. On blur: Show error if field is invalid + dirty
    ( 3 and 4 only after form submission(2) )
  • use react-hook-form and yup

Accessibility (WCAG 3.3.1 compliance)

  • Use aria-invalid="true" on invalid fields, "false" or remove when valid.
  • Link error text via aria-describedby="field-error-id".
  • Error text must be perceivable without color alone (don't rely solely on red borders).
  • Consider aria-live="polite" for dynamic inline error updates to avoid overwhelming screen readers.

Contributor guide

No contributing guide indexed for this repository

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.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.