Files
timmy-config/deploy/gitea-a11y/README.md
Step35 5cb71b666c
Some checks failed
Architecture Lint / Linter Tests (pull_request) Successful in 20s
Smoke Test / smoke (pull_request) Failing after 20s
Validate Config / YAML Lint (pull_request) Failing after 15s
Validate Config / JSON Validate (pull_request) Successful in 18s
Validate Config / Python Syntax & Import Check (pull_request) Failing after 57s
Validate Config / Python Test Suite (pull_request) Has been skipped
Validate Config / Shell Script Lint (pull_request) Failing after 59s
Validate Config / Cron Syntax Check (pull_request) Successful in 12s
Validate Config / Deploy Script Dry Run (pull_request) Successful in 15s
Validate Config / Playbook Schema Validation (pull_request) Successful in 31s
Architecture Lint / Lint Repository (pull_request) Failing after 23s
PR Checklist / pr-checklist (pull_request) Successful in 5m17s
[a11y] V2: Add aria-label to Explore filter/sort radios + search (WCAG 3.3.2) — #546
Add a11y overrides for Explore/Repositories page form inputs that
lacked programmatic labels:
- Search input: aria-label="Search repositories"
- 11 filter radio buttons (clear, archived, fork, mirror, template, private)
- 12 sort radio buttons (newest, oldest, alphabetically, etc.)

Fixes 25 unlabeled inputs identified in accessibility audit.

Deployment: deploy/gitea-a11y/deploy-gitea-a11y.sh

Closes #546
2026-04-26 17:27:05 -04:00

2.2 KiB

Gitea Accessibility Fixes

Custom template overrides for WCAG 2.1 AA compliance on the Timmy Foundation Forge.

Applied fixes identified by the accessibility audit (#492):

Fix Issue WCAG Description
R1 #551 Best Practice Password visibility toggle (eye icon) on sign-in page
R2 #552 3.3.1 aria-required="true" on required form fields
R3 #553 4.1.2 aria-label on star/fork count links ("2 stars", "0 forks")
R4 #554 1.3.1 <time datetime="..."> elements for relative timestamps
V2 #546 3.3.2 aria-label on search input and filter/sort radio buttons (25 inputs)

Structure

deploy/gitea-a11y/
├── deploy-gitea-a11y.sh          # Deployment script
├── README.md
└── custom/
    ├── public/
    │   ├── css/
    │   └── js/
    └── templates/
        ├── custom/
        │   └── time_relative.tmpl    # R4: <time> helper
        ├── repo/
        │   └── list_a11y.tmpl        # R3: aria-label on counts
        └── user/auth/
            └── signin_inner.tmpl     # R1+R2: password toggle + aria-required

Deploy

bash deploy/gitea-a11y/deploy-gitea-a11y.sh
# or to a specific host:
bash deploy/gitea-a11y/deploy-gitea-a11y.sh root@my-gitea-host.com

Template Overrides

Gitea supports custom template overrides by placing files in custom/templates/. The templates here override the default Gitea templates with a11y improvements.

R1: Password Visibility Toggle

Adds an eye icon (👁) button next to the password field that toggles between type="password" and type="text". Updates aria-label dynamically.

R2: aria-required

Adds aria-required="true" to the username and password inputs, which properly communicates required state to screen readers.

R3: Star/Fork aria-label

Wraps star and fork count links with aria-label="2 stars" so screen readers announce the meaning, not just the number.

R4: <time> Elements

Wraps relative timestamps ("2 minutes ago") in <time datetime="2026-04-13T17:00:00Z"> providing both human-readable text and machine-readable ISO 8601 dates.