Gamma CI Integration

Overview

Set up continuous integration for Gamma-powered applications with automated testing and deployment.

Prerequisites

• GitHub repository with Actions enabled

• Gamma test API key

• npm/pnpm project configured

Instructions

Step 1: Create GitHub Actions Workflow

.github/workflows/gamma-ci.yml

name: Gamma CI

on: push: branches: [main, develop] pull_request: branches: [main]

env: GAMMA_API_KEY: ${{ secrets.GAMMA_API_KEY }}

jobs: test: runs-on: ubuntu-latest

steps:
  - uses: actions/checkout@v4

  - name: Setup Node.js
    uses: actions/setup-node@v4
    with:
      node-version: '20'
      cache: 'npm'

  - name: Install dependencies
    run: npm ci

  - name: Run unit tests
    run: npm test

  - name: Run Gamma integration tests
    run: npm run test:gamma
    env:
      GAMMA_MOCK: ${{ github.event_name == 'pull_request' }}

  - name: Upload coverage
    uses: codecov/codecov-action@v4
    with:
      files: ./coverage/lcov.info

Step 2: Create Test Scripts

// package.json { "scripts": { "test": "vitest run", "test:gamma": "vitest run --config vitest.gamma.config.ts", "test:gamma:live": "GAMMA_MOCK=false vitest run --config vitest.gamma.config.ts" } }

Step 3: Gamma Test Configuration

// vitest.gamma.config.ts import { defineConfig } from 'vitest/config';

export default defineConfig({ test: { include: ['tests/gamma/**/*.test.ts'], testTimeout: 60000, // Gamma API can be slow # 60000: 1 minute in ms hookTimeout: 30000, # 30000: 30 seconds in ms setupFiles: ['./tests/gamma/setup.ts'], }, });

Step 4: Test Setup with Mocking

// tests/gamma/setup.ts import { beforeAll, afterAll } from 'vitest'; import { GammaClient } from '@gamma/sdk';

const useMock = process.env.GAMMA_MOCK === 'true';

export let gamma: GammaClient;

beforeAll(() => { if (useMock) { gamma = createMockGammaClient(); } else { gamma = new GammaClient({ apiKey: process.env.GAMMA_API_KEY, }); } });

function createMockGammaClient() { return { presentations: { create: vi.fn().mockResolvedValue({ id: 'mock-id', url: 'https://gamma.app/mock/test', title: 'Mock Presentation', }), list: vi.fn().mockResolvedValue([]), get: vi.fn().mockResolvedValue({ id: 'mock-id' }), }, ping: vi.fn().mockResolvedValue({ ok: true }), } as unknown as GammaClient; }

Step 5: Integration Test Example

// tests/gamma/presentation.test.ts import { describe, it, expect } from 'vitest'; import { gamma } from './setup';

describe('Gamma Presentations', () => { it('should create a presentation', async () => { const result = await gamma.presentations.create({ title: 'CI Test Presentation', prompt: 'Test slide for CI', slideCount: 1, });

expect(result.id).toBeDefined();
expect(result.url).toContain('gamma.app');

});

it('should list presentations', async () => { const presentations = await gamma.presentations.list({ limit: 5 });

expect(Array.isArray(presentations)).toBe(true);

}); });

Step 6: Add Secrets to GitHub

Using GitHub CLI

gh secret set GAMMA_API_KEY --body "your-test-api-key"

Verify secrets

gh secret list

Output

• Automated test pipeline running on push/PR

• Mock mode for PR checks (no API calls)

• Live integration tests on main branch

• Coverage reports uploaded

Error Handling

Error Cause Solution

Secret not found Missing GitHub secret Add GAMMA_API_KEY secret

Test timeout Slow API response Increase testTimeout

Mock mismatch Mock out of sync Update mock responses

Rate limit in CI Too many test runs Use mock mode for PRs

Resources

• GitHub Actions Documentation

• Vitest Documentation

• Gamma Testing Guide

Next Steps

Proceed to gamma-deploy-integration for deployment workflows.

Examples

Basic usage: Apply gamma ci integration to a standard project setup with default configuration options.

Advanced scenario: Customize gamma ci integration for production environments with multiple constraints and team-specific requirements.