feat: Accessibility improvements (#93)

.github/workflows/ci.yml → .github/workflows/accessibility.yml

@@ -1,4 +1,4 @@
-name: CI
+name: Accessibility
 on:
   push:
     branches: main

.github/workflows/links.yml

@@ -1,4 +1,4 @@
-name: Links
+name: Valid Links
 
 on:
   repository_dispatch:

.vscode/extensions.json

@@ -1,4 +1,8 @@
 {
-  "recommendations": ["astro-build.astro-vscode", "dbaeumer.vscode-eslint"],
+  "recommendations": [
+    "astro-build.astro-vscode",
+    "dbaeumer.vscode-eslint",
+    "deque-systems.vscode-axe-linter"
+  ],
   "unwantedRecommendations": []
 }

README.md

@@ -18,6 +18,14 @@ If you need help with your legal name change or gender marker change, come join
 | `src/styles`     | Global site styles.                                                     |
 | `tests`          | End-to-end tests written using Playwright.                              |
 
-## Broken Links
+## Accessibility
+
+[![Accessibility](https://github.com/namesakefyi/namesake.fyi/actions/workflows/accessibility.yml/badge.svg)](https://github.com/namesakefyi/namesake.fyi/actions/workflows/accessibility.yml)
+
+Namesake aims to conform to the Level AA accessibility standards outlined in the [WCAG 2.2 specification](https://www.w3.org/TR/WCAG22/). If you experience an issue with accessing any part of this site, please [file an issue](https://github.com/namesakefyi/namesake.fyi/issues) and we will correct it.
+
+## Link Checking
+
+[![Valid Links](https://github.com/namesakefyi/namesake.fyi/actions/workflows/links.yml/badge.svg)](https://github.com/namesakefyi/namesake.fyi/actions/workflows/links.yml)
 
 A weekly [GitHub workflow](https://github.com/namesakefyi/namesake.fyi/actions/workflows/links.yml) scans the site for broken links and will open an [issue](https://github.com/namesakefyi/namesake.fyi/issues) if one is found.

eslint.config.js

@@ -1,10 +1,3 @@
 import eslintPluginAstro from "eslint-plugin-astro";
 
-export default [
-  ...eslintPluginAstro.configs.recommended,
-  {
-    rules: {
-      "eol-last": "always",
-    },
-  },
-];
+export default [...eslintPluginAstro.configs["jsx-a11y-recommended"]];

package.json

@@ -9,6 +9,7 @@
     "build": "astro check && astro build",
     "preview": "astro preview",
     "astro": "astro",
+    "lint": "eslint .",
     "test": "playwright test --reporter=html",
     "check-links": "lychee --config .lychee.toml ."
   },
@@ -34,8 +35,8 @@
   "devDependencies": {
     "@playwright/test": "^1.44.1",
     "@types/node": "^20.14.8",
-    "@typescript-eslint/parser": "^7.13.1",
-    "eslint": "^8.57.0",
+    "@typescript-eslint/parser": "^7.14.1",
+    "eslint": "^9.5.0",
     "eslint-plugin-astro": "^1.2.2",
     "eslint-plugin-jsx-a11y": "^6.9.0",
     "prettier": "^3.3.2",

playwright.config.ts

@@ -11,14 +11,12 @@ export default defineConfig({
     baseURL: "http://localhost:4321",
     trace: "on-first-retry",
   },
-
   projects: [
     {
       name: "chromium",
       use: { ...devices["Desktop Chrome"] },
     },
   ],
-
   webServer: {
     command: "pnpm dev",
     url: "http://localhost:4321",