Logo Creator

A web app for generating logo design concepts using OpenAI's image generation API (gpt-image-1 / DALL-E 3). Each logo comes with AI-generated design rationale, and results are compiled into a professional PDF brief.

Features

• Multiple logo styles - Automatically cycles through 10 different design approaches (wordmark, symbol, combination, emblem, lettermark, mascot, negative-space, geometric, hand-drawn, 3D)
• AI explanations - GPT-4o-mini analyzes each logo and writes professional design rationale
• PDF briefs - Compiles all logos with explanations into a downloadable PDF
• Session persistence - SQLite database stores all sessions for later review
• Incremental generation - Add more variants to existing sessions
• API health check - Validates OpenAI API access before generating

Quick Start

# Install dependencies
bun install

# Create .env with your OpenAI API key
cp .env.example .env
# Edit .env and add your OPENAI_API_KEY

# Start the web server
bun run dev

# Open http://localhost:3000

Usage

1. Enter your business name and description
2. Optionally specify style preferences and colors
3. Choose number of variants (3 recommended to start)
4. Click "Generate Logos"
5. View generated logos with expandable design explanations
6. Download PDF brief or add more variants

Project Structure

logo-creator/
├── server.ts                 # Bun.serve() web server
├── index.ts                  # CLI entry point (alternative)
├── index.html                # HTML entry point
├── src/
│   ├── frontend/
│   │   ├── App.tsx           # React UI with sidebar
│   │   ├── main.tsx          # React entry
│   │   └── styles.css        # Styling
│   ├── api.ts                # Session/job management
│   ├── db.ts                 # SQLite database (bun:sqlite)
│   ├── health.ts             # API health checks
│   ├── types.ts              # TypeScript interfaces
│   ├── openai.ts             # OpenAI client (lazy-loaded)
│   ├── logo-generator.ts     # Image generation
│   ├── explanation-generator.ts  # GPT-4o vision analysis
│   └── pdf-generator.ts      # PDF compilation
├── output/                   # Generated files (per session)
├── logo-creator.db           # SQLite database
└── docs/dev/                 # Technical documentation

Environment Variables

Variable	Required	Description
OPENAI_API_KEY	Yes	OpenAI API key with access to Images API

Bun automatically loads .env files.

Scripts

bun run dev      # Start with HMR (hot module replacement)
bun run start    # Start without HMR
bun run cli      # Run CLI version

Tech Stack

• Runtime: Bun
• Frontend: React 19
• Backend: Bun.serve() with routes
• Database: bun:sqlite (SQLite)
• PDF: pdf-lib
• AI: OpenAI API (gpt-image-1, gpt-4o-mini)

License

MIT - see LICENSE