CI/CD with GitHub Actions

​

Included Workflows

​

CI Workflow

​

Jobs

1. Lint - ESLint checks
2. Typecheck - TypeScript compilation
3. Test - Jest test suite
4. Build Web App - Expo web build with bundle size analysis
5. Bundle Analysis - Tree-shaking and dependency checks
6. Build Marketing - Marketing site build

# Triggered automatically on:
on:
  pull_request:
  push:
    branches: [main]

​

Deploy Workflow

​

Triggers

• Push to main → Auto-deploy web + marketing
• GitHub Release → Build + submit mobile apps to stores
• Manual dispatch → Select what to deploy

​

Required Secrets

​

Environment Secrets

​

Manual Deployment

1. Go to Actions → Deploy
2. Click Run workflow
3. Select what to deploy:
   • Deploy web app
   • Deploy marketing site
   • Build & submit iOS
   • Build & submit Android
4. Choose EAS profile (production/preview)

​

Preview Workflow

​

Features

• Web preview URL - Vercel preview deployment
• Mobile preview - EAS Update with QR code
• Marketing preview - Separate preview for marketing site
• Auto-comments - PR comments with preview URLs

​

How It Works

1. Open a PR with changes to the app
2. GitHub Actions builds a preview
3. Bot comments on PR with preview URLs
4. Scan QR code to test on mobile device

​

Setup Guide

​

1. Get Expo Token

# Login to Expo
npx expo login

# Get your token from expo.dev
# Settings → Access Tokens → Create

​

2. Configure EAS

cd apps/app
eas build:configure
eas credentials  # Set up iOS/Android certs

​

3. Set Up Vercel (Optional)

# Install Vercel CLI
npm i -g vercel

# Link project
cd apps/app
vercel link

# Get IDs from .vercel/project.json
cat .vercel/project.json

​

4. Add GitHub Secrets

​

Customization

​

Changing Deploy Triggers

on:
  push:
    branches:
      - main
      - production  # Add more branches
    paths:
      - "apps/app/**"  # Only deploy when app changes

​

Adding Custom Jobs

jobs:
  my-custom-job:
    name: Custom Job
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run custom script
        run: ./scripts/my-script.sh

​

Environment-Specific Deploys

jobs:
  deploy-staging:
    environment:
      name: staging
      url: https://staging.yourapp.com
    # Uses secrets from staging environment

​

Troubleshooting

​

Build Failing

1. Check that all secrets are set correctly
2. Verify EAS is configured: eas build:configure
3. Check build logs in EAS dashboard

​

Preview Not Working

1. Ensure VERCEL_TOKEN is valid
2. Check Vercel project is linked
3. Verify paths-filter is detecting changes

​

Mobile Submit Failing

1. Verify App Store / Play Store credentials in EAS
2. Check app version is incremented
3. Review EAS submit logs