ci: add template semver tagging

Author: giacomoguidotto

.github/CONTRIBUTING.md

@@ -39,6 +39,7 @@ Thanks for wanting to contribute to Blueprint! Please read our [Code of Conduct]
 
 - Branch names: `feat/`, `fix/`, `docs/`, etc.
 - Commits: [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) (`feat:`, `fix:`, `docs:`, `refactor:`, `test:`, `chore:`)
+- Releases: `fix:` bumps patch, `feat:` bumps minor, and breaking changes bump major on `main`
 - Components: PascalCase — Utilities/hooks: camelCase — Constants: SCREAMING_SNAKE_CASE
 - All UI must use shadcn/ui components (`src/components/ui/`)
 - Convex functions must have `args`, `returns`, and `handler`

.github/workflows/ci.yml

@@ -39,3 +39,34 @@ jobs:
           NEXT_PUBLIC_CONVEX_URL: ${{ matrix.task == 'build' && 'https://stub.convex.cloud' || '' }}
           NEXT_PUBLIC_CONVEX_SITE_URL: ${{ matrix.task == 'build' && 'https://stub.convex.site' || '' }}
           NEXT_PUBLIC_WORKOS_REDIRECT_URI: ${{ matrix.task == 'build' && 'https://stub.example.com/callback' || '' }}
+
+  version:
+    name: Release
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
+    needs: [check]
+
+    permissions:
+      contents: write
+
+    steps:
+      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+        with:
+          fetch-depth: 0
+
+      - uses: oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6 # v2.2.0
+
+      - uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae # v5.0.5
+        with:
+          path: ~/.bun/install/cache
+          key: bun-${{ runner.os }}-${{ hashFiles('bun.lock') }}
+          restore-keys: bun-${{ runner.os }}-
+
+      - run: bun install --frozen-lockfile
+        env:
+          HUSKY: "0"
+
+      - name: Semantic Release
+        run: bunx semantic-release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

README.md

@@ -344,6 +344,16 @@ This project embeds production-grade patterns and architectural decisions:
 
 All checks (lint, typecheck, test, build) are available via `bun run ci`.
 
+## 📦 Template releases
+
+Blueprint is versioned with git tags. On pushes to `main`, CI reads Conventional Commits since the latest `v*` tag and creates the next SemVer tag:
+
+- `fix:` creates a patch release.
+- `feat:` creates a minor release.
+- `feat!:` or `BREAKING CHANGE:` creates a major release.
+
+The template is not published as an npm package. Use GitHub tags/releases to choose a stable starting point.
+
 ## 🤝 Contributing
 
 See [CONTRIBUTING.md](.github/CONTRIBUTING.md) for setup instructions and project conventions.