template-git-repo 0.1.29 → 0.1.31

package/README.md

@@ -1,8 +1,8 @@
 <!-- template-git-repo:badges:start -->
 <p align="center">
     <a href="https://starterdocs.vtempest.workers.dev/docs/packages/template-git-repo"><img src="https://img.shields.io/badge/Docs-blue?logo=ReadTheDocs&logoColor=white" alt="Documentation" /></a>
-    <a href="https://stackblitz.com/github/OpenSourceAGI/dev-tools-starter-agent/tree/master/packages/template-git-repo"><img height="20px" src="https://developer.stackblitz.com/img/open_in_stackblitz.svg" alt="Open in StackBlitz" /></a>
     <br />
+    <a href="https://github.com/OpenSourceAGI/dev-tools-starter-agent/stargazers"><img src="https://img.shields.io/github/stars/OpenSourceAGI/dev-tools-starter-agent" alt="GitHub Stars" /></a>
     <a href="https://www.npmjs.com/package/template-git-repo"><img src="https://img.shields.io/npm/dm/template-git-repo.svg" alt="NPM Monthly Downloads" /></a>
     <a href="https://www.npmjs.com/package/template-git-repo"><img src="https://img.shields.io/npm/v/template-git-repo.svg" alt="npm version" /></a>
     <a href="https://www.npmjs.com/package/template-git-repo"><img src="https://img.shields.io/npm/dt/template-git-repo.svg" alt="NPM Total Downloads" /></a>
@@ -10,13 +10,13 @@
     <a href="https://packagephobia.com/result?p=template-git-repo"><img src="https://packagephobia.com/badge?p=template-git-repo" alt="Install size" /></a>
     <a href="https://app.codecov.io/gh/OpenSourceAGI/dev-tools-starter-agent/flags"><img src="https://img.shields.io/codecov/c/github/OpenSourceAGI/dev-tools-starter-agent?flag=template-git-repo&label=template-git-repo%20coverage&logo=codecov&logoColor=white" alt="Coverage" /></a>
     <br />
-    <a href="https://github.com/OpenSourceAGI/dev-tools-starter-agent/stargazers"><img src="https://img.shields.io/github/stars/OpenSourceAGI/dev-tools-starter-agent" alt="GitHub Stars" /></a>
     <a href="https://github.com/OpenSourceAGI/dev-tools-starter-agent/issues"><img src="https://img.shields.io/github/issues/OpenSourceAGI/dev-tools-starter-agent?logo=github" alt="GitHub Issues" /></a>
     <a href="https://github.com/OpenSourceAGI/dev-tools-starter-agent/pulls"><img src="https://img.shields.io/github/issues-pr/OpenSourceAGI/dev-tools-starter-agent?logo=github&label=PRs" alt="Open Pull Requests" /></a>
     <a href="https://github.com/OpenSourceAGI/dev-tools-starter-agent/pulls?q=is%3Apr+is%3Aclosed"><img src="https://img.shields.io/github/issues-pr-closed/OpenSourceAGI/dev-tools-starter-agent?logo=github&label=PRs%20merged&color=8957e5" alt="Merged Pull Requests" /></a>
     <a href="https://github.com/OpenSourceAGI/dev-tools-starter-agent/discussions"><img src="https://img.shields.io/github/discussions/OpenSourceAGI/dev-tools-starter-agent" alt="GitHub Discussions" /></a>
     <a href="https://github.com/OpenSourceAGI/dev-tools-starter-agent/commits/master/"><img src="https://img.shields.io/github/last-commit/OpenSourceAGI/dev-tools-starter-agent.svg" alt="GitHub last commit" /></a>
     <br />
+    <a href="https://stackblitz.com/github/OpenSourceAGI/dev-tools-starter-agent/tree/master/packages/template-git-repo"><img height="20px" src="https://developer.stackblitz.com/img/open_in_stackblitz.svg" alt="Open in StackBlitz" /></a>
     <img src="https://img.shields.io/badge/Bun-14151A?logo=bun&logoColor=white" alt="Bun" /> <img src="https://img.shields.io/badge/Vitest-6E9F18?logo=vitest&logoColor=white" alt="Vitest" />
 </p>
 <!-- template-git-repo:badges:end -->

package/docs/BADGES.md

@@ -17,6 +17,23 @@ The block lives between `<!-- template-git-repo:badges:start -->` and
 between the markers and nothing else, so it is safe to run again after you publish a
 package or finish setting up Codecov.
 
+## The four rows
+
+The block renders one row per group, in this order. The split is by the question a
+reader is asking, not by where the badge is hosted — stars sit with the download
+counts because both answer "is anyone using this", and the sandbox buttons sit at
+the bottom so they do not compete with the link to the live app.
+
+| Row | Carries |
+| --- | --- |
+| Row 1 — what this is and where to try it | `doi`, `deepwiki`, `website`, `docs`, `api`, `youtube`, `uptime`, `deploy-cloudflare` |
+| Row 2 — is it used, is it working, is it shipped | `stars`, `npm-downloads`, `npm-version`, `npm-total-downloads`, `npm-types`, `install-size`, `codecov`, `codecov-flag`, `workflow`, `test-report` |
+| Row 3 — is it alive, who is behind it | `contributors`, `forks`, `issues`, `pull-requests`, `prs-merged`, `discussions`, `commit-activity`, `last-commit`, `discord` |
+| Row 4 — run it yourself, and what it is built with | `stackblitz`, `codespaces`, `prs-welcome`, `license`, `stack` |
+
+A row whose badges are all missing or excluded is dropped rather than rendered
+empty, so a repo with nothing published still gets a tidy three-row block.
+
 ## Index
 
 | Badge | Needs | Flag |
@@ -27,16 +44,9 @@ package or finish setting up Codecov.
 | [Documentation](#docs) `docs` | docsUrl | `--docs <url>` |
 | [API reference](#api) `api` | apiUrl | `--api <url>` |
 | [YouTube demo](#youtube) `youtube` | youtubeUrl | `--youtube <url>` |
+| [Uptime](#uptime) `uptime` | uptimeUrl | `--uptime <url>` |
 | [Deploy to Cloudflare Workers](#deploy-cloudflare) `deploy-cloudflare` | cloudflareDeploy | `--cloudflare-deploy` |
-| [Open in StackBlitz](#stackblitz) `stackblitz` | stackblitzUrl | `--stackblitz <url>` |
-| [Open in GitHub Codespaces](#codespaces) `codespaces` | — | on by default |
 | [GitHub stars](#stars) `stars` | — | on by default |
-| [GitHub forks](#forks) `forks` | — | on by default |
-| [Contributors](#contributors) `contributors` | — | on by default |
-| [Open issues](#issues) `issues` | — | on by default |
-| [Open pull requests](#pull-requests) `pull-requests` | — | on by default |
-| [Merged pull requests](#prs-merged) `prs-merged` | — | on by default |
-| [GitHub Discussions](#discussions) `discussions` | — | on by default |
 | [npm monthly downloads](#npm-downloads) `npm-downloads` | npmPackage | `--npm-package <name>` |
 | [npm version](#npm-version) `npm-version` | npmPackage | `--npm-package <name>` |
 | [npm total downloads](#npm-total-downloads) `npm-total-downloads` | npmPackage | `--npm-package <name>` |
@@ -46,15 +56,22 @@ package or finish setting up Codecov.
 | [Coverage for one package](#codecov-flag) `codecov-flag` | codecovFlag | `--codecov-flag <name>` |
 | [CI status](#workflow) `workflow` | workflowFile | `--workflow <file>` |
 | [Hosted test report](#test-report) `test-report` | testReportUrl | `--test-report <url>` |
-| [Uptime](#uptime) `uptime` | uptimeUrl | `--uptime <url>` |
+| [Contributors](#contributors) `contributors` | — | on by default |
+| [GitHub forks](#forks) `forks` | — | on by default |
+| [Open issues](#issues) `issues` | — | on by default |
+| [Open pull requests](#pull-requests) `pull-requests` | — | on by default |
+| [Merged pull requests](#prs-merged) `prs-merged` | — | on by default |
+| [GitHub Discussions](#discussions) `discussions` | — | on by default |
 | [Commit activity](#commit-activity) `commit-activity` | — | on by default |
 | [Last commit](#last-commit) `last-commit` | — | on by default |
 | [Discord](#discord) `discord` | discordId, discordInvite | `--discord-id <id>` `--discord-invite <url>` |
+| [Open in StackBlitz](#stackblitz) `stackblitz` | stackblitzUrl | `--stackblitz <url>` |
+| [Open in GitHub Codespaces](#codespaces) `codespaces` | — | on by default |
 | [PRs welcome](#prs-welcome) `prs-welcome` | — | on by default |
 | [License](#license) `license` | — | on by default |
 | [Tech stack chips](#stack) `stack` | stack | `--stack <A,B,C>` |
 
-## Identity — what this project is
+## Row 1 — what this is and where to try it
 
 ### doi
 
@@ -104,6 +121,14 @@ A demo video does more for a README than three paragraphs. Any YouTube URL works
 
 Enable with: `--youtube <url>`
 
+### uptime
+
+**Uptime**
+
+Create a monitor at uptimerobot.com, then a public status page, and link the status page here. This is a static badge — it says "brightgreen" even while you are down. For a live one use the UptimeRobot shields endpoint with a read-only API key.
+
+Enable with: `--uptime <url>`
+
 ### deploy-cloudflare
 
 **Deploy to Cloudflare Workers**
@@ -112,24 +137,16 @@ The repo must contain a wrangler.toml (or wrangler.jsonc) at the path the button
 
 Enable with: `--cloudflare-deploy`
 
-### stackblitz
+## Row 2 — is it used, is it working, is it shipped
 
-**Open in StackBlitz**
-
-Nothing to configure — StackBlitz imports a public repo straight from a URL: `https://stackblitz.com/github/<owner>/<repo>/tree/<branch>/<path>`. Point it at a directory that boots on its own (a package with its own package.json, or an `examples/` folder), because StackBlitz installs from the manifest at that path and a bare monorepo root will not run. Node APIs need the WebContainer runtime, which means the directory must be ESM and its deps must be installable from npm.
-
-Enable with: `--stackblitz <url>`
-
-### codespaces
+### stars
 
-**Open in GitHub Codespaces**
+**GitHub stars**
 
-Nothing to configure — the link boots the repo in a default container. Add a `.devcontainer/devcontainer.json` if the default image is missing something your install needs, because the visitor sees the failure, not you. Codespaces bills the visitor's own free hours, so the button costs you nothing.
+Nothing to configure. Public repos only — shields.io cannot read a private repo.
 
 Included by default — no configuration needed.
 
-## Quality — is it working, is it tested, is it shipped
-
 ### npm-downloads
 
 **npm monthly downloads**
@@ -202,21 +219,13 @@ Backed by `.github/workflows/deploy-test-reports.yml`, which publishes the Vites
 
 Enable with: `--test-report <url>`
 
-### uptime
-
-**Uptime**
+## Row 3 — is it alive, who is behind it
 
-Create a monitor at uptimerobot.com, then a public status page, and link the status page here. This is a static badge — it says "brightgreen" even while you are down. For a live one use the UptimeRobot shields endpoint with a read-only API key.
-
-Enable with: `--uptime <url>`
-
-## Community — is it alive, can I join
-
-### stars
+### contributors
 
-**GitHub stars**
+**Contributors**
 
-Nothing to configure. Public repos only — shields.io cannot read a private repo.
+Nothing to configure, but it counts commit authors GitHub could match to an account — commits made with an unregistered email are attributed to nobody and do not appear here. Use `contributors-anon` instead if your history has many of those.
 
 Included by default — no configuration needed.
 
@@ -228,14 +237,6 @@ Nothing to configure. Counts direct forks only, not forks of forks, so it underc
 
 Included by default — no configuration needed.
 
-### contributors
-
-**Contributors**
-
-Nothing to configure, but it counts commit authors GitHub could match to an account — commits made with an unregistered email are attributed to nobody and do not appear here. Use `contributors-anon` instead if your history has many of those.
-
-Included by default — no configuration needed.
-
 ### issues
 
 **Open issues**
@@ -292,6 +293,24 @@ Two different values: the numeric server id drives the online-member count (Serv
 
 Enable with: `--discord-id <id>` `--discord-invite <url>`
 
+## Row 4 — run it yourself, and what it is built with
+
+### stackblitz
+
+**Open in StackBlitz**
+
+Nothing to configure — StackBlitz imports a public repo straight from a URL: `https://stackblitz.com/github/<owner>/<repo>/tree/<branch>/<path>`. Point it at a directory that boots on its own (a package with its own package.json, or an `examples/` folder), because StackBlitz installs from the manifest at that path and a bare monorepo root will not run. Node APIs need the WebContainer runtime, which means the directory must be ESM and its deps must be installable from npm.
+
+Enable with: `--stackblitz <url>`
+
+### codespaces
+
+**Open in GitHub Codespaces**
+
+Nothing to configure — the link boots the repo in a default container. Add a `.devcontainer/devcontainer.json` if the default image is missing something your install needs, because the visitor sees the failure, not you. Codespaces bills the visitor's own free hours, so the button costs you nothing.
+
+Included by default — no configuration needed.
+
 ### prs-welcome
 
 **PRs welcome**
@@ -308,8 +327,6 @@ Reads the license GitHub detected, which comes from a recognized LICENSE file at
 
 Included by default — no configuration needed.
 
-## Stack — what it is built with
-
 ### stack
 
 **Tech stack chips**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "template-git-repo",
-  "version": "0.1.29",
+  "version": "0.1.31",
   "description": "One command to set up a repo with GitHub Actions, README badges, Turborepo and Codecov — the CI setup from qwksearch-research-agent, as a template",
   "type": "module",
   "bin": {

package/src/badges.js

@@ -11,14 +11,34 @@
  *   setup   what a human has to do outside this repo to make it real, which is
  *           the part every badge README omits. `docs/BADGES.md` is generated
  *           from these strings, so the docs cannot drift from the catalog.
- *   group   which line of the badge block it belongs on. Twenty badges in one
- *           run is a wall; four rows of five reads.
+ *   group   which line of the badge block it belongs on. See `GROUPS` below
+ *           for what each row carries and why the split falls where it does.
  *
  * Adding a badge means adding an entry here — nothing else in the package
  * needs to know about it.
  */
 
-/** Row order in the rendered block. */
+/**
+ * Row order in the rendered block, and what each row is for.
+ *
+ * The split is by the question a reader is asking, not by where the badge is
+ * hosted — which is why stars sits with the download counts rather than with
+ * the PR queue, and why the sandbox buttons sit at the bottom next to the
+ * stack chips instead of competing with the link to the live app.
+ *
+ *   identity   what this is and where to try it — DOI, wiki, app, docs, API,
+ *              demo video, uptime, the one-click deploy button.
+ *   quality    is it used and is it working — stars, npm downloads and version,
+ *              install size, coverage, CI.
+ *   community  is it alive and who is behind it — contributors, forks, issues,
+ *              the PR queue, commit activity, chat.
+ *   stack      run it yourself, and what it is built with — StackBlitz,
+ *              Codespaces, PRs welcome, license, the tech chips.
+ *
+ * Row one earns the click, row two says whether the project is worth the
+ * click, and the rest is for whoever is still reading. Twenty badges in one
+ * run is a wall; four labelled rows reads.
+ */
 export const GROUPS = ['identity', 'quality', 'community', 'stack'];
 
 /** @typedef {Record<string, string | undefined>} BadgeContext */
@@ -108,6 +128,17 @@ export const BADGES = [
     setup: 'A demo video does more for a README than three paragraphs. Any YouTube URL works.',
     height: '20px',
   },
+  {
+    id: 'uptime',
+    title: 'Uptime',
+    group: 'identity',
+    needs: ['uptimeUrl'],
+    alt: 'Uptime Status',
+    href: (c) => c.uptimeUrl,
+    img: () => shieldsBadge('Uptime-Status', 'brightgreen', { logo: 'uptimerobot', logoColor: 'white' }),
+    setup:
+      'Create a monitor at uptimerobot.com, then a public status page, and link the status page here. This is a static badge — it says "brightgreen" even while you are down. For a live one use the UptimeRobot shields endpoint with a read-only API key.',
+  },
   {
     id: 'deploy-cloudflare',
     title: 'Deploy to Cloudflare Workers',
@@ -120,107 +151,16 @@ export const BADGES = [
       'The repo must contain a wrangler.toml (or wrangler.jsonc) at the path the button clones. Cloudflare forks the repo into the visitor\'s account and runs the build, so anything the build needs must come from `[vars]` or be prompted for — a build that requires a secret fails for every visitor.',
     height: '24px',
   },
-  {
-    id: 'stackblitz',
-    title: 'Open in StackBlitz',
-    group: 'identity',
-    needs: ['stackblitzUrl'],
-    alt: 'Open in StackBlitz',
-    href: (c) => c.stackblitzUrl,
-    img: () => 'https://developer.stackblitz.com/img/open_in_stackblitz.svg',
-    setup:
-      'Nothing to configure — StackBlitz imports a public repo straight from a URL: `https://stackblitz.com/github/<owner>/<repo>/tree/<branch>/<path>`. Point it at a directory that boots on its own (a package with its own package.json, or an `examples/` folder), because StackBlitz installs from the manifest at that path and a bare monorepo root will not run. Node APIs need the WebContainer runtime, which means the directory must be ESM and its deps must be installable from npm.',
-    height: '20px',
-  },
-  {
-    id: 'codespaces',
-    title: 'Open in GitHub Codespaces',
-    group: 'identity',
-    needs: [],
-    alt: 'Open in GitHub Codespaces',
-    href: (c) => `https://codespaces.new/${c.repoSlug}`,
-    img: () => 'https://github.com/codespaces/badge.svg',
-    setup:
-      'Nothing to configure — the link boots the repo in a default container. Add a `.devcontainer/devcontainer.json` if the default image is missing something your install needs, because the visitor sees the failure, not you. Codespaces bills the visitor\'s own free hours, so the button costs you nothing.',
-    height: '20px',
-  },
   {
     id: 'stars',
     title: 'GitHub stars',
-    group: 'community',
+    group: 'quality',
     needs: [],
     alt: 'GitHub Stars',
     href: (c) => `https://github.com/${c.repoSlug}/stargazers`,
     img: (c) => `https://img.shields.io/github/stars/${c.repoSlug}`,
     setup: 'Nothing to configure. Public repos only — shields.io cannot read a private repo.',
   },
-  {
-    id: 'forks',
-    title: 'GitHub forks',
-    group: 'community',
-    needs: [],
-    alt: 'GitHub Forks',
-    href: (c) => `https://github.com/${c.repoSlug}/forks`,
-    img: (c) => `https://img.shields.io/github/forks/${c.repoSlug}`,
-    setup:
-      'Nothing to configure. Counts direct forks only, not forks of forks, so it undercounts a repo that has been forked along a chain. Public repos only.',
-  },
-  {
-    id: 'contributors',
-    title: 'Contributors',
-    group: 'community',
-    needs: [],
-    alt: 'Contributors',
-    href: (c) => `https://github.com/${c.repoSlug}/graphs/contributors`,
-    img: (c) => `https://img.shields.io/github/contributors/${c.repoSlug}`,
-    setup:
-      'Nothing to configure, but it counts commit authors GitHub could match to an account — commits made with an unregistered email are attributed to nobody and do not appear here. Use `contributors-anon` instead if your history has many of those.',
-  },
-  {
-    id: 'issues',
-    title: 'Open issues',
-    group: 'community',
-    needs: [],
-    alt: 'GitHub Issues',
-    href: (c) => `https://github.com/${c.repoSlug}/issues`,
-    img: (c) => `https://img.shields.io/github/issues/${c.repoSlug}?logo=github`,
-    setup:
-      'Nothing to configure beyond having Issues enabled (Settings → Features). Read it as a work-in-flight number, not a defect count: shields.io asks GitHub Search, which counts pull requests as issues unless the badge path excludes them — this one uses the `/issues/` path, which already does.',
-  },
-  {
-    id: 'pull-requests',
-    title: 'Open pull requests',
-    group: 'community',
-    needs: [],
-    alt: 'Open Pull Requests',
-    href: (c) => `https://github.com/${c.repoSlug}/pulls`,
-    img: (c) => `https://img.shields.io/github/issues-pr/${c.repoSlug}?logo=github&label=PRs`,
-    setup:
-      'Nothing to configure. Counts open PRs including drafts. Pair it with the merged count below — an open count alone reads the same whether the queue moves in a day or has been stuck for a year.',
-  },
-  {
-    id: 'prs-merged',
-    title: 'Merged pull requests',
-    group: 'community',
-    needs: [],
-    alt: 'Merged Pull Requests',
-    href: (c) => `https://github.com/${c.repoSlug}/pulls?q=is%3Apr+is%3Aclosed`,
-    img: (c) =>
-      `https://img.shields.io/github/issues-pr-closed/${c.repoSlug}?logo=github&label=PRs%20merged&color=8957e5`,
-    setup:
-      'Nothing to configure. shields.io has no "merged" endpoint — `issues-pr-closed` counts every PR that is no longer open, so PRs closed without merging are in this number too. On a repo that closes a lot of stale PRs, label it "PRs closed" instead of overstating what landed.',
-  },
-  {
-    id: 'discussions',
-    title: 'GitHub Discussions',
-    group: 'community',
-    needs: [],
-    alt: 'GitHub Discussions',
-    href: (c) => `https://github.com/${c.repoSlug}/discussions`,
-    img: (c) => `https://img.shields.io/github/discussions/${c.repoSlug}`,
-    setup:
-      'Discussions has to be turned on (Settings → Features → Discussions) or the badge reads "repo not found" — which looks identical to a private repo. Turn it on before adding the badge, not after.',
-  },
   {
     id: 'npm-downloads',
     title: 'npm monthly downloads',
@@ -324,15 +264,71 @@ export const BADGES = [
       'Backed by `.github/workflows/deploy-test-reports.yml`, which publishes the Vitest HTML reporter output to Cloudflare Workers on every push to the default branch. Needs CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID secrets.',
   },
   {
-    id: 'uptime',
-    title: 'Uptime',
-    group: 'quality',
-    needs: ['uptimeUrl'],
-    alt: 'Uptime Status',
-    href: (c) => c.uptimeUrl,
-    img: () => shieldsBadge('Uptime-Status', 'brightgreen', { logo: 'uptimerobot', logoColor: 'white' }),
+    id: 'contributors',
+    title: 'Contributors',
+    group: 'community',
+    needs: [],
+    alt: 'Contributors',
+    href: (c) => `https://github.com/${c.repoSlug}/graphs/contributors`,
+    img: (c) => `https://img.shields.io/github/contributors/${c.repoSlug}`,
     setup:
-      'Create a monitor at uptimerobot.com, then a public status page, and link the status page here. This is a static badge — it says "brightgreen" even while you are down. For a live one use the UptimeRobot shields endpoint with a read-only API key.',
+      'Nothing to configure, but it counts commit authors GitHub could match to an account — commits made with an unregistered email are attributed to nobody and do not appear here. Use `contributors-anon` instead if your history has many of those.',
+  },
+  {
+    id: 'forks',
+    title: 'GitHub forks',
+    group: 'community',
+    needs: [],
+    alt: 'GitHub Forks',
+    href: (c) => `https://github.com/${c.repoSlug}/forks`,
+    img: (c) => `https://img.shields.io/github/forks/${c.repoSlug}`,
+    setup:
+      'Nothing to configure. Counts direct forks only, not forks of forks, so it undercounts a repo that has been forked along a chain. Public repos only.',
+  },
+  {
+    id: 'issues',
+    title: 'Open issues',
+    group: 'community',
+    needs: [],
+    alt: 'GitHub Issues',
+    href: (c) => `https://github.com/${c.repoSlug}/issues`,
+    img: (c) => `https://img.shields.io/github/issues/${c.repoSlug}?logo=github`,
+    setup:
+      'Nothing to configure beyond having Issues enabled (Settings → Features). Read it as a work-in-flight number, not a defect count: shields.io asks GitHub Search, which counts pull requests as issues unless the badge path excludes them — this one uses the `/issues/` path, which already does.',
+  },
+  {
+    id: 'pull-requests',
+    title: 'Open pull requests',
+    group: 'community',
+    needs: [],
+    alt: 'Open Pull Requests',
+    href: (c) => `https://github.com/${c.repoSlug}/pulls`,
+    img: (c) => `https://img.shields.io/github/issues-pr/${c.repoSlug}?logo=github&label=PRs`,
+    setup:
+      'Nothing to configure. Counts open PRs including drafts. Pair it with the merged count below — an open count alone reads the same whether the queue moves in a day or has been stuck for a year.',
+  },
+  {
+    id: 'prs-merged',
+    title: 'Merged pull requests',
+    group: 'community',
+    needs: [],
+    alt: 'Merged Pull Requests',
+    href: (c) => `https://github.com/${c.repoSlug}/pulls?q=is%3Apr+is%3Aclosed`,
+    img: (c) =>
+      `https://img.shields.io/github/issues-pr-closed/${c.repoSlug}?logo=github&label=PRs%20merged&color=8957e5`,
+    setup:
+      'Nothing to configure. shields.io has no "merged" endpoint — `issues-pr-closed` counts every PR that is no longer open, so PRs closed without merging are in this number too. On a repo that closes a lot of stale PRs, label it "PRs closed" instead of overstating what landed.',
+  },
+  {
+    id: 'discussions',
+    title: 'GitHub Discussions',
+    group: 'community',
+    needs: [],
+    alt: 'GitHub Discussions',
+    href: (c) => `https://github.com/${c.repoSlug}/discussions`,
+    img: (c) => `https://img.shields.io/github/discussions/${c.repoSlug}`,
+    setup:
+      'Discussions has to be turned on (Settings → Features → Discussions) or the badge reads "repo not found" — which looks identical to a private repo. Turn it on before adding the badge, not after.',
   },
   {
     id: 'commit-activity',
@@ -366,10 +362,34 @@ export const BADGES = [
     setup:
       'Two different values: the numeric server id drives the online-member count (Server Settings → Widget → Enable Server Widget, then copy the Server ID), and the invite link is where the badge points. Without the widget enabled the badge reads "invite" instead of a count.',
   },
+  {
+    id: 'stackblitz',
+    title: 'Open in StackBlitz',
+    group: 'stack',
+    needs: ['stackblitzUrl'],
+    alt: 'Open in StackBlitz',
+    href: (c) => c.stackblitzUrl,
+    img: () => 'https://developer.stackblitz.com/img/open_in_stackblitz.svg',
+    setup:
+      'Nothing to configure — StackBlitz imports a public repo straight from a URL: `https://stackblitz.com/github/<owner>/<repo>/tree/<branch>/<path>`. Point it at a directory that boots on its own (a package with its own package.json, or an `examples/` folder), because StackBlitz installs from the manifest at that path and a bare monorepo root will not run. Node APIs need the WebContainer runtime, which means the directory must be ESM and its deps must be installable from npm.',
+    height: '20px',
+  },
+  {
+    id: 'codespaces',
+    title: 'Open in GitHub Codespaces',
+    group: 'stack',
+    needs: [],
+    alt: 'Open in GitHub Codespaces',
+    href: (c) => `https://codespaces.new/${c.repoSlug}`,
+    img: () => 'https://github.com/codespaces/badge.svg',
+    setup:
+      'Nothing to configure — the link boots the repo in a default container. Add a `.devcontainer/devcontainer.json` if the default image is missing something your install needs, because the visitor sees the failure, not you. Codespaces bills the visitor\'s own free hours, so the button costs you nothing.',
+    height: '20px',
+  },
   {
     id: 'prs-welcome',
     title: 'PRs welcome',
-    group: 'community',
+    group: 'stack',
     needs: [],
     alt: 'PRs Welcome',
     href: () =>
@@ -380,7 +400,7 @@ export const BADGES = [
   {
     id: 'license',
     title: 'License',
-    group: 'community',
+    group: 'stack',
     needs: [],
     alt: 'License',
     href: (c) => `https://github.com/${c.repoSlug}/blob/${c.defaultBranch}/LICENSE.md`,