feat: Add GitHub Pages showcase with interactive demo

- Create comprehensive interactive demo at docs/index.html
- Add GitHub Actions workflow for automatic Pages deployment
- Include all library features: validation, generation, bulk processing
- Support for 11+ shipping carriers with live examples
- Beautiful responsive UI with Tailwind CSS
- Copy built dist files to docs/ for GitHub Pages serving

Author: niradler

.github/workflows/build.js.yml

@@ -5,24 +5,25 @@ name: Node.js CI
 
 on:
   push:
-    branches: [master]
+    branches: [master, main, v3]
   pull_request:
-    branches: [master]
+    branches: [master, main, v3]
 
 jobs:
-  build:
+  test:
     runs-on: ubuntu-latest
 
     strategy:
       matrix:
-        node-version: [14.x]
+        node-version: [16.x, 18.x, 20.x]
 
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v2
+        uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
+          cache: 'npm'
       - run: npm ci
       - run: npm run build --if-present
       - run: npm test

.github/workflows/deploy-pages.yml

@@ -0,0 +1,51 @@
+# GitHub Pages Deployment Workflow
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches: [ v3, main, master ]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+          
+      - name: Install dependencies
+        run: npm ci
+        
+      - name: Build the library
+        run: npm run build
+        
+      - name: Copy dist files to docs
+        run: cp -r dist docs/
+        
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+        
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: './docs'
+          
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

_config.yml

@@ -1 +1,9 @@
-theme: jekyll-theme-minimal
+# GitHub Pages configuration
+# Use docs/ directory for GitHub Pages
+# The index.html in docs/ will be served as the main page
+
+# Optional: If you want to use Jekyll theme for other pages
+# theme: jekyll-theme-minimal
+
+# GitHub Pages will serve docs/index.html directly
+# No Jekyll processing needed for our HTML showcase

docs/README.md

@@ -0,0 +1,50 @@
+# Tracking Number Validation - Interactive Demo
+
+This directory contains the GitHub Pages showcase for the tracking-number-validation library.
+
+## 🌐 Live Demo
+
+Visit the live demo at: [https://niradler.github.io/tracking-number-validation/](https://niradler.github.io/tracking-number-validation/)
+
+## 📁 Contents
+
+- `index.html` - The main showcase page with interactive demos
+- `dist/` - Built library files (copied from the main build process)
+
+## 🚀 Features Demonstrated
+
+The interactive demo showcases all the library features:
+
+1. **Basic Validation** - Test tracking numbers and see results
+2. **Courier Detection** - Automatically identify shipping carriers
+3. **URL Generation** - Get tracking URLs for validated numbers
+4. **Bulk Validation** - Validate multiple tracking numbers at once
+5. **Pattern Injection** - Add custom patterns to existing couriers
+6. **Number Generation** - Generate valid tracking numbers for testing
+
+## 🔧 Local Development
+
+To run this locally:
+
+1. Build the library: `pnpm build`
+2. Copy dist files: `cp -r dist docs/`
+3. Serve the docs directory with any static file server
+
+## 📦 Supported Carriers
+
+The demo supports all 11+ carriers including:
+- UPS
+- FedEx
+- USPS
+- DHL
+- Amazon
+- OnTrac
+- Canada Post
+- China Post
+- Australia Post
+- Royal Mail
+- And more...
+
+## 🛠 GitHub Pages Deployment
+
+This site is automatically deployed to GitHub Pages via GitHub Actions whenever changes are pushed to the main branch.

docs/index.html

@@ -525,7 +525,7 @@ <h3 class="text-2xl font-bold mb-4">Ready to Get Started?</h3>
     </footer>
 
     <!-- Load the tracking validation library -->
-    <script src="../dist/index.js"></script>
+    <script src="./dist/index.js"></script>
 
     <!-- Custom JavaScript for interactivity -->
     <script>