Add documentation site with GitHub Pages auto-deploy

.githooks/pre-commit

@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_ROOT="$(git rev-parse --show-toplevel)"
+cd "$REPO_ROOT"
+
+mapfile -t STAGED_DART_FILES < <(
+  git diff --cached --name-only --diff-filter=ACMR \
+    | grep -E '^apps/mobile/.*\.dart$' \
+    | grep -Ev '\.(g|freezed)\.dart$' \
+    || true
+)
+
+mapfile -t STAGED_BRIDGE_FILES < <(
+  git diff --cached --name-only --diff-filter=ACMR \
+    | grep -E '^packages/bridge/' \
+    | grep -Ev '^packages/bridge/(dist|node_modules)/' \
+    | grep -E '\.(ts|js|cjs|mjs|json)$' \
+    || true
+)
+
+if [[ ${#STAGED_DART_FILES[@]} -eq 0 && ${#STAGED_BRIDGE_FILES[@]} -eq 0 ]]; then
+  echo "pre-commit: no staged mobile or bridge source files found; skipping checks."
+  exit 0
+fi
+
+if [[ ${#STAGED_DART_FILES[@]} -gt 0 ]]; then
+  echo "pre-commit: formatting staged Dart files"
+  dart format "${STAGED_DART_FILES[@]}"
+  git add "${STAGED_DART_FILES[@]}"
+
+  ANALYZE_TARGETS=()
+  for file in "${STAGED_DART_FILES[@]}"; do
+    ANALYZE_TARGETS+=("${file#apps/mobile/}")
+  done
+
+  echo "pre-commit: analyzing staged Dart files"
+  pushd apps/mobile > /dev/null
+  flutter analyze "${ANALYZE_TARGETS[@]}"
+  popd > /dev/null
+fi
+
+if [[ ${#STAGED_BRIDGE_FILES[@]} -gt 0 ]]; then
+  if [[ ! -d packages/bridge/node_modules ]]; then
+    echo "pre-commit: packages/bridge/node_modules is missing. Run 'cd packages/bridge && npm ci' first." >&2
+    exit 1
+  fi
+
+  BRIDGE_RELATIVE_FILES=()
+  for file in "${STAGED_BRIDGE_FILES[@]}"; do
+    BRIDGE_RELATIVE_FILES+=("${file#packages/bridge/}")
+  done
+
+  echo "pre-commit: formatting staged bridge files"
+  pushd packages/bridge > /dev/null
+  npm exec prettier -- --write "${BRIDGE_RELATIVE_FILES[@]}"
+  popd > /dev/null
+  git add "${STAGED_BRIDGE_FILES[@]}"
+
+  echo "pre-commit: typechecking bridge"
+  pushd packages/bridge > /dev/null
+  npm run typecheck
+
+  echo "pre-commit: running bridge tests"
+  npm run test:ci
+
+  echo "pre-commit: building bridge"
+  npm run build
+  popd > /dev/null
+fi

.github/workflows/deploy.yml

@@ -0,0 +1,164 @@
+name: Deploy
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      environment:
+        description: "Deployment environment"
+        required: true
+        default: staging
+        type: choice
+        options:
+          - staging
+          - production
+
+jobs:
+  build-android:
+    name: Build Android
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: apps/mobile
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Java
+        uses: actions/setup-java@v4
+        with:
+          java-version: "17"
+          distribution: temurin
+
+      - name: Set up Flutter
+        uses: subosito/flutter-action@v2
+        with:
+          flutter-version: "3.22.x"
+          channel: stable
+          cache: true
+
+      - name: Install dependencies
+        run: flutter pub get
+
+      - name: Run code generation
+        run: dart run build_runner build --delete-conflicting-outputs
+
+      - name: Decode keystore
+        run: |
+          echo "${{ secrets.ANDROID_KEYSTORE_BASE64 }}" | base64 --decode > android/app/keystore.jks
+
+      - name: Build App Bundle
+        env:
+          KEYSTORE_PASSWORD: ${{ secrets.ANDROID_KEYSTORE_PASSWORD }}
+          KEY_ALIAS: ${{ secrets.ANDROID_KEY_ALIAS }}
+          KEY_PASSWORD: ${{ secrets.ANDROID_KEY_PASSWORD }}
+        run: flutter build appbundle --release
+
+      - name: Upload AAB artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: android-release
+          path: apps/mobile/build/app/outputs/bundle/release/app-release.aab
+
+  build-ios:
+    name: Build iOS
+    runs-on: macos-latest
+    defaults:
+      run:
+        working-directory: apps/mobile
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Flutter
+        uses: subosito/flutter-action@v2
+        with:
+          flutter-version: "3.22.x"
+          channel: stable
+          cache: true
+
+      - name: Install Ruby + Fastlane
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+
+      - name: Install dependencies
+        run: flutter pub get
+
+      - name: Run code generation
+        run: dart run build_runner build --delete-conflicting-outputs
+
+      - name: Fastlane — certificates
+        working-directory: .
+        env:
+          MATCH_GIT_URL: ${{ secrets.MATCH_GIT_URL }}
+          MATCH_PASSWORD: ${{ secrets.MATCH_PASSWORD }}
+          FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD: ${{ secrets.FASTLANE_APP_PASSWORD }}
+        run: bundle exec fastlane ios certificates
+
+      - name: Fastlane — build
+        working-directory: .
+        env:
+          MATCH_GIT_URL: ${{ secrets.MATCH_GIT_URL }}
+          MATCH_PASSWORD: ${{ secrets.MATCH_PASSWORD }}
+        run: bundle exec fastlane ios build
+
+      - name: Upload IPA artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ios-release
+          path: apps/mobile/build/ios/iphoneos/Runner.app
+
+  deploy-android:
+    name: Deploy Android
+    runs-on: ubuntu-latest
+    needs: build-android
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download AAB
+        uses: actions/download-artifact@v4
+        with:
+          name: android-release
+
+      - name: Install Ruby + Fastlane
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+
+      - name: Deploy to Play Store
+        env:
+          SUPPLY_JSON_KEY: ${{ secrets.GOOGLE_PLAY_JSON_KEY }}
+        run: bundle exec fastlane android deploy
+
+  deploy-ios:
+    name: Deploy iOS
+    runs-on: macos-latest
+    needs: build-ios
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download IPA
+        uses: actions/download-artifact@v4
+        with:
+          name: ios-release
+
+      - name: Install Ruby + Fastlane
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+
+      - name: Deploy to TestFlight
+        env:
+          FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD: ${{ secrets.FASTLANE_APP_PASSWORD }}
+          FASTLANE_SESSION: ${{ secrets.FASTLANE_SESSION }}
+        run: bundle exec fastlane ios testflight

.github/workflows/docs.yml

@@ -0,0 +1,56 @@
+name: Deploy Docs to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "docs-site/**"
+      - ".github/workflows/docs.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    name: Deploy
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Configure GitHub Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload docs-site as Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs-site
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+
+  update-repo:
+    name: Update repo metadata
+    runs-on: ubuntu-latest
+    needs: deploy
+    permissions:
+      contents: read
+    steps:
+      - name: Set homepage URL and description
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          gh repo edit RecursiveDev/ReCursor \
+            --homepage "https://recursivedev.github.io/ReCursor" \
+            --description "Mobile-first companion UI for AI coding workflows - Flutter app with OpenCode-like UX, Claude Code Hooks integration, and Agent SDK support"