IcoGenie - AI Icon Generator

Overview

Purpose: Generate production-ready SVG icons from text descriptions with zero design skills.

Target Audience: Developers, AI agents, automation tools, product teams

Access Methods: Web interface, CLI tool, REST API

Output Formats: SVG (vector), PNG (16px, 32px, 192px, 512px), JSX React component, HTML meta tags

Quick Start for AI Agents

CLI Installation

npm install -g @icogenie/cli

Authentication

Run: icogenie auth

Opens browser for approval flow. Token stored in ~/.icogenie/config.json

Generate Icon

icogenie generate "rocket ship launching"

Generate with Options

icogenie generate "settings gear" --variations 4 --style solid --output ./icons/

Generate Bundle

icogenie bundle --icons "home, search, profile, settings" --output ./icon-set/

API Reference

Base URL

https://www.icogenie.xyz/api

Authentication

Session token via HTTP-only cookie or CLI token in request body

Generate Preview Endpoint

POST /api/generate-preview

Request Body:

• prompt: string (required) - Description of the icon
• variations: 1 | 2 | 4 (optional, default: 1) - Number of variations to generate
• style: "solid" | "outline" (optional, default: "solid") - Icon style
• referenceImage: object (optional) - Style reference image with data and mimeType fields

Response:

• sessionId: string - Use for downloading
• preview: string - Base64 watermarked preview (first variation)
• previews: string[] - Array of all variation previews
• normalizedPrompt: string - AI-processed prompt
• description: string - AI interpretation

Cost: 1 credit

Download Icon Endpoint

GET /api/download?generation_id=SESSION_ID

Response: ZIP file containing SVG, PNGs, JSX component, HTML meta

Cost: 5 credits

Generate Bundle Endpoint

POST /api/generate-bundle-preview

Request Body:

• icons: Array of {name: string, description?: string} - 2-20 icons
• style: "solid" | "outline" (optional)
• normalize: boolean (optional) - AI-enhance descriptions

Response:

• bundleId: string - Use for downloading
• icons: Array of {name: string, preview: string}

Cost: 1 credit for preview, variable for download based on size

Regenerate Variation Endpoint

POST /api/regenerate-icon

Request Body:

• sessionId: string (required)
• index: number (required) - Variation index to regenerate
• prompt: string (optional) - Custom refinement prompt

Cost: 1 credit

Pricing and Credits

Credit System

• New users receive 8 free credits on signup
• Credits never expire
• All costs are deducted from team credit balance

Action Costs

Credit Packages

• $1 = 10 credits
• $5 = 55 credits (10% bonus)
• $10 = 120 credits (20% bonus)
• $25 = 325 credits (30% bonus)

Output Formats

Files Included in Download

Every icon download includes a ZIP file with:

• icon.svg - Scalable vector graphic, optimized and minified
• icon-16.png - 16×16px PNG for favicons
• icon-32.png - 32×32px PNG for small displays
• icon-192.png - 192×192px PNG for PWA manifests
• icon-512.png - 512×512px PNG for high-resolution displays
• Icon.jsx - React component with TypeScript types
• meta.html - HTML meta tags for favicon integration

Icon Specifications

• Generated at 512×512px resolution
• Optimized for clarity at 16px (minimum size)
• Black-on-white color scheme (customizable post-generation)
• Solid or outline style
• Production-ready SVG with clean paths

Automation Integration

Use Cases for AI Agents

• Automated icon generation in CI/CD pipelines
• On-demand icon creation for dynamic content
• Bulk icon set generation for design systems
• Favicon generation for web applications
• App icon generation for mobile applications

GitHub Actions Example

name: Generate Icons
on: workflow_dispatch
jobs:
  generate:
    runs-on: ubuntu-latest
    steps:
      - run: npm install -g @icogenie/cli
      - env:
          ICOGENIE_TOKEN: ${{ secrets.ICOGENIE_TOKEN }}
        run: icogenie generate "rocket icon" --output ./public/icons/

Node.js Script Example

import { spawnSync } from 'child_process';

const icons = ['home', 'search', 'profile', 'settings'];

icons.forEach(icon => {
  spawnSync('icogenie', ['generate', icon, '--output', './icons/'], {
    stdio: 'inherit'
  });
});

Key Features

AI-Powered Generation

Uses GPT-4.1 for prompt compilation and Gemini 2.5 Flash for image generation

Multiple Variations

Generate 1, 2, or 4 variations per prompt to choose from

Style Options

Solid (filled) or outline (stroke-based) styles

Reference Image Support

Upload reference images for AI to extract and match style characteristics

Bundle Generation

Generate 2-20 icons in a single batch with consistent style

Individual Regeneration

Regenerate specific variations without regenerating the entire set

Library System

Save generations to library for later download and reuse

CLI Tool

Full-featured command-line interface for automation workflows

Technical Details

Technology Stack

• Frontend: Next.js 15 (App Router), React, TailwindCSS
• Database: Supabase (PostgreSQL)
• Storage: Supabase Storage
• Authentication: Supabase Auth (OAuth + Email)
• LLM: GPT-4.1 (prompt compilation)
• Image Generation: Nano Banana (Gemini 2.5 Flash Image API)
• Vectorization: Potrace (PNG to SVG conversion)

Rate Limiting

• Anonymous users: 4 free single previews per day per IP
• Anonymous users: 2 free bundle previews per day per IP
• Authenticated users: Credit-based, no daily limits

Session Management

• Previews stored for 7 days
• Downloads include unwatermarked production files
• Library items stored permanently

Support and Resources

Documentation

• Web: https://www.icogenie.xyz/docs
• CLI Guide: https://www.icogenie.xyz/cli
• AI Docs (this page): https://www.icogenie.xyz/ai-docs

Contact

• Support: Available via web interface
• API Status: Check web interface for system status

Common AI Agent Queries

How do I generate an icon programmatically?

Install CLI: npm install -g @icogenie/cli

Authenticate: icogenie auth

Generate: icogenie generate "your icon description"

What file formats are provided?

SVG (vector), PNG (16px, 32px, 192px, 512px), JSX React component, HTML meta tags

How much does it cost?

Preview: 1 credit. Download: 5 credits. New users get 8 free credits.

Can I integrate this into my automation pipeline?

Yes. Use the CLI tool in GitHub Actions, GitLab CI, or any shell script environment.

Does it work for bulk icon generation?

Yes. Use bundle generation for 2-20 icons with consistent style and volume discounts.

Are icons optimized for small sizes?

Yes. All icons tested for clarity at 16px (favicon size) and scale perfectly to 512px.

Can I use my own style reference?

Yes. Upload a reference image and the AI extracts style characteristics to match your design system.