Skip to content

Conversation

@eonist
Copy link
Member

@eonist eonist commented Nov 29, 2025

Overview

This PR adds a GitHub Action that automatically tracks download statistics for all release assets.

What This Does

  • Daily snapshots: Runs at 00:00 UTC every day to capture download counts
  • Historical tracking: Creates a CSV file (history.csv) with time-series data
  • Current state: Generates JSON snapshots of latest download counts
  • Platform breakdown: Shows which binaries (Linux, macOS, Windows, Figma plugin) are most popular
  • Manual trigger: Can be run on-demand via the Actions tab

Files Created

The workflow will automatically generate and maintain:

  • .github/download-stats/latest.json - Current snapshot of all releases and their download counts
  • .github/download-stats/history.csv - Daily time-series data for trending analysis
  • .github/download-stats/README.md - Human-readable summary with totals and platform breakdown

Benefits

  1. Usage insights: Understand which platforms your users prefer
  2. Release impact: See how new releases affect download patterns
  3. Trend analysis: Track growth over time with historical data
  4. Decision support: Data-driven decisions on which platforms to prioritize

Testing

After merging, you can:

  1. Go to Actions → "Track Release Downloads"
  2. Click "Run workflow" to trigger manually
  3. Check .github/download-stats/ for generated files

Related

Implements download tracking as discussed in the context of measuring GitHub release adoption across multiple platforms (Linux arm64/x64, macOS, Windows, Figma plugin).

This workflow:
- Runs daily at 00:00 UTC to snapshot download statistics
- Creates a historical CSV of downloads over time
- Generates JSON snapshots and markdown summaries
- Tracks per-platform download counts
- Can be manually triggered via workflow_dispatch
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants