npm statusboard is a public monitoring dashboard that aggregates the status and health of a team's open-source projects in a single view.
The tool solves the problem of tracking project health across multiple repositories by automatically discovering and monitoring projects that belong to an organization and are tagged with a specific topic. It fetches data daily from GitHub and the npm registry, collecting metrics about each project's status. The dashboard displays this aggregated information through a web interface, allowing team members to quickly assess the overall health of their maintained projects without visiting each repository individually.
The statusboard is designed for teams maintaining multiple open-source projects who want centralized visibility into their portfolio. It works best for organizations using GitHub where projects can be tagged with a consistent topic for discovery. The tool is portable enough that other teams can fork and adapt it for their own use, though doing so requires updating configuration files, GitHub Actions workflows, and data storage paths to match a different organization's structure and naming conventions.
The project uses a monorepo structure with separate workspaces for data fetching and web serving. Development involves running fetch commands locally to update project lists and daily metrics, with corresponding GitHub Actions workflows available for automation. The site publishes automatically to GitHub Pages on pushes to the main branch. The tool maintains historical data in JSON files and provides configuration points for controlling which data gets fetched from GitHub and how it gets parsed and displayed on the frontend.
