docs: update sponsor stats during build

Author: antonreshetov

docs/website/.vitepress/_data/github-stats.json

@@ -0,0 +1,8 @@
+{
+  "repository": "massCodeIO/massCode",
+  "stars": 6713,
+  "releaseDownloads": 202805,
+  "activeDevelopmentStartYear": 2019,
+  "activeDevelopmentYears": 7,
+  "updatedAt": "2026-05-06T13:14:33.070Z"
+}

docs/website/package.json

@@ -5,7 +5,8 @@
   "description": "massCode documentation website",
   "scripts": {
     "dev": "vitepress dev",
-    "build": "vitepress build",
+    "build": "node scripts/update-github-stats.mjs && vitepress build",
+    "stats:update": "node scripts/update-github-stats.mjs",
     "preview": "vitepress preview"
   },
   "dependencies": {

docs/website/scripts/update-github-stats.mjs

@@ -0,0 +1,114 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const outputPath = join(__dirname, '../.vitepress/_data/github-stats.json')
+const repository = 'massCodeIO/massCode'
+const startYear = 2019
+
+async function readExistingStats() {
+  try {
+    return JSON.parse(await readFile(outputPath, 'utf-8'))
+  }
+  catch {
+    return {
+      repository,
+      stars: 0,
+      releaseDownloads: 0,
+      activeDevelopmentStartYear: startYear,
+      activeDevelopmentYears: new Date().getUTCFullYear() - startYear,
+      updatedAt: null,
+    }
+  }
+}
+
+function createHeaders() {
+  const headers = {
+    'Accept': 'application/vnd.github+json',
+    'User-Agent': 'masscode-docs-build',
+    'X-GitHub-Api-Version': '2022-11-28',
+  }
+
+  // eslint-disable-next-line node/prefer-global/process
+  const token = process.env.GITHUB_TOKEN || process.env.GH_TOKEN
+
+  if (token)
+    headers.Authorization = `Bearer ${token}`
+
+  return headers
+}
+
+async function fetchJson(url) {
+  const response = await fetch(url, { headers: createHeaders() })
+
+  if (!response.ok)
+    throw new Error(`GitHub API returned ${response.status} for ${url}`)
+
+  return response.json()
+}
+
+async function fetchAllReleases() {
+  const releases = []
+  let page = 1
+
+  while (true) {
+    const batch = await fetchJson(`https://api.github.com/repos/${repository}/releases?per_page=100&page=${page}`)
+
+    if (!Array.isArray(batch) || batch.length === 0)
+      break
+
+    releases.push(...batch)
+
+    if (batch.length < 100)
+      break
+
+    page += 1
+  }
+
+  return releases
+}
+
+function getReleaseDownloads(releases) {
+  return releases.reduce((total, release) => {
+    if (release.draft)
+      return total
+
+    return total + release.assets.reduce((assetTotal, asset) => assetTotal + asset.download_count, 0)
+  }, 0)
+}
+
+async function updateStats() {
+  const existingStats = await readExistingStats()
+
+  try {
+    const [repo, releases] = await Promise.all([
+      fetchJson(`https://api.github.com/repos/${repository}`),
+      fetchAllReleases(),
+    ])
+
+    const stats = {
+      repository,
+      stars: repo.stargazers_count,
+      releaseDownloads: getReleaseDownloads(releases),
+      activeDevelopmentStartYear: startYear,
+      activeDevelopmentYears: new Date().getUTCFullYear() - startYear,
+      updatedAt: new Date().toISOString(),
+    }
+
+    await mkdir(dirname(outputPath), { recursive: true })
+    await writeFile(outputPath, `${JSON.stringify(stats, null, 2)}\n`)
+
+    console.log(`Updated GitHub stats: ${stats.stars} stars, ${stats.releaseDownloads} release downloads`)
+  }
+  catch (error) {
+    const message = error instanceof Error ? error.message : String(error)
+
+    console.warn(`Could not update GitHub stats, using existing values: ${message}`)
+
+    await mkdir(dirname(outputPath), { recursive: true })
+    await writeFile(outputPath, `${JSON.stringify(existingStats, null, 2)}\n`)
+  }
+}
+
+await updateStats()

docs/website/sponsor/index.md

@@ -3,6 +3,31 @@ title: Sponsor massCode
 description: "Sponsor massCode and be recognized across the project website, GitHub repository, release notes, and community updates."
 ---
 
+<script setup>
+import githubStats from '../.vitepress/_data/github-stats.json'
+
+function formatMetric(value) {
+  const number = Number(value)
+
+  if (!Number.isFinite(number) || number <= 0)
+    return '—'
+
+  if (number < 1000)
+    return `${Math.floor(number).toLocaleString('en-US')}+`
+
+  const precision = number >= 100000 ? 1000 : 100
+  const rounded = Math.floor(number / precision) * precision
+  const shortValue = rounded / 1000
+  const formatted = Number.isInteger(shortValue) ? shortValue.toString() : shortValue.toFixed(1)
+
+  return `${formatted}k`
+}
+
+const githubStars = formatMetric(githubStats.stars)
+const releaseDownloads = formatMetric(githubStats.releaseDownloads)
+const activeDevelopmentYears = `${githubStats.activeDevelopmentYears}+`
+</script>
+
 # Sponsor massCode
 
 **Support massCode and be recognized across the project website, GitHub repository, release notes, and community updates.**
@@ -32,9 +57,9 @@ Unlike cloud-based alternatives, massCode stores user content locally as plain M
 
 | Metric | Value |
 | --- | --- |
-| GitHub stars | **6,700+** |
-| GitHub release downloads | **201,000+** |
-| Years in active development | **6+**, since 2019 |
+| GitHub stars | <strong>{{ githubStars }}</strong> |
+| GitHub release downloads | <strong>{{ releaseDownloads }}</strong> |
+| Years in active development | <strong>{{ activeDevelopmentYears }}</strong>, since 2019 |
 | Platforms | macOS, Windows, Linux |
 | Companion ecosystem | VS Code extension, Raycast extension, CLI tools |
 | Telemetry / tracking | **None, by design** |