docs: setup GitHub Pages with Jekyll

- Rename INDEX.md to index.md (lowercase for GitHub Pages)
- Add Jekyll configuration (_config.yml) with Cayman theme
- Add GitHub Actions workflow for automatic deployment
- Create docs/README.md with setup instructions
- Update all internal links to work with GitHub Pages
- Add Jekyll front matter to index.md
- Configure navigation and documentation structure

Documentation will be available at: https://xpodev.github.io/react-pkl/

To enable GitHub Pages:
1. Go to repository Settings > Pages
2. Set Source to 'GitHub Actions'
3. The workflow will automatically deploy on push to main/master

Author: binyamin555

.github/workflows/pages.yml

@@ -0,0 +1,57 @@
+name: Deploy Documentation to GitHub Pages
+
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches: ["main", "master"]
+    paths:
+      - 'docs/**'
+      - 'README.md'
+      - '.github/workflows/pages.yml'
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  # Build job
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+        
+      - name: Build with Jekyll
+        uses: actions/jekyll-build-pages@v1
+        with:
+          source: ./docs
+          destination: ./_site
+          
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+
+  # Deployment job
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

docs/README.md

@@ -0,0 +1,68 @@
+# React PKL Documentation
+
+This directory contains the comprehensive documentation for React PKL.
+
+## 📖 View Documentation
+
+**Online:** Visit [https://xpodev.github.io/react-pkl/](https://xpodev.github.io/react-pkl/)
+
+**Locally:** Browse the markdown files in this directory.
+
+## 📚 Available Documentation
+
+- **[index.md](./index.md)** - Documentation index and navigation
+- **[GETTING_STARTED.md](./GETTING_STARTED.md)** - Step-by-step guide for beginners
+- **[API.md](./API.md)** - Complete API reference
+- **[EXAMPLES.md](./EXAMPLES.md)** - Example walkthrough
+- **[QUICK_REFERENCE.md](./QUICK_REFERENCE.md)** - Quick reference guide
+- **[ADVANCED.md](./ADVANCED.md)** - Advanced usage patterns
+- **[THEME_SYSTEM.md](./THEME_SYSTEM.md)** - Theme system guide
+- **[ARCHITECTURE.md](./ARCHITECTURE.md)** - Architecture overview
+- **[CONTRIBUTING.md](./CONTRIBUTING.md)** - Contribution guidelines
+
+## 🚀 Quick Start
+
+If you're new to React PKL:
+
+1. Read the [main README](../README.md) for project overview
+2. Follow the [Getting Started Guide](./GETTING_STARTED.md)
+3. Explore the [Examples](./EXAMPLES.md)
+
+## 🔧 GitHub Pages Setup
+
+This documentation is configured for GitHub Pages using Jekyll:
+
+- **Theme:** Cayman (defined in `_config.yml`)
+- **Configuration:** See `_config.yml` for settings
+- **Base URL:** `/react-pkl`
+
+### Local Preview
+
+To preview the documentation locally with Jekyll:
+
+```bash
+# Install Jekyll (if not already installed)
+gem install bundler jekyll
+
+# Serve the documentation
+cd docs
+jekyll serve
+```
+
+Then visit `http://localhost:4000/react-pkl/`
+
+## 📝 Contributing to Documentation
+
+When updating documentation:
+
+1. Follow markdown best practices
+2. Keep examples up-to-date with code
+3. Cross-reference related topics
+4. Test links work correctly
+5. Use clear, concise language
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for more details.
+
+## 📄 License
+
+Same as the main project - see [../LICENSE](../LICENSE) if available.

docs/_config.yml

@@ -0,0 +1,66 @@
+# GitHub Pages Jekyll Configuration for React PKL Documentation
+
+# Site settings
+title: React PKL
+description: A typesafe plugin system for React applications
+baseurl: "/react-pkl"
+url: "https://xpodev.github.io"
+
+# Build settings
+theme: jekyll-theme-cayman
+markdown: kramdown
+kramdown:
+  input: GFM
+  syntax_highlighter: rouge
+
+# Navigation
+navigation:
+  - title: Home
+    url: /
+  - title: Getting Started
+    url: /GETTING_STARTED
+  - title: API Reference
+    url: /API
+  - title: Examples
+    url: /EXAMPLES
+  - title: Architecture
+    url: /ARCHITECTURE
+  - title: Theme System
+    url: /THEME_SYSTEM
+
+# Exclude from processing
+exclude:
+  - node_modules/
+  - vendor/
+  - .git/
+  - .gitignore
+  - package.json
+  - package-lock.json
+  - tsconfig.json
+  - README.md
+
+# Include
+include:
+  - _config.yml
+
+# Plugins
+plugins:
+  - jekyll-optional-front-matter
+  - jekyll-readme-index
+  - jekyll-relative-links
+  - jekyll-titles-from-headings
+
+# Optional front matter
+optional_front_matter:
+  remove_originals: false
+
+# Relative links
+relative_links:
+  enabled: true
+  collections: false
+
+# Titles from headings
+titles_from_headings:
+  enabled: true
+  strip_title: true
+  collections: false