gamma-local-dev-loop

# Gamma Local Dev Loop

## Overview
Configure an efficient local development workflow with hot reload and mock responses for Gamma presentation development.

## Prerequisites
- Completed `gamma-hello-world` setup
- Node.js 18+ with nodemon or tsx
- TypeScript project (recommended)

## Instructions

### Step 1: Install Dev Dependencies
```bash
npm install -D nodemon tsx dotenv @types/node
```

### Step 2: Configure Development Script
Add to package.json:
```json
{
  "scripts": {
    "dev": "tsx watch src/index.ts",
    "dev:mock": "GAMMA_MOCK=true tsx watch src/index.ts"
  }
}
```

### Step 3: Create Mock Client
```typescript
// src/gamma-client.ts
import { GammaClient } from '@gamma/sdk';

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

export const gamma = isMock
  ? createMockClient()
  : new GammaClient({ apiKey: process.env.GAMMA_API_KEY });

function createMockClient() {
  return {
    presentations: {
      create: async (opts) => ({
        id: 'mock-123',
        url: 'https://gamma.app/mock/preview',
        title: opts.title,
      }),
    },
  };
}
```

### Step 4: Set Up Environment Files
```bash
# .env.development
GAMMA_API_KEY=your-dev-key
GAMMA_MOCK=false

# .env.test
GAMMA_MOCK=true
```

## Output
- Hot reload development server
- Mock client for offline development
- Environment-based configuration
- Fast iteration cycle

## Error Handling
| Error | Cause | Solution |
|-------|-------|----------|
| Watch Error | File permissions | Check nodemon config |
| Mock Mismatch | Mock out of sync | Update mock responses |
| Env Not Loaded | dotenv not configured | Add `import 'dotenv/config'` |

## Examples

### Watch Mode Development
```bash
npm run dev
# Changes to src/*.ts trigger automatic restart
```

### Offline Development with Mocks
```bash
npm run dev:mock
# Uses mock responses, no API calls
```

## Resources
- [tsx Documentation](https://github.com/esbuild-kit/tsx)
- [Gamma SDK Mock Guide](https://gamma.app/docs/testing)

## Next Steps
Proceed t