docs: New documentation site!

.eslintrc.js

@@ -4,6 +4,7 @@ module.exports = {
     es2017: true,
     node: true,
   },
+  ignorePatterns: ['docs/**'],
   parser: '@typescript-eslint/parser',
   plugins: ['@typescript-eslint'],
   extends: [

.github/workflows/build.yml

@@ -61,8 +61,15 @@ jobs:
         run: ./dist/craft --help
       - name: NPM Pack
         run: npm pack
-      - name: Docs
-        run: cd docs && zip -r ../gh-pages _site/
+      - name: Build Docs
+        working-directory: docs
+        run: |
+          yarn install --frozen-lockfile
+          yarn build
+      - name: Package Docs
+        run: |
+          cp .nojekyll docs/dist/
+          cd docs/dist && zip -r ../../gh-pages.zip .
       - name: Archive Artifacts
         uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
         with:

.github/workflows/docs-preview.yml

@@ -0,0 +1,69 @@
+name: Docs Preview
+
+on:
+  pull_request:
+    paths:
+      - 'docs/**'
+      - '.github/workflows/docs-preview.yml'
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  preview:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+
+      - name: Build Docs for Preview
+        working-directory: docs
+        env:
+          # Override base path for PR preview
+          DOCS_BASE_PATH: /craft/pr-preview/pr-${{ github.event.pull_request.number }}
+        run: |
+          yarn install --frozen-lockfile
+          yarn build
+
+      - name: Ensure .nojekyll at gh-pages root
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+          # Try to fetch the gh-pages branch
+          if git fetch origin gh-pages:gh-pages 2>/dev/null; then
+            # Branch exists remotely, check if .nojekyll is present
+            if git show gh-pages:.nojekyll &>/dev/null; then
+              echo ".nojekyll already exists at gh-pages root"
+            else
+              echo "Adding .nojekyll to existing gh-pages branch"
+              git checkout gh-pages
+              touch .nojekyll
+              git add .nojekyll
+              git commit -m "Add .nojekyll to disable Jekyll processing"
+              git push origin gh-pages
+              git checkout -
+            fi
+          else
+            # Branch doesn't exist, create it as an orphan branch
+            echo "Creating gh-pages branch with .nojekyll"
+            git checkout --orphan gh-pages
+            git rm -rf .
+            touch .nojekyll
+            git add .nojekyll
+            git commit -m "Initialize gh-pages with .nojekyll"
+            git push origin gh-pages
+            git checkout -
+          fi
+
+      - name: Deploy Preview
+        uses: rossjrw/pr-preview-action@v1
+        with:
+          source-dir: docs/dist/
+          preview-branch: gh-pages
+          umbrella-dir: pr-preview
+          action: auto

.gitignore

@@ -2,6 +2,11 @@ coverage/
 dist/
 node_modules/
 
+# Docs build artifacts
+docs/dist/
+docs/node_modules/
+docs/.astro/
+
 yarn-error.log
 npm-debug.log
 

Dockerfile

@@ -44,8 +44,6 @@ RUN apt-get -qq update \
   && apt-get clean \
   && rm -rf /var/lib/apt/lists/*
 
-COPY Gemfile Gemfile.lock ./
-
 RUN python3 -m venv /venv && pip install twine==6.1.0 pkginfo==1.12.1.2 --no-cache
 
 RUN : \
@@ -78,7 +76,8 @@ RUN : \
   && curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s --  --profile minimal -y \
   && cargo --version \
   && cargo install cargo-hack \
-  && gem install -g --no-document \
+  # Pin CocoaPods version to avoid bugs like https://github.com/CocoaPods/CocoaPods/issues/12081
+  && gem install cocoapods -v 1.16.2 --no-document \
   # Install https://github.com/getsentry/symbol-collector
   && symbol_collector_url=$(curl -s https://api.github.com/repos/getsentry/symbol-collector/releases/tags/1.17.0 | \
   jq -r '.assets[].browser_download_url | select(endswith("symbolcollector-console-linux-x64.zip"))') \