feat: Fully Automated Setup & Cross-Platform CI/CD Pipeline

.github/workflows/ci.yml

@@ -0,0 +1,138 @@
+name: CI/CD Test
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+    paths-ignore:
+      - 'docs/**'  # Skip CI for docs-only changes
+      - '.github/workflows/deploy-pages.yml'  # Skip when only pages workflow changes
+  workflow_dispatch:
+
+jobs:
+  test-setup-scripts:
+    name: Test Setup Scripts
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Test setup script (Linux/macOS)
+        if: runner.os != 'Windows'
+        run: |
+          chmod +x setup.sh
+          # Test script syntax
+          bash -n setup.sh
+          echo "✅ Setup script syntax is valid"
+
+      - name: Test setup script (Windows)
+        if: runner.os == 'Windows'
+        run: |
+          # Test batch script syntax (basic check)
+          if (Test-Path "setup.bat") {
+            Write-Host "✅ Setup batch file exists"
+          } else {
+            Write-Host "❌ Setup batch file missing"
+            exit 1
+          }
+
+      - name: Test run script (Linux/macOS)
+        if: runner.os != 'Windows'
+        run: |
+          # Create a dummy run.sh to test
+          echo '#!/bin/bash' > test-run.sh
+          echo 'echo "Test run script"' >> test-run.sh
+          chmod +x test-run.sh
+          bash -n test-run.sh
+          echo "✅ Run script syntax is valid"
+
+  test-build:
+    name: Test Build Process
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+
+      - name: Setup Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.10'
+
+      - name: Install dependencies
+        run: |
+          npm ci
+          cd backend
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+
+      - name: Test build (Linux only)
+        run: |
+          # Test the build process without actually building
+          npm run pack
+
+      - name: Test backend
+        run: |
+          cd backend
+          python -c "import flask; print('✅ Flask import successful')"
+          python -c "import requests; print('✅ Requests import successful')"
+
+  validate-package-json:
+    name: Validate Package Configuration
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+
+      - name: Validate package.json
+        run: |
+          npm ls --depth=0 || echo "Some dependencies may be missing (expected in CI)"
+          node -e "
+            const pkg = require('./package.json');
+            console.log('✅ Package name:', pkg.name);
+            console.log('✅ Version:', pkg.version);
+            console.log('✅ Main:', pkg.main);
+            console.log('✅ Build scripts:', Object.keys(pkg.scripts).filter(s => s.startsWith('build')));
+          "
+
+  check-docs:
+    name: Check Documentation
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.2'
+          working-directory: docs
+
+      - name: Check Jekyll configuration
+        run: |
+          cd docs
+          if [ -f "Gemfile" ]; then
+            echo "✅ Gemfile exists"
+            bundle install
+            # Validate Jekyll configuration without building
+            bundle exec jekyll doctor
+            echo "✅ Jekyll configuration is valid"
+          else
+            echo "❌ Gemfile missing"
+            exit 1
+          fi

.github/workflows/deploy-pages.yml

@@ -4,52 +4,50 @@ on:
   push:
     branches: ["main"]
     paths:
-      - 'docs/**'  # Only trigger on changes to docs directory
-  # Allows you to run this workflow manually from the Actions tab
+      - 'docs/**'
+      - '.github/workflows/deploy-pages.yml'
+  release:
+    types: [published]
   workflow_dispatch:
 
-# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
 permissions:
-  contents: write       # Required for pushing to gh-pages branch
+  contents: read
   pages: write
   id-token: write
-  deployments: write   # Required for deployments
 
-# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
 concurrency:
   group: "pages"
   cancel-in-progress: false
 
 jobs:
-  # Build job
   build:
     runs-on: ubuntu-latest
-    defaults:
-      run:
-        working-directory: docs
     steps:
       - name: Checkout
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
       - name: Setup Pages
         uses: actions/configure-pages@v5
+
       - name: Setup Ruby
         uses: ruby/setup-ruby@v1
         with:
-          ruby-version: '3.1'
+          ruby-version: '3.2'
           bundler-cache: true
-          working-directory: docs
-      - name: Install dependencies
-        run: bundle install
+          working-directory: ./docs
+
       - name: Build with Jekyll
-        run: bundle exec jekyll build
+        run: |
+          cd docs
+          bundle exec jekyll build --destination ../_site
         env:
           JEKYLL_ENV: production
+
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
-        with:
-          path: docs/_site
 
-  # Deployment job
   deploy:
     environment:
       name: github-pages

.github/workflows/release.yml

@@ -0,0 +1,168 @@
+name: Build and Release
+
+on:
+  push:
+    tags:
+      - 'v*'  # Push events to matching v*, i.e. v1.0, v20.15.10
+  workflow_dispatch:  # Allow manual trigger
+
+jobs:
+  build-linux:
+    name: Build Linux Packages
+    runs-on: ubuntu-latest
+    env:
+      DEBIAN_FRONTEND: noninteractive
+      TZ: UTC
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup timezone
+        run: |
+          sudo timedatectl set-timezone UTC
+          echo "UTC" | sudo tee /etc/timezone
+          sudo dpkg-reconfigure -f noninteractive tzdata
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+
+      - name: Setup Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.10'
+
+      - name: Install dependencies
+        run: |
+          npm ci
+          cd backend
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+
+      - name: Build Linux packages
+        run: |
+          npm run build-linux
+          ls -la dist/
+
+      - name: Upload Linux artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: linux-packages
+          path: |
+            dist/*.AppImage
+            dist/*.deb
+
+  build-windows:
+    name: Build Windows Packages
+    runs-on: windows-latest
+    env:
+      TZ: UTC
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+
+      - name: Setup Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.10'
+
+      - name: Install dependencies
+        run: |
+          npm ci
+          cd backend
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+
+      - name: Build Windows packages
+        run: npm run build-win
+
+      - name: Upload Windows artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: windows-packages
+          path: dist/*.exe
+
+  build-macos:
+    name: Build macOS Packages
+    runs-on: macos-latest
+    env:
+      TZ: UTC
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+
+      - name: Setup Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.10'
+
+      - name: Install dependencies
+        run: |
+          npm ci
+          cd backend
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+
+      - name: Build macOS packages
+        run: npm run build-mac
+
+      - name: Upload macOS artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: macos-packages
+          path: dist/*.dmg
+
+  release:
+    name: Create Release
+    needs: [build-linux, build-windows, build-macos]
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/')
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: dist/
+          merge-multiple: true
+
+      - name: List artifacts
+        run: |
+          echo "Downloaded artifacts:"
+          find dist/ -type f -exec ls -lh {} \;
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v1
+        with:
+          draft: false
+          prerelease: false
+          files: dist/*
+          generate_release_notes: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -14,3 +14,10 @@ __pycache__/
 .DS_Store
 # IDE settings
 .vscode/
+# Jekyll build output and dependencies
+docs/_site/
+docs/vendor/
+docs/.bundle/
+docs/.sass-cache/
+docs/.jekyll-cache/
+docs/.jekyll-metadata