{"id":31850204,"url":"https://github.com/devints47/pixel-forge","last_synced_at":"2025-10-12T11:18:42.880Z","repository":{"id":304784181,"uuid":"1019915474","full_name":"devints47/pixel-forge","owner":"devints47","description":"A comprehensive generator for social media previews, favicons, and visual assets across all platforms","archived":false,"fork":false,"pushed_at":"2025-09-07T02:38:22.000Z","size":1685,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-07T04:24:50.988Z","etag":null,"topics":["opengraph","opengraph-images","seo","social-media","typescript"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/pixel-forge","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/devints47.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-15T04:34:21.000Z","updated_at":"2025-09-07T02:38:25.000Z","dependencies_parsed_at":"2025-08-12T04:19:35.591Z","dependency_job_id":"e510a7b4-cdc2-42e4-b62f-355865a04e2a","html_url":"https://github.com/devints47/pixel-forge","commit_stats":null,"previous_names":["devints47/social-forge"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/devints47/pixel-forge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devints47%2Fpixel-forge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devints47%2Fpixel-forge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devints47%2Fpixel-forge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devints47%2Fpixel-forge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devints47","download_url":"https://codeload.github.com/devints47/pixel-forge/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devints47%2Fpixel-forge/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279002559,"owners_count":26083403,"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","status":"online","status_checked_at":"2025-10-10T02:00:06.843Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["opengraph","opengraph-images","seo","social-media","typescript"],"created_at":"2025-10-12T11:18:30.841Z","updated_at":"2025-10-12T11:18:42.875Z","avatar_url":"https://github.com/devints47.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pixel Forge\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg width=\"225\" height=\"225\" alt=\"Pixel Forge Logo Transparent\" src=\"https://github.com/user-attachments/assets/19e54310-ce12-4dd1-9db5-46c11319e8a9\" /\u003e\n\n  **Drop in your logo, get essential website assets.**\n  \n  *Stop wrestling with image sizes. Start focusing on your content.*\n\n  [![npm version](https://badge.fury.io/js/pixel-forge.svg)](https://badge.fury.io/js/pixel-forge)\n  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n  [![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)\n\u003c/div\u003e\n\n**Pixel Forge** generates **only the essential assets** your website needs for modern web sharing. Optimized for 2025 SEO best practices - no bloat, no over-generation.\n\n✨ **Auto-detects background colors** for perfect image extension  \n🚀 **Zero configuration** - just provide your logo  \n📱 **Essential files only** - 5 favicons, 7 PWA assets, smart meta tags  \n⚡ **Built with ImageMagick** for rock-solid reliability  \n\n## 🚀 Quick Start\n\n### Prerequisites\n\nInstall ImageMagick on your system:\n\n```bash\n# macOS\nbrew install imagemagick\n\n# Ubuntu/Debian  \nsudo apt-get install imagemagick\n\n# Windows (Chocolatey)\nchoco install imagemagick\n```\n\n### Generate Everything (Recommended)\n\n```bash\n# One command, everything you need\nnpx pixel-forge generate logo.png --all\n```\n\nThis creates **20 essential assets** in the `./generated` folder:\n- 🌍 **Social media images** (3 essential formats: landscape, square, vertical)\n- 🏠 **Favicons** (6 essential files: ICO, multiple PNG sizes, SVG, Apple Touch, Safari)\n- 📱 **PWA assets** (7 essential files: manifest + core icons)\n- 🔍 **SEO assets** for complete web coverage\n\n### Automatic Meta Tags\n\n```bash\n# Meta tags are ALWAYS generated automatically\nnpx pixel-forge generate logo.png --favicon\n```\n\n**Every generation automatically creates** a `meta-tags.html` file with copy-paste ready HTML tags that reference only the files you generated.\n\n## 📂 What Gets Generated\n\n### `--favicon` (6 essential files)\n```\nfavicon.ico              # Legacy browsers, IE (contains 16x16 + 32x32)\nfavicon-16x16.png        # Browser tab, small displays\nfavicon-32x32.png        # Browser tab, standard displays\nfavicon-48x48.png        # Desktop shortcuts, Windows taskbar\nfavicon.svg              # Scalable vector icon\napple-touch-icon.png     # iOS home screen (180x180)\nsafari-pinned-tab.svg    # Safari pinned tabs\n```\n\n### `--pwa` (7 essential files)\n```\nmanifest.json                           # PWA configuration\npwa-192x192.png                         # Required PWA icon\npwa-512x512.png                         # Required PWA icon\npwa-maskable-192x192.png                # Android adaptive icon\npwa-maskable-512x512.png                # Android adaptive icon\nsplash-android-portrait-1080x1920.png   # Generic mobile splash\nsplash-android-landscape-1920x1080.png  # Generic mobile splash\n```\n\n### `--social` (3 essential files)\n```\nsocial-media-general.png    # 1200x630 - Facebook, Twitter, LinkedIn, messaging\ninstagram-square.png        # 1080x1080 - Instagram, Threads, profile images  \nsocial-vertical.png         # 1080x1920 - TikTok, Stories, Snapchat\n```\n\n### `--seo` (3-6 files)\n```\nog-image.png           # OpenGraph social sharing\nopengraph.png          # Facebook/LinkedIn\ntwitter-image.png      # Twitter Cards\n```\n\n### Always Generated\n```\nmeta-tags.html         # Copy-paste ready HTML tags (ALWAYS created)\n```\n\n## 🛠️ Usage Examples\n\n### Specific Generations\n\n```bash\n# Just favicons\nnpx pixel-forge generate logo.png --favicon\n\n# PWA assets only\nnpx pixel-forge generate logo.png --pwa\n\n# Social sharing images\nnpx pixel-forge generate logo.png --seo\n\n# Complete web package (favicon + PWA + SEO)\nnpx pixel-forge generate logo.png --web\n```\n\n### Output Options\n\n```bash\n# Custom output directory\nnpx pixel-forge generate logo.png --all --output ./assets\n\n# Custom URL prefix for meta tags\nnpx pixel-forge generate logo.png --favicon --prefix \"/assets/\"\n```\n\n## 🧩 Programmatic API\n\n```typescript\nimport { generateAssets } from 'pixel-forge';\n\n// Generate favicon assets (meta tags always included)\nconst result = await generateAssets('logo.png', {\n  favicon: true,\n  outputDir: './generated'\n});\n\n// Access the structured result\nconsole.log(result.files.favicon);    // Array of favicon file paths\nconsole.log(result.metaTags.html);    // Complete HTML from meta-tags.html\nconsole.log(result.metaTags.tags);    // Array of individual meta tags\nconsole.log(result.summary);          // Generation summary\n```\n\n## 🎯 Why Pixel Forge?\n\n### Before: Bloated \u0026 Complex\n- ❌ 40+ unnecessary files\n- ❌ Complex configuration  \n- ❌ References to non-existent files\n- ❌ Platform-specific variations you don't need\n\n### After: Essential \u0026 Clean\n- ✅ **5 favicon files** (down from 20+)\n- ✅ **7 PWA files** (down from 38+)\n- ✅ **Smart meta tags** that reference only generated files\n- ✅ **2024 SEO best practices** compliance\n\n## 📋 CLI Reference\n\n```bash\n# Basic usage (both commands work identically)\nnpx pixel-forge generate \u003cimage\u003e [options]\npf generate \u003cimage\u003e [options]  # Short alias\n\n# Asset type flags\n--all           # Generate all essential assets (20 files including meta-tags.html)\n--social        # Generate essential social media assets (3 core images + meta-tags.html)\n--favicon       # Generate favicon assets (6 files + meta-tags.html)\n--pwa          # Generate PWA assets (7 files + meta-tags.html) \n--seo          # Generate SEO/social images (3-6 files + meta-tags.html)\n--web          # Generate web package (favicon + PWA + SEO + meta-tags.html)\n\n# Output options\n--output \u003cdir\u003e # Output directory (default: ./generated)\n--prefix \u003curl\u003e # URL prefix for meta tags (default: /images/)\n--verbose      # Show detailed output\n```\n\n## 🔧 Advanced Features\n\n### Auto Background Detection\nPixel Forge automatically detects your image's background color and uses it to fill extended areas, preventing ugly white bars or cropping.\n\n### Smart Meta Tags (Always Generated)\nEvery generation automatically creates `meta-tags.html` with:\n- ✅ **Only tags for generated files** (no 404s)  \n- ✅ **2025 SEO best practices** compliance\n- ✅ **Copy-paste ready** HTML format\n- ✅ **Security headers** included\n\n### Format Support\nSupports all modern image formats:\n- PNG, JPEG, WebP, AVIF, TIFF, GIF, SVG, BMP\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n## 📄 License\n\nMIT License - see [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevints47%2Fpixel-forge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevints47%2Fpixel-forge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevints47%2Fpixel-forge/lists"}