Package Exports

snapai
snapai/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (snapai) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

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`		`snapai icon --prompt "glass-like color-wheel flower..."`
`glass-like sound wave pattern made of five curved, semi-transparent layers flowing in perfect harmony`		`snapai icon --prompt "glass-like sound wave pattern..."`
`glass-like speech bubble composed of three overlapping, semi-transparent rounded rectangles with soft gradients`		`snapai icon --prompt "glass-like speech bubble..."`
`glass-like camera aperture made of six triangular, semi-transparent blades forming a perfect hexagonal opening`		`snapai icon --prompt "glass-like camera aperture..."`
`stylized camera lens with concentric circles in warm sunset colors orange pink and coral gradients`		`snapai icon --prompt "stylized camera lens with concentric circles..."`
`neon-outlined calculator with electric blue glowing numbers`		`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:

📚 Development Setup - Local development workflow
📦 Publishing Guide - For maintainers

# 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! 🎉