Skip to content

icon generator for developers who need custom icons that actually match their specific use case rather than generic ones.

License

Notifications You must be signed in to change notification settings

arnesssr/Creaticon

Repository files navigation

Creaticon 🎨

Creaticon - AI-Powered Icon & UI Creation Studio

AI-Powered Design Studio for generating beautiful UI components and icon packs

Overview

Creaticon is a simple AI-driven tool for generating beautiful UI components and icon packs. ( note: still under developmentl)

✨ Key Features

🎨 Icon Generation

  • AI-Powered Icon Creation: Generate custom SVG icon packs from descriptions
  • Multiple Formats: Convert SVG icons to PNG, JPG, WebP, and ICO formats
  • Size Flexibility: Generate icons in multiple sizes (16px to 512px)
  • Color Customization: Preview and download icons in any color
  • Bulk Export: Download complete icon packs as ZIP files
  • Professional Quality: Vector-based SVG icons with clean, scalable designs

πŸ–ΌοΈ UI Component Generation

  • Component Creation: Generate complete UI components from descriptions
  • Live Preview: Real-time preview with iframe rendering
  • Multi-Format Export: Download HTML, CSS, and JavaScript separately
  • Complete Packages: Get organized ZIP files with all assets
  • Modern Styling: Generated with Tailwind CSS and modern web standards

πŸ”§ Advanced Features

  • Multi-Provider AI: Choose between OpenAI, Anthropic, Google Gemini, OpenRouter, and Hugging Face
  • Smart Provider Selection: Automatic fallbacks and intelligent load balancing
  • API Key Management: Secure local storage with easy configuration interface
  • Format Conversion: Convert SVG icons to multiple image formats
  • Custom Sizing: Support for custom icon sizes up to 2048px
  • Quality Control: Adjustable compression for JPG/WebP formats
  • Background Colors: Customizable backgrounds for non-transparent formats
  • Batch Processing: Convert multiple formats and sizes simultaneously
  • Smart Loading: Real-time loading animations during generation

πŸš€ Getting Started

Prerequisites

  • Node.js (v16 or higher)
  • npm or yarn

Installation

# Clone the repository
git clone https://github.com/your-username/creaticon.git

# Navigate to the project directory
cd creaticon

# Install dependencies
npm install

# Start the development server
npm run dev

Environment Setup

Create a .env file in the root directory and add your AI provider API keys. You only need to configure the providers you want to use:

# OpenRouter API Key (Recommended - access to multiple models)
VITE_OPENROUTER_API_KEY=sk-or-v1-your-openrouter-api-key

# OpenAI API Key (GPT-4, GPT-3.5)
VITE_OPENAI_API_KEY=sk-your-openai-api-key

# Anthropic API Key (Claude Sonnet, Claude Haiku)
VITE_ANTHROPIC_API_KEY=sk-ant-your-anthropic-api-key

# Google Gemini API Key
VITE_GEMINI_API_KEY=your-gemini-api-key

# Hugging Face API Key (Open-source models)
VITE_HUGGINGFACE_API_KEY=hf_your-huggingface-token

πŸ“± Usage

  1. Choose Generation Type: Select between Icon Pack or UI Component
  2. Describe Your Vision: Enter a detailed description of what you want to create
  3. Generate: Click send and watch the AI create your designs
  4. Customize: Adjust colors, sizes, and preview your creations
  5. Download: Export individual files or complete packages

Icon Generation Examples

"Create a set of e-commerce icons including shopping cart, heart, user profile, search, and payment icons in a modern flat style"

"Design minimalist social media icons for Facebook, Twitter, Instagram, LinkedIn, and YouTube with rounded corners"

UI Component Examples

"Create a modern login form with gradient background, social login buttons, and smooth animations"

"Design a dashboard card showing user statistics with charts and modern styling"

πŸ€– AI Providers

Creaticon supports multiple AI providers to give you the best generation experience:

🟑 OpenRouter (Recommended)

  • Model: DeepSeek V3
  • Strengths: Fast, creative, access to latest models
  • Best for: General UI and icon generation
  • Get API Key: OpenRouter Console

🟒 OpenAI

  • Models: GPT-4, GPT-3.5 Turbo
  • Strengths: Reliable, high-quality outputs
  • Best for: Professional components and detailed icons
  • Get API Key: OpenAI API

🟣 Anthropic Claude

  • Models: Claude 3 Sonnet, Claude 3 Haiku
  • Strengths: Thoughtful design, excellent UX focus
  • Best for: User-centered design and accessibility
  • Get API Key: Anthropic Console

πŸ”΅ Google Gemini

  • Model: Gemini Pro
  • Strengths: Creative solutions, modern patterns
  • Best for: Innovative UI concepts
  • Get API Key: Google AI Studio

πŸ€— Hugging Face

  • Model: DeepSeek Coder
  • Strengths: Open-source, code enhancement
  • Best for: Styling improvements and fallback
  • Get API Key: Hugging Face Hub

πŸ› οΈ Technologies

  • Frontend: React 18, TypeScript, Vite
  • Styling: Tailwind CSS, shadcn/ui components
  • AI Integration: Multiple providers with intelligent fallbacks
  • File Processing: JSZip, File-Saver, Canvas API
  • Animations: CSS animations, React transitions
  • Format Support: SVG, PNG, JPG, WebP, ICO

🎯 Features in Detail

Icon Conversion

  • Multiple Formats: Convert SVG to PNG, JPG, WebP, ICO
  • Flexible Sizing: Any size from 16px to 2048px
  • Quality Control: Adjustable compression for lossy formats
  • Batch Export: Generate multiple formats/sizes simultaneously
  • Custom Colors: Preview and export in any color scheme

UI Components

  • Live Preview: Real-time iframe rendering
  • Complete Export: HTML, CSS, JavaScript files
  • Modern Standards: Tailwind CSS, responsive design
  • Package Downloads: Organized ZIP files with documentation

πŸš€ Deployment

Build for Production

npm run build

Deploy to Vercel

npm install -g vercel
vercel

Deploy to Netlify

  1. Build the project: npm run build
  2. Upload the dist folder to Netlify
  3. Configure environment variables in Netlify dashboard

🀝 Contributing

We love contributions! This project is completely open source and welcomes contributions from everyone.

Ways to Contribute

  • πŸ› Bug Reports: Found a bug? Open an issue!
  • πŸ’‘ Feature Requests: Have an idea? We'd love to hear it!
  • πŸ”§ Code Contributions: Submit PRs for bug fixes or new features
  • πŸ“– Documentation: Help improve our docs
  • 🎨 Design: Contribute to UI/UX improvements
  • πŸ§ͺ Testing: Add tests or report testing issues

Development Setup

# Fork the repo and clone your fork
git clone https://github.com/arnesssr/Creaticon

# Create a feature branch
git checkout -b feature/amazing-feature

# Make your changes and commit
git commit -m "Add amazing feature"

# Push to your fork and create a PR
git push origin feature/amazing-feature

πŸ“„ License

MIT License - Completely Open Source

This project is licensed under the MIT License - see the LICENSE file for full details.

Feel free to:

  • βœ… Use commercially
  • βœ… Modify and distribute
  • βœ… Create derivative works
  • βœ… Use in proprietary software
  • βœ… Contribute back (appreciated but not required)

Made with ❀️ for the open source community

Star ⭐ this repo if you find it useful!

About

icon generator for developers who need custom icons that actually match their specific use case rather than generic ones.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages