diff --git a/.github/workflows/example.yml b/.github/workflows/example.yml
new file mode 100644
index 0000000..ee55789
--- /dev/null
+++ b/.github/workflows/example.yml
@@ -0,0 +1,46 @@
+name: Example Coverage Workflow
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+permissions:
+  pull-requests: write
+  contents: write # Required for GitHub Pages upload
+
+jobs:
+  coverage:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests with coverage
+        run: npm test
+
+      - name: Report Coverage
+        uses: ./
+        with:
+          coverage-file: "coverage/coverage-summary.json"
+          title: "🧪 Test Coverage Report"
+          show-files: "true"
+          coverage-threshold: "80"
+          make-badges: "true"
+
+      # Upload badges to GitHub Pages (only on main branch)
+      - name: Upload Badges to GitHub Pages
+        if: github.ref == 'refs/heads/main'
+        uses: ./
+        with:
+          action: "badge-upload-action.yml"
+          badges-dir: "badges"
+          pages-branch: "gh-pages"
+          pages-badges-dir: "badges"
diff --git a/ACTION_README.md b/ACTION_README.md
index 51db583..ee95175 100644
--- a/ACTION_README.md
+++ b/ACTION_README.md
@@ -1,6 +1,6 @@
 # Vitest Coverage Reporter GitHub Action
 
-A GitHub Action that automatically creates beautiful coverage reports in pull requests using vitest coverage data.
+A GitHub Action that automatically creates beautiful coverage reports in pull requests using vitest coverage data. Built with pure YAML and shell commands for maximum reliability.
 
 ## Features
 
@@ -9,7 +9,9 @@ A GitHub Action that automatically creates beautiful coverage reports in pull re
 - 📁 **File-level Details**: Option to show individual file coverage breakdowns
 - 🔄 **Smart Updates**: Updates existing comments instead of creating duplicates
 - 🎨 **Visual Indicators**: Uses emojis to quickly identify coverage status
-- ⚡ **Lightweight**: Fast execution with minimal dependencies
+- 🏷️ **Coverage Badges**: Generates shields.io compatible badges locally
+- ⚡ **Lightweight**: Pure YAML and shell commands, no JavaScript complexity
+- 🔧 **Reliable**: No module system issues or permission headaches
 
 ## Usage
 
@@ -45,16 +47,19 @@ jobs:
         uses: glideapps/vitest-v8-json-coverage-summary@v1
 ```
 
-### Advanced Usage
+### Advanced Usage with Badge Upload
 
 ```yaml
-name: Coverage Report
+name: Coverage Report with Badge Upload
 on:
   pull_request:
     branches: [main]
+  push:
+    branches: [main]
 
 permissions:
   pull-requests: write
+  contents: write # Required for GitHub Pages upload
 
 jobs:
   coverage:
@@ -73,6 +78,7 @@ jobs:
       - name: Run tests with coverage
         run: npm test
 
+      # Coverage reporting (runs on PRs and main)
       - name: Report Coverage
         uses: glideapps/vitest-v8-json-coverage-summary@v0.0.0-echo
         with:
@@ -80,17 +86,48 @@ jobs:
           title: "🧪 Test Coverage Report"
           show-files: "true"
           coverage-threshold: "90"
+          make-badges: "true"
+
+  # Badge upload (only runs on main branch)
+  upload-badges:
+    if: github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    needs: coverage
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # Needed for git operations
+
+      - name: Upload Badges to GitHub Pages
+        uses: glideapps/vitest-v8-json-coverage-summary@v0.0.0-echo
+        with:
+          action: "badge-upload-action.yml"
+          badges-dir: "badges"
+          pages-branch: "gh-pages"
+          pages-badges-dir: "badges"
 ```
 
 ## Inputs
 
-| Input                | Description                                             | Required | Default                          |
-| -------------------- | ------------------------------------------------------- | -------- | -------------------------------- |
-| `coverage-file`      | Path to the coverage summary JSON file                  | No       | `coverage/coverage-summary.json` |
-| `token`              | GitHub token for creating comments                      | No       | `${{ github.token }}`            |
-| `title`              | Title for the coverage report comment                   | No       | `📊 Coverage Report`             |
-| `show-files`         | Whether to show individual file coverage details        | No       | `true`                           |
-| `coverage-threshold` | Minimum coverage percentage to consider as good (0-100) | No       | `80`                             |
+| Input                | Description                                               | Required | Default                          |
+| -------------------- | --------------------------------------------------------- | -------- | -------------------------------- |
+| `coverage-file`      | Path to the coverage summary JSON file                    | No       | `coverage/coverage-summary.json` |
+| `token`              | GitHub token for creating comments                        | No       | `${{ github.token }}`            |
+| `title`              | Title for the coverage report comment                     | No       | `📊 Coverage Report`             |
+| `show-files`         | Whether to show individual file coverage details          | No       | `true`                           |
+| `coverage-threshold` | Minimum coverage percentage to consider as good (0-100)   | No       | `80`                             |
+| `make-badges`        | Whether to generate coverage badges in a badges directory | No       | `true`                           |
+
+## Badge Upload Action
+
+For uploading badges to GitHub Pages, use the separate `badge-upload-action.yml`:
+
+| Input              | Description                                       | Required | Default                            |
+| ------------------ | ------------------------------------------------- | -------- | ---------------------------------- |
+| `badges-dir`       | Directory containing the badges to upload         | No       | `badges`                           |
+| `pages-branch`     | Branch to upload badges to for GitHub Pages       | No       | `gh-pages`                         |
+| `pages-badges-dir` | Directory within the pages branch to store badges | No       | `badges`                           |
+| `commit-message`   | Commit message for badge updates                  | No       | `Update coverage badges [skip ci]` |
 
 ## Coverage File Format
 
@@ -182,3 +219,98 @@ Contributions are welcome! Please feel free to submit a Pull Request.
 ## License
 
 MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Coverage Badges
+
+When `make-badges` is enabled (default: `true`), the action creates a `badges` directory with shields.io compatible JSON files:
+
+### Generated Badges
+
+- `badges/coverage.json` - Overall coverage percentage
+- `badges/statements.json` - Statement coverage
+- `badges/branches.json` - Branch coverage
+- `badges/functions.json` - Function coverage
+- `badges/lines.json` - Line coverage
+
+### Badge Colors
+
+- 🟢 **Bright Green**: 90% or higher
+- 🟢 **Green**: 80-89%
+- 🟡 **Yellow**: 70-79%
+- 🟠 **Orange**: 60-69%
+- 🔴 **Red**: Below 60%
+
+### Using Badges with GitHub Pages
+
+The badge upload action automatically uploads badges to your GitHub Pages branch.
+
+**Automatic Setup:**
+
+- Creates the `gh-pages` branch if it doesn't exist
+- Uploads badges to the specified directory
+- Commits and pushes changes automatically
+
+**Enable GitHub Pages** in your repository settings:
+
+1. Go to Settings → Pages
+2. Set source to "Deploy from a branch"
+3. Select your `gh-pages` branch (or the branch specified in `pages-branch`)
+4. Set folder to `/ (root)` or `/badges` depending on your preference
+
+**Badge URLs** will be available at:
+
+```
+https://yourusername.github.io/yourrepo/badges/coverage.json
+https://yourusername.github.io/yourrepo/badges/statements.json
+https://yourusername.github.io/yourrepo/badges/branches.json
+https://yourusername.github.io/yourrepo/badges/functions.json
+https://yourusername.github.io/yourrepo/badges/lines.json
+```
+
+**Use in your README.md:**
+
+```markdown
+![Coverage](https://yourusername.github.io/yourrepo/badges/coverage.json)
+![Statements](https://yourusername.github.io/yourrepo/badges/statements.json)
+![Branches](https://yourusername.github.io/yourrepo/badges/branches.json)
+```
+
+### Required Permissions
+
+For basic functionality, your workflow needs:
+
+```yaml
+permissions:
+  pull-requests: write # For creating/updating PR comments
+```
+
+For GitHub Pages deployment, add:
+
+```yaml
+permissions:
+  contents: write # For uploading to GitHub Pages
+```
+
+## How It Works
+
+The action is built as a **composite action** using pure YAML and shell commands:
+
+1. **File Validation** - Checks if coverage file exists
+2. **Badge Generation** - Creates shields.io compatible JSON badges
+3. **Report Generation** - Builds formatted markdown coverage report
+4. **PR Comment** - Posts report to pull request using GitHub API
+
+### Shell Tools Used
+
+- **`jq`** - JSON parsing and data extraction
+- **`bc`** - Mathematical calculations
+- **`curl`** - GitHub API communication
+- **`bash`** - Scripting and logic
+
+### No More JavaScript Headaches
+
+- ✅ No ESM/CJS confusion
+- ✅ No module system warnings
+- ✅ No permission issues with git operations
+- ✅ No complex dependency management
+- ✅ No build/compilation steps
diff --git a/README.md b/README.md
index e32fae3..2764f6c 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # Vitest V8 JSON Coverage Summary
 
-A plugin for [Vitest](https://vitest.dev/) that generates a structured JSON coverage summary from V8 coverage data. This reporter creates a `coverage-summary.json` file with detailed coverage information for statements, branches, functions, and lines.
+A plugin for [Vitest](https://vitest.dev/) that generates a structured JSON coverage summary from V8 coverage data. This package also includes GitHub Actions for coverage reporting and badge management.
 
 ## Features
 
@@ -9,7 +9,9 @@ A plugin for [Vitest](https://vitest.dev/) that generates a structured JSON cove
 - ✅ Includes file-level and overall coverage statistics
 - ✅ Tracks uncovered lines for detailed analysis
 - ✅ Compatible with Vitest 3.0+
-- 🚀 **NEW**: GitHub Action for automatic PR coverage reporting
+- 🚀 **GitHub Actions**: Coverage reporting, badge generation, and badge upload
+- 🏷️ **Coverage Badges**: Shields.io compatible badges
+- 🔧 **Modular Design**: Separate actions for different use cases
 
 ## Installation
 
@@ -17,11 +19,53 @@ A plugin for [Vitest](https://vitest.dev/) that generates a structured JSON cove
 npm install --save-dev vitest-v8-json-coverage-summary
 ```
 
-## GitHub Action
+## GitHub Actions
 
-This package also includes a GitHub Action that automatically creates beautiful coverage reports in pull requests.
+This package includes three separate GitHub Actions that can be used independently:
 
-### Quick Start
+### 1. Coverage Reporter
+
+Creates beautiful coverage reports in pull requests.
+
+```yaml
+- name: Report Coverage
+  uses: glideapps/vitest-v8-json-coverage-summary/actions/coverage-reporter@v0.0.0-echo
+  with:
+    coverage-file: "coverage/coverage-summary.json"
+    title: "🧪 Test Coverage Report"
+    show-files: "true"
+    coverage-threshold: "80"
+```
+
+### 2. Badge Generator
+
+Generates coverage badges from coverage data.
+
+```yaml
+- name: Generate Badges
+  uses: glideapps/vitest-v8-json-coverage-summary/actions/badge-generator@v0.0.0-echo
+  with:
+    coverage-file: "coverage/coverage-summary.json"
+    badges-dir: "badges"
+```
+
+### 3. Badge Uploader
+
+Uploads badges to GitHub Pages.
+
+```yaml
+- name: Upload Badges to GitHub Pages
+  uses: glideapps/vitest-v8-json-coverage-summary/actions/badge-uploader@v0.0.0-echo
+  with:
+    coverage-file: "coverage/coverage-summary.json"
+    badges-dir: "badges"
+    pages-branch: "gh-pages"
+    generate-badges: "true"
+```
+
+## Quick Start
+
+### Basic Coverage Reporting
 
 ```yaml
 name: Coverage Report
@@ -42,38 +86,142 @@ jobs:
           node-version: "20"
       - run: npm ci
       - run: npm test
-      - uses: glideapps/vitest-v8-json-coverage-summary@v1
+      - uses: glideapps/vitest-v8-json-coverage-summary/actions/coverage-reporter@v0.0.0-echo
+        with:
+          coverage-file: "coverage/coverage-summary.json"
 ```
 
-For detailed documentation, see [ACTION_README.md](ACTION_README.md).
+### Full Workflow with Badges
 
-## Usage
+```yaml
+name: Coverage with Badges
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
 
-### Basic Setup
+permissions:
+  pull-requests: write
+  contents: write
 
-Add the reporter to your Vitest configuration:
+jobs:
+  coverage:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+      - run: npm ci
+      - run: npm test
+      - uses: glideapps/vitest-v8-json-coverage-summary/actions/coverage-reporter@v0.0.0-echo
+
+  badges:
+    if: github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    needs: coverage
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+      - run: npm ci
+      - run: npm test
+      - uses: glideapps/vitest-v8-json-coverage-summary/actions/badge-uploader@v0.0.0-echo
+        with:
+          generate-badges: "true"
+```
+
+## Action Reference
+
+### Coverage Reporter
+
+| Input                | Description                                             | Required | Default                          |
+| -------------------- | ------------------------------------------------------- | -------- | -------------------------------- |
+| `coverage-file`      | Path to the coverage summary JSON file                  | No       | `coverage/coverage-summary.json` |
+| `token`              | GitHub token for creating comments                      | No       | `${{ github.token }}`            |
+| `title`              | Title for the coverage report comment                   | No       | `📊 Coverage Report`             |
+| `show-files`         | Whether to show individual file coverage details        | No       | `true`                           |
+| `coverage-threshold` | Minimum coverage percentage to consider as good (0-100) | No       | `80`                             |
+
+### Badge Generator
+
+| Input           | Description                              | Required | Default                          |
+| --------------- | ---------------------------------------- | -------- | -------------------------------- |
+| `coverage-file` | Path to the coverage summary JSON file   | No       | `coverage/coverage-summary.json` |
+| `badges-dir`    | Directory to output the generated badges | No       | `badges`                         |
+
+### Badge Uploader
+
+| Input              | Description                                       | Required | Default                            |
+| ------------------ | ------------------------------------------------- | -------- | ---------------------------------- |
+| `coverage-file`    | Path to the coverage summary JSON file            | No       | `coverage/coverage-summary.json`   |
+| `badges-dir`       | Directory containing the badges to upload         | No       | `badges`                           |
+| `pages-branch`     | Branch to upload badges to for GitHub Pages       | No       | `gh-pages`                         |
+| `pages-badges-dir` | Directory within the pages branch to store badges | No       | `badges`                           |
+| `commit-message`   | Commit message for badge updates                  | No       | `Update coverage badges [skip ci]` |
+| `generate-badges`  | Whether to generate badges if they don't exist    | No       | `true`                             |
+
+## Badge URLs
+
+When GitHub Pages is enabled, badges are available at:
+
+```
+https://yourusername.github.io/yourrepo/badges/coverage.json
+https://yourusername.github.io/yourrepo/badges/statements.json
+https://yourusername.github.io/yourrepo/badges/branches.json
+https://yourusername.github.io/yourrepo/badges/functions.json
+https://yourusername.github.io/yourrepo/badges/lines.json
+```
+
+Use in your README.md:
+
+```markdown
+![Coverage](https://yourusername.github.io/yourrepo/badges/coverage.json)
+```
+
+## Examples
+
+See the `examples/` directory for complete workflow examples:
+
+- `coverage-only.yml` - Only coverage reporting
+- `badge-generator-only.yml` - Only badge generation
+- `badge-uploader-only.yml` - Only badge upload
+- `full-workflow.yml` - Complete workflow with all actions
+
+## Setup
+
+### Configure Vitest
 
 ```javascript
 // vitest.config.js
-import { defineConfig } from "vitest/config";
-import V8JSONSummaryReporter from "vitest-v8-json-coverage-summary";
-
-export default defineConfig({
-  test: {
-    coverage: {
-      provider: "v8",
-      reporter: ["text", "json"],
-      reportsDirectory: "./coverage",
-    },
-    reporters: ["default", new V8JSONSummaryReporter()],
+export default {
+  coverage: {
+    provider: "v8",
+    reporter: ["json-summary"],
+    reportsDirectory: "coverage",
   },
-});
+};
 ```
 
-### TypeScript Configuration
+### Enable GitHub Pages
+
+1. Go to Settings → Pages
+2. Set source to "Deploy from a branch"
+3. Select `gh-pages` branch
+4. Set folder to `/ (root)` or `/badges`
 
-```typescript
-// vitest.config.ts
+## Usage
+
+### Basic Setup
+
+Add the reporter to your Vitest configuration:
+
+```javascript
+// vitest.config.js
 import { defineConfig } from "vitest/config";
 import V8JSONSummaryReporter from "vitest-v8-json-coverage-summary";
 
diff --git a/action.yml b/action.yml
index 5aaf6d1..388da1c 100644
--- a/action.yml
+++ b/action.yml
@@ -28,5 +28,100 @@ inputs:
     default: "80"
 
 runs:
-  using: "node20"
-  main: "github-action/action.js"
+  using: "composite"
+  steps:
+    - name: Check if coverage file exists
+      shell: bash
+      run: |
+        if [ ! -f "${{ inputs.coverage-file }}" ]; then
+          echo "::error::Coverage file not found at ${{ inputs.coverage-file }}. Did you forget to add the reporter in your vitest.config.js?"
+          exit 1
+        fi
+
+    - name: Generate coverage report
+      shell: bash
+      run: |
+        # Parse coverage data
+        COVERAGE_DATA=$(cat "${{ inputs.coverage-file }}")
+
+        # Extract metrics
+        STATEMENTS=$(echo "$COVERAGE_DATA" | jq -r '.summary.statements')
+        BRANCHES=$(echo "$COVERAGE_DATA" | jq -r '.summary.branches')
+        FUNCTIONS=$(echo "$COVERAGE_DATA" | jq -r '.summary.functions')
+        LINES=$(echo "$COVERAGE_DATA" | jq -r '.summary.lines')
+
+        # Calculate average
+        AVG=$(echo "scale=1; ($STATEMENTS + $BRANCHES + $FUNCTIONS + $LINES) / 4" | bc)
+
+        # Get emoji based on threshold
+        get_emoji() {
+          local coverage=$1
+          local threshold=$2
+          if (( $(echo "$coverage >= $threshold" | bc -l) )); then
+            echo "🟢"
+          elif (( $(echo "$coverage >= $threshold * 0.8" | bc -l) )); then
+            echo "🟡"
+          else
+            echo "🔴"
+          fi
+        }
+
+        THRESHOLD="${{ inputs.coverage-threshold }}"
+        STATEMENTS_EMOJI=$(get_emoji $STATEMENTS $THRESHOLD)
+        BRANCHES_EMOJI=$(get_emoji $BRANCHES $THRESHOLD)
+        FUNCTIONS_EMOJI=$(get_emoji $FUNCTIONS $THRESHOLD)
+        LINES_EMOJI=$(get_emoji $LINES $THRESHOLD)
+        AVG_EMOJI=$(get_emoji $AVG $THRESHOLD)
+
+        # Generate markdown report
+        cat > coverage-report.md << EOF
+        ## ${{ inputs.title }}
+
+        ### 📈 Coverage Summary
+
+        | Metric | Coverage | Status |
+        |--------|----------|--------|
+        | **Statements** | ${STATEMENTS}% | $STATEMENTS_EMOJI |
+        | **Branches** | ${BRANCHES}% | $BRANCHES_EMOJI |
+        | **Functions** | ${FUNCTIONS}% | $FUNCTIONS_EMOJI |
+        | **Lines** | ${LINES}% | $LINES_EMOJI |
+
+        **Overall Coverage: ${AVG}% $AVG_EMOJI**
+        EOF
+
+        # Add file details if requested
+        if [ "${{ inputs.show-files }}" = "true" ]; then
+          echo "" >> coverage-report.md
+          echo "### 📁 File Details" >> coverage-report.md
+          echo "" >> coverage-report.md
+          echo "| File | Statements | Branches | Functions | Lines |" >> coverage-report.md
+          echo "|------|------------|----------|-----------|-------|" >> coverage-report.md
+          
+          # Extract file details
+          echo "$COVERAGE_DATA" | jq -r '.files[] | "| `\(.file | ltrimstr("./"))` | \(.statements)% | \(.branches)% | \(.functions)% | \(.lines)% |"' >> coverage-report.md
+        fi
+
+        echo "" >> coverage-report.md
+        echo "---" >> coverage-report.md
+        echo "*Generated by [@glideapps/vitest-v8-json-coverage-summary](https://github.com/glideapps/vitest-v8-json-coverage-summary)*" >> coverage-report.md
+
+        echo "📊 Generated coverage report"
+
+    - name: Comment on pull request
+      if: github.event_name == 'pull_request'
+      shell: bash
+      run: |
+        # Read the report
+        REPORT=$(cat coverage-report.md)
+
+        # Escape the report for JSON
+        REPORT_JSON=$(echo "$REPORT" | jq -Rs .)
+
+        # Create the comment
+        curl -X POST \
+          -H "Authorization: token ${{ inputs.token }}" \
+          -H "Accept: application/vnd.github.v3+json" \
+          -H "Content-Type: application/json" \
+          "https://api.github.com/repos/$GITHUB_REPOSITORY/issues/${{ github.event.pull_request.number }}/comments" \
+          -d "{\"body\":$REPORT_JSON}" \
+          -s -o /dev/null -w "%{http_code}" | grep -q "201\|200" && echo "✅ Comment posted successfully" || echo "⚠️ Failed to post comment"
diff --git a/actions/badge-generator/action.yml b/actions/badge-generator/action.yml
new file mode 100644
index 0000000..9c5f925
--- /dev/null
+++ b/actions/badge-generator/action.yml
@@ -0,0 +1,85 @@
+name: "Coverage Badge Generator"
+description: "Generates coverage badges from vitest coverage data"
+author: "Glide Apps"
+branding:
+  icon: "shield"
+  color: "blue"
+
+inputs:
+  coverage-file:
+    description: "Path to the coverage summary JSON file"
+    required: false
+    default: "coverage/coverage-summary.json"
+  badges-dir:
+    description: "Directory to output the generated badges"
+    required: false
+    default: "badges"
+
+runs:
+  using: "composite"
+  steps:
+    - name: Check if coverage file exists
+      shell: bash
+      run: |
+        if [ ! -f "${{ inputs.coverage-file }}" ]; then
+          echo "::error::Coverage file not found at ${{ inputs.coverage-file }}. Did you forget to add the reporter in your vitest.config.js?"
+          exit 1
+        fi
+
+    - name: Generate badges
+      shell: bash
+      run: |
+        # Parse coverage data
+        COVERAGE_DATA=$(cat "${{ inputs.coverage-file }}")
+
+        # Extract metrics
+        STATEMENTS=$(echo "$COVERAGE_DATA" | jq -r '.summary.statements')
+        BRANCHES=$(echo "$COVERAGE_DATA" | jq -r '.summary.branches')
+        FUNCTIONS=$(echo "$COVERAGE_DATA" | jq -r '.summary.functions')
+        LINES=$(echo "$COVERAGE_DATA" | jq -r '.summary.lines')
+
+        # Calculate average
+        AVG=$(echo "scale=1; ($STATEMENTS + $BRANCHES + $FUNCTIONS + $LINES) / 4" | bc)
+
+        # Create badges directory
+        mkdir -p ${{ inputs.badges-dir }}
+
+        # Determine badge colors
+        get_color() {
+          local coverage=$1
+          if (( $(echo "$coverage >= 90" | bc -l) )); then
+            echo "brightgreen"
+          elif (( $(echo "$coverage >= 80" | bc -l) )); then
+            echo "green"
+          elif (( $(echo "$coverage >= 70" | bc -l) )); then
+            echo "yellow"
+          elif (( $(echo "$coverage >= 60" | bc -l) )); then
+            echo "orange"
+          else
+            echo "red"
+          fi
+        }
+
+        # Generate overall coverage badge
+        COVERAGE_COLOR=$(get_color $AVG)
+        echo "{\"schemaVersion\":1,\"label\":\"coverage\",\"message\":\"$AVG%\",\"color\":\"$COVERAGE_COLOR\"}" > ${{ inputs.badges-dir }}/coverage.json
+
+        # Generate individual metric badges
+        STATEMENTS_COLOR=$(get_color $STATEMENTS)
+        echo "{\"schemaVersion\":1,\"label\":\"statements\",\"message\":\"$STATEMENTS%\",\"color\":\"$STATEMENTS_COLOR\"}" > ${{ inputs.badges-dir }}/statements.json
+
+        BRANCHES_COLOR=$(get_color $BRANCHES)
+        echo "{\"schemaVersion\":1,\"label\":\"branches\",\"message\":\"$BRANCHES%\",\"color\":\"$BRANCHES_COLOR\"}" > ${{ inputs.badges-dir }}/branches.json
+
+        FUNCTIONS_COLOR=$(get_color $FUNCTIONS)
+        echo "{\"schemaVersion\":1,\"label\":\"functions\",\"message\":\"$FUNCTIONS%\",\"color\":\"$FUNCTIONS_COLOR\"}" > ${{ inputs.badges-dir }}/functions.json
+
+        LINES_COLOR=$(get_color $LINES)
+        echo "{\"schemaVersion\":1,\"label\":\"lines\",\"message\":\"$LINES%\",\"color\":\"$LINES_COLOR\"}" > ${{ inputs.badges-dir }}/lines.json
+
+        echo "✅ Generated badges in ${{ inputs.badges-dir }}/:"
+        echo "  - coverage.json: $AVG% ($COVERAGE_COLOR)"
+        echo "  - statements.json: $STATEMENTS% ($STATEMENTS_COLOR)"
+        echo "  - branches.json: $BRANCHES% ($BRANCHES_COLOR)"
+        echo "  - functions.json: $FUNCTIONS% ($FUNCTIONS_COLOR)"
+        echo "  - lines.json: $LINES% ($LINES_COLOR)"
diff --git a/actions/badge-uploader/action.yml b/actions/badge-uploader/action.yml
new file mode 100644
index 0000000..9fa8549
--- /dev/null
+++ b/actions/badge-uploader/action.yml
@@ -0,0 +1,152 @@
+name: "Coverage Badge Uploader"
+description: "Uploads coverage badges to GitHub Pages branch"
+author: "Glide Apps"
+branding:
+  icon: "shield"
+  color: "green"
+
+inputs:
+  coverage-file:
+    description: "Path to the coverage summary JSON file (used if badges don't exist)"
+    required: false
+    default: "coverage/coverage-summary.json"
+  badges-dir:
+    description: "Directory containing the badges to upload"
+    required: false
+    default: "badges"
+  pages-branch:
+    description: "Branch to upload badges to for GitHub Pages"
+    required: false
+    default: "gh-pages"
+  pages-badges-dir:
+    description: "Directory within the pages branch to store badges"
+    required: false
+    default: "badges"
+  commit-message:
+    description: "Commit message for badge updates"
+    required: false
+    default: "Update coverage badges [skip ci]"
+  generate-badges:
+    description: "Whether to generate badges if they don't exist"
+    required: false
+    default: "true"
+
+runs:
+  using: "composite"
+  steps:
+    - name: Check if badges exist
+      shell: bash
+      run: |
+        if [ ! -d "${{ inputs.badges-dir }}" ] || [ ! -f "${{ inputs.badges-dir }}/coverage.json" ]; then
+          if [ "${{ inputs.generate-badges }}" = "true" ]; then
+            echo "⚠️ No badges found. Will generate them from coverage data."
+          else
+            echo "::error::No badges found in ${{ inputs.badges-dir }}. Set generate-badges=true or run the badge generator first."
+            exit 1
+          fi
+        else
+          echo "✅ Found existing badges in ${{ inputs.badges-dir }}/"
+        fi
+
+    - name: Generate badges if needed
+      if: inputs.generate-badges == 'true' && (inputs.badges-dir == 'badges' && !fileExists('badges/coverage.json'))
+      shell: bash
+      run: |
+        # Parse coverage data
+        COVERAGE_DATA=$(cat "${{ inputs.coverage-file }}")
+
+        # Extract metrics
+        STATEMENTS=$(echo "$COVERAGE_DATA" | jq -r '.summary.statements')
+        BRANCHES=$(echo "$COVERAGE_DATA" | jq -r '.summary.branches')
+        FUNCTIONS=$(echo "$COVERAGE_DATA" | jq -r '.summary.functions')
+        LINES=$(echo "$COVERAGE_DATA" | jq -r '.summary.lines')
+
+        # Calculate average
+        AVG=$(echo "scale=1; ($STATEMENTS + $BRANCHES + $FUNCTIONS + $LINES) / 4" | bc)
+
+        # Create badges directory
+        mkdir -p ${{ inputs.badges-dir }}
+
+        # Determine badge colors
+        get_color() {
+          local coverage=$1
+          if (( $(echo "$coverage >= 90" | bc -l) )); then
+            echo "brightgreen"
+          elif (( $(echo "$coverage >= 80" | bc -l) )); then
+            echo "green"
+          elif (( $(echo "$coverage >= 70" | bc -l) )); then
+            echo "yellow"
+          elif (( $(echo "$coverage >= 60" | bc -l) )); then
+            echo "orange"
+          else
+            echo "red"
+          fi
+        }
+
+        # Generate overall coverage badge
+        COVERAGE_COLOR=$(get_color $AVG)
+        echo "{\"schemaVersion\":1,\"label\":\"coverage\",\"message\":\"$AVG%\",\"color\":\"$COVERAGE_COLOR\"}" > ${{ inputs.badges-dir }}/coverage.json
+
+        # Generate individual metric badges
+        STATEMENTS_COLOR=$(get_color $STATEMENTS)
+        echo "{\"schemaVersion\":1,\"label\":\"statements\",\"message\":\"$STATEMENTS%\",\"color\":\"$STATEMENTS_COLOR\"}" > ${{ inputs.badges-dir }}/statements.json
+
+        BRANCHES_COLOR=$(get_color $BRANCHES)
+        echo "{\"schemaVersion\":1,\"label\":\"branches\",\"message\":\"$BRANCHES%\",\"color\":\"$BRANCHES_COLOR\"}" > ${{ inputs.badges-dir }}/branches.json
+
+        FUNCTIONS_COLOR=$(get_color $FUNCTIONS)
+        echo "{\"schemaVersion\":1,\"label\":\"functions\",\"message\":\"$FUNCTIONS%\",\"color\":\"$FUNCTIONS_COLOR\"}" > ${{ inputs.badges-dir }}/functions.json
+
+        LINES_COLOR=$(get_color $LINES)
+        echo "{\"schemaVersion\":1,\"label\":\"lines\",\"message\":\"$LINES%\",\"color\":\"$LINES_COLOR\"}" > ${{ inputs.badges-dir }}/lines.json
+
+        echo "✅ Generated badges in ${{ inputs.badges-dir }}/:"
+        echo "  - coverage.json: $AVG% ($COVERAGE_COLOR)"
+        echo "  - statements.json: $STATEMENTS% ($STATEMENTS_COLOR)"
+        echo "  - branches.json: $BRANCHES% ($BRANCHES_COLOR)"
+        echo "  - functions.json: $FUNCTIONS% ($FUNCTIONS_COLOR)"
+        echo "  - lines.json: $LINES% ($LINES_COLOR)"
+
+    - name: Upload badges to GitHub Pages
+      shell: bash
+      run: |
+        # Configure git
+        git config --local user.email "action@github.com"
+        git config --local user.name "GitHub Action"
+
+        # Create or checkout the pages branch
+        if git show-ref --verify --quiet refs/remotes/origin/${{ inputs.pages-branch }}; then
+          echo "📁 Checking out existing ${{ inputs.pages-branch }} branch"
+          git checkout ${{ inputs.pages-branch }}
+          git pull origin ${{ inputs.pages-branch }}
+        else
+          echo "🆕 Creating new ${{ inputs.pages-branch }} branch from current branch"
+          # Save badges to temporary location before cleanup
+          cp -r ${{ inputs.badges-dir }} /tmp/badges-backup
+          git checkout --orphan ${{ inputs.pages-branch }}
+          git rm -rf . || true
+        fi
+
+        # Create the badges directory for pages
+        mkdir -p ${{ inputs.pages-badges-dir }}
+
+        # Copy badges to the pages directory from backup or current location
+        if [ -d "/tmp/badges-backup" ]; then
+          cp /tmp/badges-backup/*.json ${{ inputs.pages-badges-dir }}/
+        else
+          cp ${{ inputs.badges-dir }}/*.json ${{ inputs.pages-badges-dir }}/
+        fi
+        echo "📋 Copied badges to ${{ inputs.pages-badges-dir }}/"
+
+        # Add files to staging
+        git add ${{ inputs.pages-badges-dir }}/
+
+        # Check if there are changes to commit
+        if git diff --cached --quiet; then
+          echo "ℹ️ No changes to commit"
+        else
+          # Commit and push changes
+          git commit -m "${{ inputs.commit-message }}"
+          git push origin ${{ inputs.pages-branch }}
+          echo "✅ Successfully uploaded badges to ${{ inputs.pages-branch }} branch"
+        fi
diff --git a/actions/coverage-reporter/action.yml b/actions/coverage-reporter/action.yml
new file mode 100644
index 0000000..388da1c
--- /dev/null
+++ b/actions/coverage-reporter/action.yml
@@ -0,0 +1,127 @@
+name: "Vitest Coverage Reporter"
+description: "Creates a coverage report comment in pull requests using vitest coverage data"
+author: "Glide Apps"
+branding:
+  icon: "bar-chart"
+  color: "blue"
+
+inputs:
+  coverage-file:
+    description: "Path to the coverage summary JSON file"
+    required: false
+    default: "coverage/coverage-summary.json"
+  token:
+    description: "GitHub token for creating comments"
+    required: false
+    default: "${{ github.token }}"
+  title:
+    description: "Title for the coverage report comment"
+    required: false
+    default: "📊 Coverage Report"
+  show-files:
+    description: "Whether to show individual file coverage details"
+    required: false
+    default: "true"
+  coverage-threshold:
+    description: "Minimum coverage percentage to consider as good (0-100)"
+    required: false
+    default: "80"
+
+runs:
+  using: "composite"
+  steps:
+    - name: Check if coverage file exists
+      shell: bash
+      run: |
+        if [ ! -f "${{ inputs.coverage-file }}" ]; then
+          echo "::error::Coverage file not found at ${{ inputs.coverage-file }}. Did you forget to add the reporter in your vitest.config.js?"
+          exit 1
+        fi
+
+    - name: Generate coverage report
+      shell: bash
+      run: |
+        # Parse coverage data
+        COVERAGE_DATA=$(cat "${{ inputs.coverage-file }}")
+
+        # Extract metrics
+        STATEMENTS=$(echo "$COVERAGE_DATA" | jq -r '.summary.statements')
+        BRANCHES=$(echo "$COVERAGE_DATA" | jq -r '.summary.branches')
+        FUNCTIONS=$(echo "$COVERAGE_DATA" | jq -r '.summary.functions')
+        LINES=$(echo "$COVERAGE_DATA" | jq -r '.summary.lines')
+
+        # Calculate average
+        AVG=$(echo "scale=1; ($STATEMENTS + $BRANCHES + $FUNCTIONS + $LINES) / 4" | bc)
+
+        # Get emoji based on threshold
+        get_emoji() {
+          local coverage=$1
+          local threshold=$2
+          if (( $(echo "$coverage >= $threshold" | bc -l) )); then
+            echo "🟢"
+          elif (( $(echo "$coverage >= $threshold * 0.8" | bc -l) )); then
+            echo "🟡"
+          else
+            echo "🔴"
+          fi
+        }
+
+        THRESHOLD="${{ inputs.coverage-threshold }}"
+        STATEMENTS_EMOJI=$(get_emoji $STATEMENTS $THRESHOLD)
+        BRANCHES_EMOJI=$(get_emoji $BRANCHES $THRESHOLD)
+        FUNCTIONS_EMOJI=$(get_emoji $FUNCTIONS $THRESHOLD)
+        LINES_EMOJI=$(get_emoji $LINES $THRESHOLD)
+        AVG_EMOJI=$(get_emoji $AVG $THRESHOLD)
+
+        # Generate markdown report
+        cat > coverage-report.md << EOF
+        ## ${{ inputs.title }}
+
+        ### 📈 Coverage Summary
+
+        | Metric | Coverage | Status |
+        |--------|----------|--------|
+        | **Statements** | ${STATEMENTS}% | $STATEMENTS_EMOJI |
+        | **Branches** | ${BRANCHES}% | $BRANCHES_EMOJI |
+        | **Functions** | ${FUNCTIONS}% | $FUNCTIONS_EMOJI |
+        | **Lines** | ${LINES}% | $LINES_EMOJI |
+
+        **Overall Coverage: ${AVG}% $AVG_EMOJI**
+        EOF
+
+        # Add file details if requested
+        if [ "${{ inputs.show-files }}" = "true" ]; then
+          echo "" >> coverage-report.md
+          echo "### 📁 File Details" >> coverage-report.md
+          echo "" >> coverage-report.md
+          echo "| File | Statements | Branches | Functions | Lines |" >> coverage-report.md
+          echo "|------|------------|----------|-----------|-------|" >> coverage-report.md
+          
+          # Extract file details
+          echo "$COVERAGE_DATA" | jq -r '.files[] | "| `\(.file | ltrimstr("./"))` | \(.statements)% | \(.branches)% | \(.functions)% | \(.lines)% |"' >> coverage-report.md
+        fi
+
+        echo "" >> coverage-report.md
+        echo "---" >> coverage-report.md
+        echo "*Generated by [@glideapps/vitest-v8-json-coverage-summary](https://github.com/glideapps/vitest-v8-json-coverage-summary)*" >> coverage-report.md
+
+        echo "📊 Generated coverage report"
+
+    - name: Comment on pull request
+      if: github.event_name == 'pull_request'
+      shell: bash
+      run: |
+        # Read the report
+        REPORT=$(cat coverage-report.md)
+
+        # Escape the report for JSON
+        REPORT_JSON=$(echo "$REPORT" | jq -Rs .)
+
+        # Create the comment
+        curl -X POST \
+          -H "Authorization: token ${{ inputs.token }}" \
+          -H "Accept: application/vnd.github.v3+json" \
+          -H "Content-Type: application/json" \
+          "https://api.github.com/repos/$GITHUB_REPOSITORY/issues/${{ github.event.pull_request.number }}/comments" \
+          -d "{\"body\":$REPORT_JSON}" \
+          -s -o /dev/null -w "%{http_code}" | grep -q "201\|200" && echo "✅ Comment posted successfully" || echo "⚠️ Failed to post comment"
diff --git a/badge-generator-action.yml b/badge-generator-action.yml
new file mode 100644
index 0000000..9c5f925
--- /dev/null
+++ b/badge-generator-action.yml
@@ -0,0 +1,85 @@
+name: "Coverage Badge Generator"
+description: "Generates coverage badges from vitest coverage data"
+author: "Glide Apps"
+branding:
+  icon: "shield"
+  color: "blue"
+
+inputs:
+  coverage-file:
+    description: "Path to the coverage summary JSON file"
+    required: false
+    default: "coverage/coverage-summary.json"
+  badges-dir:
+    description: "Directory to output the generated badges"
+    required: false
+    default: "badges"
+
+runs:
+  using: "composite"
+  steps:
+    - name: Check if coverage file exists
+      shell: bash
+      run: |
+        if [ ! -f "${{ inputs.coverage-file }}" ]; then
+          echo "::error::Coverage file not found at ${{ inputs.coverage-file }}. Did you forget to add the reporter in your vitest.config.js?"
+          exit 1
+        fi
+
+    - name: Generate badges
+      shell: bash
+      run: |
+        # Parse coverage data
+        COVERAGE_DATA=$(cat "${{ inputs.coverage-file }}")
+
+        # Extract metrics
+        STATEMENTS=$(echo "$COVERAGE_DATA" | jq -r '.summary.statements')
+        BRANCHES=$(echo "$COVERAGE_DATA" | jq -r '.summary.branches')
+        FUNCTIONS=$(echo "$COVERAGE_DATA" | jq -r '.summary.functions')
+        LINES=$(echo "$COVERAGE_DATA" | jq -r '.summary.lines')
+
+        # Calculate average
+        AVG=$(echo "scale=1; ($STATEMENTS + $BRANCHES + $FUNCTIONS + $LINES) / 4" | bc)
+
+        # Create badges directory
+        mkdir -p ${{ inputs.badges-dir }}
+
+        # Determine badge colors
+        get_color() {
+          local coverage=$1
+          if (( $(echo "$coverage >= 90" | bc -l) )); then
+            echo "brightgreen"
+          elif (( $(echo "$coverage >= 80" | bc -l) )); then
+            echo "green"
+          elif (( $(echo "$coverage >= 70" | bc -l) )); then
+            echo "yellow"
+          elif (( $(echo "$coverage >= 60" | bc -l) )); then
+            echo "orange"
+          else
+            echo "red"
+          fi
+        }
+
+        # Generate overall coverage badge
+        COVERAGE_COLOR=$(get_color $AVG)
+        echo "{\"schemaVersion\":1,\"label\":\"coverage\",\"message\":\"$AVG%\",\"color\":\"$COVERAGE_COLOR\"}" > ${{ inputs.badges-dir }}/coverage.json
+
+        # Generate individual metric badges
+        STATEMENTS_COLOR=$(get_color $STATEMENTS)
+        echo "{\"schemaVersion\":1,\"label\":\"statements\",\"message\":\"$STATEMENTS%\",\"color\":\"$STATEMENTS_COLOR\"}" > ${{ inputs.badges-dir }}/statements.json
+
+        BRANCHES_COLOR=$(get_color $BRANCHES)
+        echo "{\"schemaVersion\":1,\"label\":\"branches\",\"message\":\"$BRANCHES%\",\"color\":\"$BRANCHES_COLOR\"}" > ${{ inputs.badges-dir }}/branches.json
+
+        FUNCTIONS_COLOR=$(get_color $FUNCTIONS)
+        echo "{\"schemaVersion\":1,\"label\":\"functions\",\"message\":\"$FUNCTIONS%\",\"color\":\"$FUNCTIONS_COLOR\"}" > ${{ inputs.badges-dir }}/functions.json
+
+        LINES_COLOR=$(get_color $LINES)
+        echo "{\"schemaVersion\":1,\"label\":\"lines\",\"message\":\"$LINES%\",\"color\":\"$LINES_COLOR\"}" > ${{ inputs.badges-dir }}/lines.json
+
+        echo "✅ Generated badges in ${{ inputs.badges-dir }}/:"
+        echo "  - coverage.json: $AVG% ($COVERAGE_COLOR)"
+        echo "  - statements.json: $STATEMENTS% ($STATEMENTS_COLOR)"
+        echo "  - branches.json: $BRANCHES% ($BRANCHES_COLOR)"
+        echo "  - functions.json: $FUNCTIONS% ($FUNCTIONS_COLOR)"
+        echo "  - lines.json: $LINES% ($LINES_COLOR)"
diff --git a/badge-upload-action.yml b/badge-upload-action.yml
new file mode 100644
index 0000000..9fa8549
--- /dev/null
+++ b/badge-upload-action.yml
@@ -0,0 +1,152 @@
+name: "Coverage Badge Uploader"
+description: "Uploads coverage badges to GitHub Pages branch"
+author: "Glide Apps"
+branding:
+  icon: "shield"
+  color: "green"
+
+inputs:
+  coverage-file:
+    description: "Path to the coverage summary JSON file (used if badges don't exist)"
+    required: false
+    default: "coverage/coverage-summary.json"
+  badges-dir:
+    description: "Directory containing the badges to upload"
+    required: false
+    default: "badges"
+  pages-branch:
+    description: "Branch to upload badges to for GitHub Pages"
+    required: false
+    default: "gh-pages"
+  pages-badges-dir:
+    description: "Directory within the pages branch to store badges"
+    required: false
+    default: "badges"
+  commit-message:
+    description: "Commit message for badge updates"
+    required: false
+    default: "Update coverage badges [skip ci]"
+  generate-badges:
+    description: "Whether to generate badges if they don't exist"
+    required: false
+    default: "true"
+
+runs:
+  using: "composite"
+  steps:
+    - name: Check if badges exist
+      shell: bash
+      run: |
+        if [ ! -d "${{ inputs.badges-dir }}" ] || [ ! -f "${{ inputs.badges-dir }}/coverage.json" ]; then
+          if [ "${{ inputs.generate-badges }}" = "true" ]; then
+            echo "⚠️ No badges found. Will generate them from coverage data."
+          else
+            echo "::error::No badges found in ${{ inputs.badges-dir }}. Set generate-badges=true or run the badge generator first."
+            exit 1
+          fi
+        else
+          echo "✅ Found existing badges in ${{ inputs.badges-dir }}/"
+        fi
+
+    - name: Generate badges if needed
+      if: inputs.generate-badges == 'true' && (inputs.badges-dir == 'badges' && !fileExists('badges/coverage.json'))
+      shell: bash
+      run: |
+        # Parse coverage data
+        COVERAGE_DATA=$(cat "${{ inputs.coverage-file }}")
+
+        # Extract metrics
+        STATEMENTS=$(echo "$COVERAGE_DATA" | jq -r '.summary.statements')
+        BRANCHES=$(echo "$COVERAGE_DATA" | jq -r '.summary.branches')
+        FUNCTIONS=$(echo "$COVERAGE_DATA" | jq -r '.summary.functions')
+        LINES=$(echo "$COVERAGE_DATA" | jq -r '.summary.lines')
+
+        # Calculate average
+        AVG=$(echo "scale=1; ($STATEMENTS + $BRANCHES + $FUNCTIONS + $LINES) / 4" | bc)
+
+        # Create badges directory
+        mkdir -p ${{ inputs.badges-dir }}
+
+        # Determine badge colors
+        get_color() {
+          local coverage=$1
+          if (( $(echo "$coverage >= 90" | bc -l) )); then
+            echo "brightgreen"
+          elif (( $(echo "$coverage >= 80" | bc -l) )); then
+            echo "green"
+          elif (( $(echo "$coverage >= 70" | bc -l) )); then
+            echo "yellow"
+          elif (( $(echo "$coverage >= 60" | bc -l) )); then
+            echo "orange"
+          else
+            echo "red"
+          fi
+        }
+
+        # Generate overall coverage badge
+        COVERAGE_COLOR=$(get_color $AVG)
+        echo "{\"schemaVersion\":1,\"label\":\"coverage\",\"message\":\"$AVG%\",\"color\":\"$COVERAGE_COLOR\"}" > ${{ inputs.badges-dir }}/coverage.json
+
+        # Generate individual metric badges
+        STATEMENTS_COLOR=$(get_color $STATEMENTS)
+        echo "{\"schemaVersion\":1,\"label\":\"statements\",\"message\":\"$STATEMENTS%\",\"color\":\"$STATEMENTS_COLOR\"}" > ${{ inputs.badges-dir }}/statements.json
+
+        BRANCHES_COLOR=$(get_color $BRANCHES)
+        echo "{\"schemaVersion\":1,\"label\":\"branches\",\"message\":\"$BRANCHES%\",\"color\":\"$BRANCHES_COLOR\"}" > ${{ inputs.badges-dir }}/branches.json
+
+        FUNCTIONS_COLOR=$(get_color $FUNCTIONS)
+        echo "{\"schemaVersion\":1,\"label\":\"functions\",\"message\":\"$FUNCTIONS%\",\"color\":\"$FUNCTIONS_COLOR\"}" > ${{ inputs.badges-dir }}/functions.json
+
+        LINES_COLOR=$(get_color $LINES)
+        echo "{\"schemaVersion\":1,\"label\":\"lines\",\"message\":\"$LINES%\",\"color\":\"$LINES_COLOR\"}" > ${{ inputs.badges-dir }}/lines.json
+
+        echo "✅ Generated badges in ${{ inputs.badges-dir }}/:"
+        echo "  - coverage.json: $AVG% ($COVERAGE_COLOR)"
+        echo "  - statements.json: $STATEMENTS% ($STATEMENTS_COLOR)"
+        echo "  - branches.json: $BRANCHES% ($BRANCHES_COLOR)"
+        echo "  - functions.json: $FUNCTIONS% ($FUNCTIONS_COLOR)"
+        echo "  - lines.json: $LINES% ($LINES_COLOR)"
+
+    - name: Upload badges to GitHub Pages
+      shell: bash
+      run: |
+        # Configure git
+        git config --local user.email "action@github.com"
+        git config --local user.name "GitHub Action"
+
+        # Create or checkout the pages branch
+        if git show-ref --verify --quiet refs/remotes/origin/${{ inputs.pages-branch }}; then
+          echo "📁 Checking out existing ${{ inputs.pages-branch }} branch"
+          git checkout ${{ inputs.pages-branch }}
+          git pull origin ${{ inputs.pages-branch }}
+        else
+          echo "🆕 Creating new ${{ inputs.pages-branch }} branch from current branch"
+          # Save badges to temporary location before cleanup
+          cp -r ${{ inputs.badges-dir }} /tmp/badges-backup
+          git checkout --orphan ${{ inputs.pages-branch }}
+          git rm -rf . || true
+        fi
+
+        # Create the badges directory for pages
+        mkdir -p ${{ inputs.pages-badges-dir }}
+
+        # Copy badges to the pages directory from backup or current location
+        if [ -d "/tmp/badges-backup" ]; then
+          cp /tmp/badges-backup/*.json ${{ inputs.pages-badges-dir }}/
+        else
+          cp ${{ inputs.badges-dir }}/*.json ${{ inputs.pages-badges-dir }}/
+        fi
+        echo "📋 Copied badges to ${{ inputs.pages-badges-dir }}/"
+
+        # Add files to staging
+        git add ${{ inputs.pages-badges-dir }}/
+
+        # Check if there are changes to commit
+        if git diff --cached --quiet; then
+          echo "ℹ️ No changes to commit"
+        else
+          # Commit and push changes
+          git commit -m "${{ inputs.commit-message }}"
+          git push origin ${{ inputs.pages-branch }}
+          echo "✅ Successfully uploaded badges to ${{ inputs.pages-branch }} branch"
+        fi
diff --git a/badges/branches.json b/badges/branches.json
new file mode 100644
index 0000000..6f226b7
--- /dev/null
+++ b/badges/branches.json
@@ -0,0 +1,6 @@
+{
+  "schemaVersion": 1,
+  "label": "branches",
+  "message": "95.7%",
+  "color": "brightgreen"
+}
\ No newline at end of file
diff --git a/badges/coverage.json b/badges/coverage.json
new file mode 100644
index 0000000..aa9e871
--- /dev/null
+++ b/badges/coverage.json
@@ -0,0 +1,6 @@
+{
+  "schemaVersion": 1,
+  "label": "coverage",
+  "message": "84.6%",
+  "color": "green"
+}
\ No newline at end of file
diff --git a/badges/functions.json b/badges/functions.json
new file mode 100644
index 0000000..356aed9
--- /dev/null
+++ b/badges/functions.json
@@ -0,0 +1,6 @@
+{
+  "schemaVersion": 1,
+  "label": "functions",
+  "message": "62.5%",
+  "color": "orange"
+}
\ No newline at end of file
diff --git a/badges/lines.json b/badges/lines.json
new file mode 100644
index 0000000..24dca2f
--- /dev/null
+++ b/badges/lines.json
@@ -0,0 +1,6 @@
+{
+  "schemaVersion": 1,
+  "label": "lines",
+  "message": "90.2%",
+  "color": "brightgreen"
+}
\ No newline at end of file
diff --git a/badges/statements.json b/badges/statements.json
new file mode 100644
index 0000000..de47b73
--- /dev/null
+++ b/badges/statements.json
@@ -0,0 +1,6 @@
+{
+  "schemaVersion": 1,
+  "label": "statements",
+  "message": "90.2%",
+  "color": "brightgreen"
+}
\ No newline at end of file
diff --git a/example-workflow-with-badges.yml b/example-workflow-with-badges.yml
new file mode 100644
index 0000000..182d42f
--- /dev/null
+++ b/example-workflow-with-badges.yml
@@ -0,0 +1,74 @@
+name: Coverage Report with Badge Upload
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+permissions:
+  pull-requests: write
+  contents: write # Required for GitHub Pages upload
+
+jobs:
+  coverage:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests with coverage
+        run: npm test
+
+      # Coverage reporting (runs on PRs and main)
+      - name: Report Coverage
+        uses: glideapps/vitest-v8-json-coverage-summary@v0.0.0-echo
+        with:
+          coverage-file: "coverage/coverage-summary.json"
+          title: "🧪 Test Coverage Report"
+          show-files: "true"
+          coverage-threshold: "80"
+
+  # Badge generation and upload (only runs on main branch)
+  badges:
+    if: github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    needs: coverage
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # Needed for git operations
+
+      # Option 1: Use the badge upload action (generates badges automatically)
+      - name: Upload Badges to GitHub Pages
+        uses: glideapps/vitest-v8-json-coverage-summary@v0.0.0-echo
+        with:
+          action: "badge-upload-action.yml"
+          coverage-file: "coverage/coverage-summary.json"
+          badges-dir: "badges"
+          pages-branch: "gh-pages"
+          pages-badges-dir: "badges"
+          generate-badges: "true"
+
+      # Option 2: Use separate actions for more control
+      # - name: Generate Badges
+      #   uses: glideapps/vitest-v8-json-coverage-summary@v0.0.0-echo
+      #   with:
+      #     action: "badge-generator-action.yml"
+      #     coverage-file: "coverage/coverage-summary.json"
+      #     badges-dir: "badges"
+      #
+      # - name: Upload Badges to GitHub Pages
+      #   uses: glideapps/vitest-v8-json-coverage-summary@v0.0.0-echo
+      #   with:
+      #     action: "badge-upload-action.yml"
+      #     badges-dir: "badges"
+      #     pages-branch: "gh-pages"
+      #     pages-badges-dir: "badges"
+      #     generate-badges: "false"
diff --git a/example-workflow.yml b/example-workflow.yml
index 3c58823..227b274 100644
--- a/example-workflow.yml
+++ b/example-workflow.yml
@@ -5,8 +5,8 @@ on:
     branches: [main, develop]
 
 permissions:
-  contents: read
   pull-requests: write
+  contents: write # Required for GitHub Pages upload
 
 jobs:
   test-and-coverage:
@@ -34,3 +34,5 @@ jobs:
           title: "🧪 Test Coverage Report"
           show-files: "true"
           coverage-threshold: "80"
+          make-badges: "true"
+          upload-badges-to-pages: "true"
diff --git a/examples/badge-generator-only.yml b/examples/badge-generator-only.yml
new file mode 100644
index 0000000..f2166df
--- /dev/null
+++ b/examples/badge-generator-only.yml
@@ -0,0 +1,36 @@
+name: Badge Generator Only
+on:
+  push:
+    branches: [main]
+
+jobs:
+  badges:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests with coverage
+        run: npm test
+
+      # Only generate badges - no upload
+      - name: Generate Badges
+        uses: glideapps/vitest-v8-json-coverage-summary/actions/badge-generator@v0.0.0-echo
+        with:
+          coverage-file: "coverage/coverage-summary.json"
+          badges-dir: "badges"
+
+      # Optional: Upload badges as artifacts
+      - name: Upload badges as artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-badges
+          path: badges/
+          retention-days: 30
diff --git a/examples/badge-uploader-only.yml b/examples/badge-uploader-only.yml
new file mode 100644
index 0000000..3eeae5a
--- /dev/null
+++ b/examples/badge-uploader-only.yml
@@ -0,0 +1,36 @@
+name: Badge Uploader Only
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write # Required for GitHub Pages upload
+
+jobs:
+  upload-badges:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # Needed for git operations
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests with coverage
+        run: npm test
+
+      # Upload badges to GitHub Pages (generates badges automatically)
+      - name: Upload Badges to GitHub Pages
+        uses: glideapps/vitest-v8-json-coverage-summary/actions/badge-uploader@v0.0.0-echo
+        with:
+          coverage-file: "coverage/coverage-summary.json"
+          badges-dir: "badges"
+          pages-branch: "gh-pages"
+          pages-badges-dir: "badges"
+          generate-badges: "true"
diff --git a/examples/coverage-only.yml b/examples/coverage-only.yml
new file mode 100644
index 0000000..b175414
--- /dev/null
+++ b/examples/coverage-only.yml
@@ -0,0 +1,33 @@
+name: Coverage Report Only
+on:
+  pull_request:
+    branches: [main]
+
+permissions:
+  pull-requests: write
+
+jobs:
+  coverage:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests with coverage
+        run: npm test
+
+      # Only coverage reporting - no badges
+      - name: Report Coverage
+        uses: glideapps/vitest-v8-json-coverage-summary/actions/coverage-reporter@v0.0.0-echo
+        with:
+          coverage-file: "coverage/coverage-summary.json"
+          title: "🧪 Test Coverage Report"
+          show-files: "true"
+          coverage-threshold: "80"
diff --git a/examples/full-workflow.yml b/examples/full-workflow.yml
new file mode 100644
index 0000000..518dabb
--- /dev/null
+++ b/examples/full-workflow.yml
@@ -0,0 +1,62 @@
+name: Full Coverage Workflow
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+permissions:
+  pull-requests: write
+  contents: write # Required for GitHub Pages upload
+
+jobs:
+  coverage:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests with coverage
+        run: npm test
+
+      # Coverage reporting (runs on PRs and main)
+      - name: Report Coverage
+        uses: glideapps/vitest-v8-json-coverage-summary/actions/coverage-reporter@v0.0.0-echo
+        with:
+          coverage-file: "coverage/coverage-summary.json"
+          title: "🧪 Test Coverage Report"
+          show-files: "true"
+          coverage-threshold: "80"
+
+  # Badge generation and upload (only runs on main branch)
+  badges:
+    if: github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    needs: coverage
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # Needed for git operations
+
+      # Generate badges
+      - name: Generate Badges
+        uses: glideapps/vitest-v8-json-coverage-summary/actions/badge-generator@v0.0.0-echo
+        with:
+          coverage-file: "coverage/coverage-summary.json"
+          badges-dir: "badges"
+
+      # Upload badges to GitHub Pages
+      - name: Upload Badges to GitHub Pages
+        uses: glideapps/vitest-v8-json-coverage-summary/actions/badge-uploader@v0.0.0-echo
+        with:
+          badges-dir: "badges"
+          pages-branch: "gh-pages"
+          pages-badges-dir: "badges"
+          generate-badges: "false" # Use existing badges
diff --git a/github-action/action.js b/github-action/action.js
deleted file mode 100644
index 16ef73b..0000000
--- a/github-action/action.js
+++ /dev/null
@@ -1,112 +0,0 @@
-import * as core from "@actions/core";
-import * as github from "@actions/github";
-import * as fs from "fs";
-import * as path from "path";
-function getCoverageEmoji(percentage, threshold) {
-    if (percentage >= threshold)
-        return "🟢";
-    if (percentage >= threshold * 0.8)
-        return "🟡";
-    return "🔴";
-}
-function formatPercentage(value) {
-    return `${value.toFixed(1)}%`;
-}
-function generateCoverageComment(coverage, title, showFiles, threshold) {
-    const { summary, files } = coverage;
-    let comment = `## ${title}\n\n`;
-    // Summary section
-    comment += "### 📈 Coverage Summary\n\n";
-    comment += "| Metric | Coverage | Status |\n";
-    comment += "|--------|----------|--------|\n";
-    comment += `| **Statements** | ${formatPercentage(summary.statements)} | ${getCoverageEmoji(summary.statements, threshold)} |\n`;
-    comment += `| **Branches** | ${formatPercentage(summary.branches)} | ${getCoverageEmoji(summary.branches, threshold)} |\n`;
-    comment += `| **Functions** | ${formatPercentage(summary.functions)} | ${getCoverageEmoji(summary.functions, threshold)} |\n`;
-    comment += `| **Lines** | ${formatPercentage(summary.lines)} | ${getCoverageEmoji(summary.lines, threshold)} |\n\n`;
-    // Overall status
-    const avgCoverage = (summary.statements +
-        summary.branches +
-        summary.functions +
-        summary.lines) /
-        4;
-    const overallEmoji = getCoverageEmoji(avgCoverage, threshold);
-    comment += `**Overall Coverage: ${formatPercentage(avgCoverage)} ${overallEmoji}**\n\n`;
-    if (showFiles && files.length > 0) {
-        comment += "### 📁 File Details\n\n";
-        comment += "| File | Statements | Branches | Functions | Lines |\n";
-        comment += "|------|------------|----------|-----------|-------|\n";
-        files.forEach((file) => {
-            const filePath = file.file
-                .replace(process.cwd(), "")
-                .replace(/^[\/\\]/, "");
-            comment += `| \`${filePath}\` | ${formatPercentage(file.statements)} | ${formatPercentage(file.branches)} | ${formatPercentage(file.functions)} | ${formatPercentage(file.lines)} |\n`;
-        });
-    }
-    comment +=
-        "\n---\n*Generated by [@glideapps/vitest-v8-json-coverage-summary](https://github.com/glideapps/vitest-v8-json-coverage-summary)*";
-    return comment;
-}
-async function run() {
-    try {
-        const coverageFile = core.getInput("coverage-file", { required: false }) ||
-            "coverage/coverage-summary.json";
-        const token = core.getInput("token", { required: false }) || process.env.GITHUB_TOKEN;
-        const title = core.getInput("title", { required: false }) || "📊 Coverage Report";
-        const showFiles = core.getInput("show-files", { required: false }) === "true";
-        const threshold = parseInt(core.getInput("coverage-threshold", { required: false }) || "80", 10);
-        if (!token) {
-            core.setFailed("GitHub token is required");
-            return;
-        }
-        // Check if we're in a pull request
-        const context = github.context;
-        if (context.eventName !== "pull_request") {
-            core.info("Not a pull request, skipping coverage comment");
-            return;
-        }
-        // Read coverage file
-        const coverageFilePath = path.resolve(coverageFile);
-        if (!fs.existsSync(coverageFilePath)) {
-            core.setFailed(`coverage-summary.json file not found at path ${coverageFilePath}. Did you forget to add the reporter in your vitest.config.js?`);
-            return;
-        }
-        const coverageData = JSON.parse(fs.readFileSync(coverageFilePath, "utf8"));
-        // Generate comment
-        const comment = generateCoverageComment(coverageData, title, showFiles, threshold);
-        // Create GitHub client
-        const octokit = github.getOctokit(token);
-        // Find existing comment
-        const { data: comments } = await octokit.rest.issues.listComments({
-            owner: context.repo.owner,
-            repo: context.repo.repo,
-            issue_number: context.issue.number,
-        });
-        const existingComment = comments.find((comment) => comment.user?.type === "Bot" &&
-            comment.body?.includes("Generated by [@glideapps/vitest-coverage-tools]"));
-        if (existingComment) {
-            // Update existing comment
-            await octokit.rest.issues.updateComment({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                comment_id: existingComment.id,
-                body: comment,
-            });
-            core.info("Updated existing coverage comment");
-        }
-        else {
-            // Create new comment
-            await octokit.rest.issues.createComment({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                issue_number: context.issue.number,
-                body: comment,
-            });
-            core.info("Created new coverage comment");
-        }
-    }
-    catch (error) {
-        core.setFailed(error instanceof Error ? error.message : "Unknown error occurred");
-    }
-}
-run();
-//# sourceMappingURL=action.js.map
\ No newline at end of file
diff --git a/github-action/test-badges.js b/github-action/test-badges.js
new file mode 100644
index 0000000..2ef764a
--- /dev/null
+++ b/github-action/test-badges.js
@@ -0,0 +1,102 @@
+const fs = require("fs");
+const path = require("path");
+
+// Test badge generation logic (simplified version of what's in the YAML)
+function getBadgeColor(coverage) {
+  if (coverage >= 90) return "brightgreen";
+  if (coverage >= 80) return "green";
+  if (coverage >= 70) return "yellow";
+  if (coverage >= 60) return "orange";
+  return "red";
+}
+
+function generateCoverageBadge(coverage) {
+  const avgCoverage =
+    (coverage.summary.statements +
+      coverage.summary.branches +
+      coverage.summary.functions +
+      coverage.summary.lines) /
+    4;
+
+  const color = getBadgeColor(avgCoverage);
+  const message = `${avgCoverage.toFixed(1)}%`;
+
+  return {
+    schemaVersion: 1,
+    label: "coverage",
+    message: message,
+    color: color,
+  };
+}
+
+function createBadgesDirectory(coverage) {
+  try {
+    // Create badges directory
+    const badgesDir = path.join(process.cwd(), "badges");
+    if (!fs.existsSync(badgesDir)) {
+      fs.mkdirSync(badgesDir, { recursive: true });
+    }
+
+    // Generate coverage badge
+    const badgeData = generateCoverageBadge(coverage);
+    const badgePath = path.join(badgesDir, "coverage.json");
+
+    fs.writeFileSync(badgePath, JSON.stringify(badgeData, null, 2));
+    console.log(`Created coverage badge at ${badgePath}`);
+
+    // Also create individual metric badges
+    const metrics = [
+      { key: "statements", label: "statements" },
+      { key: "branches", label: "branches" },
+      { key: "functions", label: "functions" },
+      { key: "lines", label: "lines" },
+    ];
+
+    metrics.forEach((metric) => {
+      const value = coverage.summary[metric.key];
+      const color = getBadgeColor(value);
+      const badgeData = {
+        schemaVersion: 1,
+        label: metric.label,
+        message: `${value.toFixed(1)}%`,
+        color: color,
+      };
+
+      const metricBadgePath = path.join(badgesDir, `${metric.key}.json`);
+      fs.writeFileSync(metricBadgePath, JSON.stringify(badgeData, null, 2));
+      console.log(`Created ${metric.label} badge at ${metricBadgePath}`);
+    });
+
+    console.log("✅ Badges generated successfully!");
+  } catch (error) {
+    console.error(`Failed to create badges: ${error.message}`);
+  }
+}
+
+// Read the coverage data
+const coverageData = JSON.parse(
+  fs.readFileSync("./coverage/coverage-summary.json", "utf8")
+);
+
+console.log("Testing badge generation...");
+console.log("Coverage data:", JSON.stringify(coverageData.summary, null, 2));
+
+// Test badge generation
+createBadgesDirectory(coverageData);
+
+// Check if badges were created
+const badgesDir = path.join(process.cwd(), "badges");
+if (fs.existsSync(badgesDir)) {
+  console.log("\n✅ Badges directory created successfully!");
+
+  const files = fs.readdirSync(badgesDir);
+  console.log("Generated badge files:");
+  files.forEach((file) => {
+    const content = JSON.parse(
+      fs.readFileSync(path.join(badgesDir, file), "utf8")
+    );
+    console.log(`  - ${file}: ${content.message} (${content.color})`);
+  });
+} else {
+  console.log("\n❌ Badges directory was not created");
+}
diff --git a/package.json b/package.json
index 77c405f..148c6d2 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@glideapps/vitest-v8-json-coverage-summary",
-  "version": "0.0.0-quebec",
+  "version": "0.0.0-romeo",
   "description": "A plugin for vitest that generates a coverage summary in json format",
   "main": "dist/v8.json.summary.reporter.js",
   "types": "dist/v8.json.summary.reporter.d.ts",
diff --git a/test-src/lowCoverage.js b/test-src/lowCoverage.js
new file mode 100644
index 0000000..6208c90
--- /dev/null
+++ b/test-src/lowCoverage.js
@@ -0,0 +1,34 @@
+// This file has intentionally low coverage for testing purposes
+export function poorlyTestedFunction(forceBranch) {
+  // This branch is never tested unless forced
+  if (forceBranch === "unreachable") {
+    return "unreachable";
+  }
+
+  // This is the only part that gets tested
+  return "tested";
+}
+
+export function anotherPoorlyTestedFunction() {
+  // Multiple untested branches
+  const value = Math.random();
+
+  if (value < 0.3) {
+    console.log("Branch 1 - never tested");
+    return "branch1";
+  } else if (value < 0.6) {
+    console.log("Branch 2 - never tested");
+    return "branch2";
+  } else if (value < 0.9) {
+    console.log("Branch 3 - never tested");
+    return "branch3";
+  } else {
+    console.log("Branch 4 - never tested");
+    return "branch4";
+  }
+}
+
+export function untestedFunction() {
+  // This function is never called in tests
+  return "completely untested";
+}
diff --git a/test-src/lowCoverage.test.js b/test-src/lowCoverage.test.js
new file mode 100644
index 0000000..90c0762
--- /dev/null
+++ b/test-src/lowCoverage.test.js
@@ -0,0 +1,14 @@
+import { describe, test, expect } from "vitest";
+import { poorlyTestedFunction } from "./lowCoverage.js";
+
+describe("Low Coverage Tests", () => {
+  test("should return tested for the main path", () => {
+    // This only tests the main return path, not the if branch
+    expect(poorlyTestedFunction()).toBe("tested");
+  });
+
+  // Intentionally not testing:
+  // - The if branch in poorlyTestedFunction
+  // - anotherPoorlyTestedFunction (completely untested)
+  // - untestedFunction (completely untested)
+});