MCPcopy
hub / github.com/betomoedano/snapai

github.com/betomoedano/snapai @v3.0.1 sqlite

repository ↗ · DeepWiki ↗ · release v3.0.1 ↗
35 symbols 67 edges 12 files 0 documented · 0%
README

SnapAI ⚡

AI-powered icon generation for React Native & Expo developers

Create stunning app icons in seconds using OpenAI's latest image generation models. Perfect for developers who want professional icons without the design hassle! 🎨

✨ Features

🚀 Lightning Fast - Generate icons in seconds, not hours
🎯 iOS Optimized - Perfect for App Store requirements
🛡️ Privacy First - Zero data collection, API keys stay local
📱 Multiple Sizes - Square, landscape, and portrait formats
💎 HD Quality - Crystal clear icons for any device
🔧 Developer Friendly - Simple CLI, perfect for CI/CD

🚀 Quick Start

Installation

# Install globally
npm install -g snapai

# Or use directly (no installation)
npx snapai

[!IMPORTANT]
You'll need an OpenAI API key to generate icons. Get one at platform.openai.com - it costs ~$0.04 per icon!

Setup Your API Key

snapai config --api-key sk-your-openai-api-key-here

Generate Your First Icon! 🎉

snapai icon --prompt "minimalist weather app with sun and cloud"

🎨 See It In Action

Real icons generated with SnapAI:

Prompt Result Command
glass-like color-wheel flower made of eight evenly spaced, semi-transparent petals Flower Icon snapai icon --prompt "glass-like color-wheel flower..."
glass-like sound wave pattern made of five curved, semi-transparent layers flowing in perfect harmony Sound Wave Icon snapai icon --prompt "glass-like sound wave pattern..."
glass-like speech bubble composed of three overlapping, semi-transparent rounded rectangles with soft gradients Messaging Icon snapai icon --prompt "glass-like speech bubble..."
glass-like camera aperture made of six triangular, semi-transparent blades forming a perfect hexagonal opening Camera Glass Icon snapai icon --prompt "glass-like camera aperture..."
stylized camera lens with concentric circles in warm sunset colors orange pink and coral gradients Camera Retro Icon snapai icon --prompt "stylized camera lens with concentric circles..."
neon-outlined calculator with electric blue glowing numbers Neon Calculator Icon snapai icon --prompt "neon-outlined calculator with electric blue glowing numbers"

🎨 Amazing Example Prompts

Try these proven prompts that create stunning icons:

# Glass-like design (trending!)
snapai icon --prompt "glass-like color-wheel flower made of eight evenly spaced, semi-transparent petals forming a perfect circle"

# Minimalist apps
snapai icon --prompt "minimalist calculator app with clean geometric numbers and soft gradients"
snapai icon --prompt "fitness tracker app with stylized running figure using vibrant gradient colors"

# Creative concepts
snapai icon --prompt "weather app with glass-like sun and translucent cloud elements"
snapai icon --prompt "music player app with abstract sound waves in soft pastel hues"
snapai icon --prompt "banking app with secure lock symbol and professional gradients"

[!TIP] Use descriptive words like "glass-like", "minimalist", "vibrant gradients", and "soft pastel hues" for better results!

🛠️ Command Reference

Generate Icons

# Basic usage
snapai icon --prompt "your amazing icon idea"

# Custom output directory
snapai icon --prompt "fitness app" --output ./assets/icons

# High quality (costs 2x but worth it!)
snapai icon --prompt "premium app icon" --quality hd

# Different sizes
snapai icon --prompt "landscape banner" --size 1536x1024
snapai icon --prompt "portrait icon" --size 1024x1536

Configuration

snapai config --show              # Check your setup
snapai config --api-key YOUR_KEY  # Set/update API key

[!NOTE]
Icons are saved as PNG files with timestamps. Perfect for version control!

🔐 Privacy & Security

Your data stays yours 🛡️

  • Zero tracking - We collect absolutely nothing
  • Local storage - API keys never leave your machine
  • No telemetry - No analytics, no phone-home
  • Open source - Inspect every line of code
  • No accounts - Just install and use

[!WARNING]
Keep your OpenAI API key secure! Never commit it to version control or share it publicly.

💰 Pricing

SnapAI is 100% free! You only pay OpenAI for generation:

Quality Size Price Best For
Standard 1024x1024 ~$0.04 Testing, iterations
HD 1024x1024 ~$0.08 Production, App Store

[!TIP] Start with standard quality for testing, then use HD for your final icons!

🚀 Advanced Usage

CI/CD Integration

# Perfect for automation
npx snapai icon --prompt "$(cat icon-prompt.txt)" --output ./dist/icons

Batch Generation

# Generate multiple variations
snapai icon --prompt "app icon variant 1" --output ./icons
snapai icon --prompt "app icon variant 2" --output ./icons
snapai icon --prompt "app icon variant 3" --output ./icons

🛠️ For Developers

Need help setting up for development? Check out our detailed guides:

# Quick dev setup
git clone https://github.com/betomoedano/snapai.git
cd snapai && pnpm install && pnpm run build
./bin/dev.js --help

📚 Learn More

Want to master React Native & Expo development? 🚀

Visit Code with Beto for premium courses:

  • 📱 React Native with Expo - Build real-world apps
  • React with TypeScript - Type-safe development
  • 🔧 GitHub Mastery - Professional workflows
  • 🔥 LiveStore Course (Coming Soon) - Local-first apps

Build the skills that top developers use in production!

🤝 Contributing

Love SnapAI? Help make it even better!

📄 License

MIT License - build amazing things! 🎉

Extension points exported contracts — how you extend this code

ConfigData (Interface)
(no doc)
src/types.ts
IconGenerationOptions (Interface)
(no doc)
src/types.ts
OpenAIResponse (Interface)
(no doc)
src/types.ts

Core symbols most depended-on inside this repo

getConfig
called by 3
src/services/config.ts
showConfig
called by 2
src/commands/config.ts
validatePrompt
called by 1
src/utils/validation.ts
validateApiKey
called by 1
src/utils/validation.ts
validateOutputPath
called by 1
src/utils/validation.ts
setApiKey
called by 1
src/commands/config.ts
saveBase64Image
called by 1
src/commands/icon.ts
getClient
called by 1
src/services/openai.ts

Shape

Method 20
Class 12
Interface 3

Languages

TypeScript100%

Modules by API surface

src/utils/prompts.ts8 symbols
src/services/config.ts6 symbols
src/utils/validation.ts5 symbols
src/commands/config.ts5 symbols
src/services/openai.ts4 symbols
src/commands/icon.ts4 symbols
src/types.ts3 symbols

Dependencies from manifests, versioned

@oclif/core4.0.0 · 1×
@oclif/plugin-help6.0.0 · 1×
@types/fs-extra11.0.4 · 1×
@types/node20.8.0 · 1×
@typescript-eslint/eslint-plugin6.7.0 · 1×
@typescript-eslint/parser6.7.0 · 1×
chalk5.3.0 · 1×
eslint8.50.0 · 1×
fs-extra11.1.1 · 1×
jest29.7.0 · 1×
openai4.20.1 · 1×
ts-node10.9.1 · 1×

For agents

$ claude mcp add snapai \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact