Skip to content

ScanGov/scangov

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

457 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Project ScanGov

About

Project ScanGov is a government digital experience monitor.

Data

Audit data is committed to the repo at public/data/myscangov_homepage_audits.json. The build uses this file directly.

To refresh the data, run the fetch script with the SCANGOV_HASH_SECRET environment variable (find the value in the closed auditor repo):

SCANGOV_HASH_SECRET='...' node scripts/fetch-auditor-data.js

The fetch script pulls from the auditor API, filters incomplete records, validates state coverage, and overwrites the data file. Commit the updated file to deploy new data.

If SCANGOV_HASH_SECRET is not set, the build skips the fetch and uses the committed data file.

Build triggers

  • Push to main: The deploy-to-ghpages workflow builds and deploys on every push to main.
  • Manual: The same workflow can be triggered manually from the GitHub Actions UI via workflow_dispatch.

Data structure

Each domain record includes pre-computed scores across 4 audit topics:

  • Accessibility - Individual Lighthouse accessibility audits
  • Botability - Crawlability, sitemaps, robots.txt, schema markup
  • Security - HTTPS, CSP, HSTS, security.txt, .gov domain
  • Usability - Performance metrics, meta tags, readability, viewport

The auditor API returns only domains audited within the last 30 days that have complete data across all 4 topics.

Maintainer

ScanGov

Contribute

We encourage collaboration.

Related

Contact

Contact ScanGov

About

Government digital experience monitor

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors