Week of 8/10 - Development Standup Thread

[azdak]

6-Month Roadmap

Hung Scan Postmortem
Stale Blockers Analysis
Hardcoded Values Audit | Environment Variables by Service | AWS Resources List | Notes
Equalify Semantic Versioning Doc

Dev Reports
March 6th | March 31st | April 5th | June 1st | July 7th | August 1st

New/Discussion

• FOSS Deployment Sprint
  • Determine IaC/Provisioning Framework (Terraform, OpenTofu, whatever): there are a variety of options for Infrastructure as Code (IaC) and we need to look at the tradeoffs for each and settle on one
  • Create BUILD SCRIPTS 💀: Write IaC scripts to provision all the infrastructure-ie lambdas, DB, and relationships between them- needed to run an Equalify instance
  • Determine deployment strategy: Figure out how to handle deployment, ie how code (and code updates) are pushed to the provisioned infrastructure
  • Provisioning & Deployment Documentation: Technical documentation for deployment
  • Finish Sprint :
    • Chris testing of deployable
    • Merge with Staging and test production<->deployable interop (@heythisischris and @azdak)
    • Developer-focused docs to introduce how to use the app from a high level. (@heythisischris and @azdak)
    • Updated main Readme (@heythisischris and @azdak)
    • Merge with main

Features

• Email notifications currently just act as a reminder, on a fixed schedule. (@azdak 7/13)
  • Improve email content (add URL/Blocker count, summary content, etc)
  • Should we add additional options, like email after scan complete?
• Implement KPI Tracking
  • Scans Executed Overall
  • Sessions started
  • User-installable Releasse Candidate
  • Tickets Opened
  • Units served data from SSO (if possible)
  • We will meet and discuss Weds August 12, 2026 at 12pm CT.
• Talk through "Error Explanation Sprint", ie improving data interpretability for users, and next roadmap
  • blockers per URL (include time delta?)
  • Add PDF vs HTML counts in audit someplace
  • issue export/integrations (to git, to...?)
  • "next steps":
    • repeated blocker code across URLs
      • identical (this code appears across X sites, fixing this blocker...)
      • fuzzy match? (Note; bad idea)
    • Better highlight 'trouble' (high blocker count/ratio) pages
  • Separate out spec (wcag2.1, etc)
  • URL drilldown
  • URL Onboarding wizard?
  • We will meet and discuss Weds August 12, 2026 at 12pm CT.

Bugs

Pending Next Roadmap Meeting

Current Work

@azdak To Dos:

• Initial terraform scripts
  • create v1
  • get clean AWS account
  • Testing and debug
• Noticing blocker inconsistencies between sites with similar content #647
• Make Audits screen filter (My Audits vs All Audits) stored in state (@azdak 7/13)
• Look at routing/back button support appwide, especially on audit screen (@azdak 7/13)
  • Added routing for summary/detailed views and table pagination
• Summary View: Add links to (filtered) detailed view for "Most Common Blockers" and "URLs with most Blockers"- ie clicking a "Most Common Blocker" would link to the detailed view with all instances of that blocker (@azdak 7/13)

@heythisischris To Dos:

• Initial pass of TF deployment fixes and documentation, prepare to merge into staging/main.
  • Start with merge into staging.
• July dev report
• Update docs for self-registration
• Work on DB Schema version control and Hasura metadata version control
  • Include in CI/CD
• Add Hono framework to backend API
  • Not worth it at this time, postponing for next major update
• Review Terraform process so far, potentially update, add documentation, etc.
• Scheduled Equalify Audit Not Running #645
  • Related to WP integration and URL count listing as NA. Manually refreshing the URL list fixes the issue, but should make sure this was an artifact of another change and not an ongoing issue - Example scan that failed to run
• Handoff Equalify Extension brain dump to Trey
• Adjusted DASE Hub according to Helen / Michael / Jemma's feedback, prepared prototype to demo to Jason

Icebox

• Weird issue:
  • Scanner->results webhook can be:
    • OK
    • Error
    • but also Error ... Error ... OK
  • Means Count on errors is tricky/unclear to user: if I scan 50 pages, I could get 40 (or 80!) errors but still have 50 successful scans
  • Options
    • OK overrides/drops errors from table: drops data but simplest/does what it says UX. Is first try error data important?
    • No retry: simplest to understand but uh kinda counter to the goal, which is scanning
    • Retain but only show "final" errors in UX: most complete but not sure easiest way to implement
    • 5/11 - Try tying errors to a blocker ID, use the latest error. Update error depending on what's latest? Or array of errors? We'll figure this out.

Future

Current Feature Development Priority Order

Reviewed every 3rd Thursday | Feature Priority Sheet

Task	Tech Notes
Admin-settable co-brand logo	Allow admins to set a co-brand logo to appear alongside Equalify
Improve Blocker filter categories	Right now, we are mapping not very useful data to the Category fields, especially with PDFs. The goal here would be to identify the most useful data to map to categories
Show total blocker count on Audits screen
WebAIMee integration	Either integration with existing external WebAIMee service, or integrating this directly into Equalify. Would add LLM-based "How to Fix" information to individual blocker pages
FOSS/Infrastructure Sprint	Develop build scripts (with documentation) to more easily allow anyone to spin up an Equalify instance
PDF Link Source Tracking	Goal is for users to be able to identify which pages in an audit have PDF links, and the URL of those linked PDFs. Solution here would be adding functionality to CSV export (ie option to export CSV with "Pdf Url" & "Page Url" fields). Additionally, improve UX to make whole CSV export button/process clearer to users
Self-Registration	The idea here would be a public page for SSO installs, from which a user could enter email to request access. Approve/Deny option would then appear on the admin screen
Error Explanation Sprint	Develop clarity around reported accessibility blockers by improving a knowledge base, AI tooling, and integrating existing services like FAE. Included: axe-core / Vera explanation, blocker code, and most importantly is filtering labels (categories and tags), steps to remediate
Separating Template vs Content Blockers	Difficult problem, immediate way forward may be through expanding the new WP plugin
Design/Maintenance Sprint	Dashboard visual refresh and general code cleanup

Accessibility Audits

Scheduled Date	Audit Date	Results/Issues
No Later than 7/20	7/20	#641, #644
No Later than 10/27

Planned Sprint Details

FOSS Sprint aka Infrastructure Week (1-2 weeks)

• Determine IaC/Provisioning Framework (Terraform, OpenTofu, whatever): there are a variety of options for Infrastructure as Code (IaC) and we need to look at the tradeoffs for each and settle on one
• Create BUILD SCRIPTS 💀: Write IaC scripts to provision all the infrastructure-ie lambdas, DB, and relationships between them- needed to run an Equalify instance
• Determine deployment strategy: Figure out how to handle deployment, ie how code (and code updates) are pushed to the provisioned infrastructure
• Provisioning & Deployment Documentation: Technical documentation for deployment
• User Documentation: Developer-focused Readme to introduce how to use the app from a high level.

Design & Maintenance Sprint (1-2 weeks)

• Get alignment on overall visual direction and palette
• Branding: Defining how branding is handled on the system.
• Design System: Atomic system or Storybook for component uniformity
• Darkmode 😎
• Mobile breakpoints
• Style and Code Cleanup: Finish componentizing, minimize global styles, and code cleanup
• Discussion/Fit into roadmap (@azdak 3/16): Roll-up reporting, eg being able to get a summary view of several audits at once
• Discussion/Fit into roadmap (@azdak 3/16): user<->audit groups and/or more fine-grained control over what each user sees on the audit listing page

Onboard Features Sprint (1-2 weeks)

• Site onboarding features
  • Lambda for site crawling
  • Integrate onboarding features into Build Audit
• Allow external, linked CSVs as basis for Audit URLs (with regular or just-in-time on-scan re-scrapes), allowing WordPress plugin integration
• CSV User import

Backlog/Blocked

• Help text first pass
  • ID icon areas
  • Refactor HelperTooltip component
  • Write help text
• Integrate error reporting into "blockers over time" scans table (also possibly the graph?)
• Discussion/Fit into roadmap (@azdak 3/16): the eternal Custom Rules question
• Discussion/Fit into roadmap (@azdak 3/16): the even more eternal "exclude the CMS header/footer" question 😄