ideogram-local-dev-loop

# Ideogram Local Dev Loop ## Overview Set up a fast, reproducible local development workflow for Ideogram. ## Prerequisites - Completed `ideogram-install-auth` setup - Node.js 18+ with npm/pnpm - Code editor with TypeScript support - Git for version control ## Instructions ### Step 1: Create Project Structure ``` my-ideogram-project/ ├── src/ │ ├── ideogram/ │ │ ├── client.ts # Ideogram client wrapper │ │ ├── config.ts # Configuration management │ │ └── utils.ts # Helper functions │ └── index.ts ├── tests/ │ └── ideogram.test.ts ├── .env.local # Local secrets (git-ignored) ├── .env.example # Template for team └── package.json ``` ### Step 2: Configure Environment ```bash # Copy environment template cp .env.example .env.local # Install dependencies npm install # Start development server npm run dev ``` ### Step 3: Setup Hot Reload ```json { "scripts": { "dev": "tsx watch src/index.ts", "test": "vitest", "test:watch": "vitest --watch" } } ``` ### Step 4: Configure Testing ```typescript import { describe, it, expect, vi } from 'vitest'; import { IdeogramClient } from '../src/ideogram/client'; describe('Ideogram Client', () => { it('should initialize with API key', () => { const client = new IdeogramClient({ apiKey: 'test-key' }); expect(client).toBeDefined(); }); }); ``` ## Output - Working development environment with hot reload - Configured test suite with mocking - Environment variable management - Fast iteration cycle for Ideogram development ## Error Handling | Error | Cause | Solution | |-------|-------|----------| | Module not found | Missing dependency | Run `npm install` | | Port in use | Another process | Kill process or change port | | Env not loaded | Missing .env.local | Copy from .env.example | | Test timeout | Slow network | Increase test timeout | ## Examples ### Mock Ideogram Responses ```typescript vi.mock('@ideogram/sdk', () => ({ IdeogramClient: vi.fn().mockImplementation(() => ({ // Mock methods here })), })); ``` ### Debug Mode ```bash # Enable verbose logging DEBUG=IDEOGRAM=* npm run dev ``` ## Resources - [Ideogram SDK Reference](https://docs.ideogram.com/sdk) - [Vitest Documentation](https://vitest.dev/) - [tsx Documentation](https://github.com/esbuild-kit/tsx) ## Next Steps See `ideogram-sdk-patterns` for production-ready code patterns.