Home

System wiki for BaseballScorecard.org, a live digital scorecard that renders every pitch, at-bat, and substitution from MLB games into traditional scorekeeping notation.

What is this?

Baseball scorecards are a pencil-and-paper tradition. Fans translate action on the field into symbols on a sheet of paper. BaseballScorecard.org does the same thing digitally, pulling live data from the MLB Stats API.

Every pitch thrown, every ground ball to short, every stolen base, every pitching change. It all gets rendered into an SVG scorecard that looks like something you'd fill out with a pencil in the stands.

Who made this?

Denis (he/him) is a designer with interests in data visualization, AI tooling, and baseball scorekeeping. He built this project by combining his design skills with Claude Code (Anthropic's AI) for back-end development, environment setup, and project organization. The collaboration started in March 2026.

Read the full Origin Story for more on how design and AI came together to build this.

Quick links

• How to Read a Scorecard - start here if you're new to scorekeeping
• Design System - colors, typography, borders, components
• Release Notes - what's changed, version by version
• Baseball Rules - the rules that drive the rendering
• Technical Reference - architecture, data flow, file map