{"id":29024509,"url":"https://github.com/betomoedano/snapai","last_synced_at":"2025-06-28T06:02:14.923Z","repository":{"id":300757229,"uuid":"1006328382","full_name":"betomoedano/snapai","owner":"betomoedano","description":"AI-powered icon generation CLI for React Native \u0026 Expo developers. Generate stunning app icons in seconds using OpenAI's latest models.","archived":false,"fork":false,"pushed_at":"2025-06-22T16:14:53.000Z","size":10903,"stargazers_count":45,"open_issues_count":3,"forks_count":4,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-23T13:12:58.955Z","etag":null,"topics":["ai","cli","developer-tools","expo","icon-generator","openai","react-native"],"latest_commit_sha":null,"homepage":"https://codewithbeto.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/betomoedano.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-22T02:36:04.000Z","updated_at":"2025-06-23T12:35:29.000Z","dependencies_parsed_at":"2025-06-23T13:13:02.970Z","dependency_job_id":"d2d1fa21-8550-4b37-a2d3-fb514e8fdfca","html_url":"https://github.com/betomoedano/snapai","commit_stats":null,"previous_names":["betomoedano/snapai"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/betomoedano/snapai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/betomoedano%2Fsnapai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/betomoedano%2Fsnapai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/betomoedano%2Fsnapai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/betomoedano%2Fsnapai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/betomoedano","download_url":"https://codeload.github.com/betomoedano/snapai/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/betomoedano%2Fsnapai/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261997402,"owners_count":23242250,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","cli","developer-tools","expo","icon-generator","openai","react-native"],"created_at":"2025-06-26T04:02:05.327Z","updated_at":"2025-06-26T04:02:06.965Z","avatar_url":"https://github.com/betomoedano.png","language":"TypeScript","funding_links":[],"categories":["CLIs"],"sub_categories":[],"readme":"# SnapAI ⚡\n\n\u003e AI-powered icon generation for React Native \u0026 Expo developers\n\nCreate stunning app icons in seconds using OpenAI's latest image generation models. Perfect for developers who want professional icons without the design hassle! 🎨\n\n## ✨ Features\n\n🚀 **Lightning Fast** - Generate icons in seconds, not hours  \n🎯 **iOS Optimized** - Perfect for App Store requirements  \n🛡️ **Privacy First** - Zero data collection, API keys stay local  \n📱 **Multiple Sizes** - Square, landscape, and portrait formats  \n💎 **HD Quality** - Crystal clear icons for any device  \n🔧 **Developer Friendly** - Simple CLI, perfect for CI/CD\n\n## 🚀 Quick Start\n\n### Installation\n\n```bash\n# Install globally\nnpm install -g snapai\n\n# Or use directly (no installation)\nnpx snapai\n```\n\n\u003e [!IMPORTANT]  \n\u003e You'll need an OpenAI API key to generate icons. Get one at [platform.openai.com](https://platform.openai.com) - it costs ~$0.04 per icon!\n\n### Setup Your API Key\n\n```bash\nsnapai config --api-key sk-your-openai-api-key-here\n```\n\n### Generate Your First Icon! 🎉\n\n```bash\nsnapai icon --prompt \"minimalist weather app with sun and cloud\"\n```\n\n## 🎨 See It In Action\n\n**Real icons generated with SnapAI:**\n\n| Prompt                                                                                                            | Result                                                       | Command                                                                              |\n| ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------ |\n| `glass-like color-wheel flower made of eight evenly spaced, semi-transparent petals`                              | ![Flower Icon](test-icons/icon-1750560657796.png)            | `snapai icon --prompt \"glass-like color-wheel flower...\"`                            |\n| `glass-like sound wave pattern made of five curved, semi-transparent layers flowing in perfect harmony`           | ![Sound Wave Icon](test-icons/icon-sound-wave.png)           | `snapai icon --prompt \"glass-like sound wave pattern...\"`                            |\n| `glass-like speech bubble composed of three overlapping, semi-transparent rounded rectangles with soft gradients` | ![Messaging Icon](test-icons/icon-messaging.png)             | `snapai icon --prompt \"glass-like speech bubble...\"`                                 |\n| `glass-like camera aperture made of six triangular, semi-transparent blades forming a perfect hexagonal opening`  | ![Camera Glass Icon](test-icons/icon-camera-glass.png)       | `snapai icon --prompt \"glass-like camera aperture...\"`                               |\n| `stylized camera lens with concentric circles in warm sunset colors orange pink and coral gradients`              | ![Camera Retro Icon](test-icons/icon-lens-retro.png)         | `snapai icon --prompt \"stylized camera lens with concentric circles...\"`             |\n| `neon-outlined calculator with electric blue glowing numbers`                                                     | ![Neon Calculator Icon](test-icons/icon-calculator-neon.png) | `snapai icon --prompt \"neon-outlined calculator with electric blue glowing numbers\"` |\n\n## 🎨 Amazing Example Prompts\n\nTry these proven prompts that create stunning icons:\n\n```bash\n# Glass-like design (trending!)\nsnapai icon --prompt \"glass-like color-wheel flower made of eight evenly spaced, semi-transparent petals forming a perfect circle\"\n\n# Minimalist apps\nsnapai icon --prompt \"minimalist calculator app with clean geometric numbers and soft gradients\"\nsnapai icon --prompt \"fitness tracker app with stylized running figure using vibrant gradient colors\"\n\n# Creative concepts\nsnapai icon --prompt \"weather app with glass-like sun and translucent cloud elements\"\nsnapai icon --prompt \"music player app with abstract sound waves in soft pastel hues\"\nsnapai icon --prompt \"banking app with secure lock symbol and professional gradients\"\n```\n\n\u003e [!TIP]\n\u003e Use descriptive words like \"glass-like\", \"minimalist\", \"vibrant gradients\", and \"soft pastel hues\" for better results!\n\n## 🛠️ Command Reference\n\n### Generate Icons\n\n```bash\n# Basic usage\nsnapai icon --prompt \"your amazing icon idea\"\n\n# Custom output directory\nsnapai icon --prompt \"fitness app\" --output ./assets/icons\n\n# High quality (costs 2x but worth it!)\nsnapai icon --prompt \"premium app icon\" --quality hd\n\n# Different sizes\nsnapai icon --prompt \"landscape banner\" --size 1536x1024\nsnapai icon --prompt \"portrait icon\" --size 1024x1536\n```\n\n### Configuration\n\n```bash\nsnapai config --show              # Check your setup\nsnapai config --api-key YOUR_KEY  # Set/update API key\n```\n\n\u003e [!NOTE]  \n\u003e Icons are saved as PNG files with timestamps. Perfect for version control!\n\n## 🔐 Privacy \u0026 Security\n\n**Your data stays yours** 🛡️\n\n- ✅ **Zero tracking** - We collect absolutely nothing\n- ✅ **Local storage** - API keys never leave your machine\n- ✅ **No telemetry** - No analytics, no phone-home\n- ✅ **Open source** - Inspect every line of code\n- ✅ **No accounts** - Just install and use\n\n\u003e [!WARNING]  \n\u003e Keep your OpenAI API key secure! Never commit it to version control or share it publicly.\n\n## 💰 Pricing\n\n**SnapAI is 100% free!** You only pay OpenAI for generation:\n\n| Quality  | Size      | Price  | Best For              |\n| -------- | --------- | ------ | --------------------- |\n| Standard | 1024x1024 | ~$0.04 | Testing, iterations   |\n| HD       | 1024x1024 | ~$0.08 | Production, App Store |\n\n\u003e [!TIP]\n\u003e Start with standard quality for testing, then use HD for your final icons!\n\n## 🚀 Advanced Usage\n\n### CI/CD Integration\n\n```bash\n# Perfect for automation\nnpx snapai icon --prompt \"$(cat icon-prompt.txt)\" --output ./dist/icons\n```\n\n### Batch Generation\n\n```bash\n# Generate multiple variations\nsnapai icon --prompt \"app icon variant 1\" --output ./icons\nsnapai icon --prompt \"app icon variant 2\" --output ./icons\nsnapai icon --prompt \"app icon variant 3\" --output ./icons\n```\n\n## 🛠️ For Developers\n\nNeed help setting up for development? Check out our detailed guides:\n\n- 📚 [Development Setup](DEV_SETUP.md) - Local development workflow\n- 📦 [Publishing Guide](PUBLISHING_GUIDE.md) - For maintainers\n\n```bash\n# Quick dev setup\ngit clone https://github.com/betomoedano/snapai.git\ncd snapai \u0026\u0026 pnpm install \u0026\u0026 pnpm run build\n./bin/dev.js --help\n```\n\n## 📚 Learn More\n\n**Want to master React Native \u0026 Expo development?** 🚀\n\nVisit [**Code with Beto**](https://codewithbeto.dev) for premium courses:\n\n- 📱 **React Native with Expo** - Build real-world apps\n- ⚡ **React with TypeScript** - Type-safe development\n- 🔧 **GitHub Mastery** - Professional workflows\n- 🔥 **LiveStore Course** _(Coming Soon)_ - Local-first apps\n\n_Build the skills that top developers use in production!_ ✨\n\n## 🤝 Contributing\n\nLove SnapAI? Help make it even better!\n\n- 🐛 [Report bugs](https://github.com/betomoedano/snapai/issues)\n- 💡 [Suggest features](https://github.com/betomoedano/snapai/issues)\n- 📝 [Improve docs](CONTRIBUTING.md)\n- 🔧 [Submit code](CONTRIBUTING.md)\n\n## 📄 License\n\nMIT License - build amazing things! 🎉\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbetomoedano%2Fsnapai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbetomoedano%2Fsnapai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbetomoedano%2Fsnapai/lists"}