{"id":31850209,"url":"https://github.com/devints47/seo-foundry-pkg","last_synced_at":"2025-10-12T11:18:44.587Z","repository":{"id":305588171,"uuid":"1022822187","full_name":"devints47/seo-foundry-pkg","owner":"devints47","description":"Base package for SEO Automation suite","archived":false,"fork":false,"pushed_at":"2025-08-14T02:38:09.000Z","size":12,"stargazers_count":2,"open_issues_count":4,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-20T08:23:52.659Z","etag":null,"topics":["seo","seotools"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/seo-foundry","language":"JavaScript","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":null,"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}},"created_at":"2025-07-19T22:54:56.000Z","updated_at":"2025-08-29T21:40:36.000Z","dependencies_parsed_at":"2025-07-21T01:19:32.102Z","dependency_job_id":null,"html_url":"https://github.com/devints47/seo-foundry-pkg","commit_stats":null,"previous_names":["devints47/seo-foundry"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/devints47/seo-foundry-pkg","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devints47%2Fseo-foundry-pkg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devints47%2Fseo-foundry-pkg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devints47%2Fseo-foundry-pkg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devints47%2Fseo-foundry-pkg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devints47","download_url":"https://codeload.github.com/devints47/seo-foundry-pkg/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devints47%2Fseo-foundry-pkg/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279011192,"owners_count":26084899,"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-12T02:00:06.719Z","response_time":53,"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":["seo","seotools"],"created_at":"2025-10-12T11:18:35.434Z","updated_at":"2025-10-12T11:18:44.578Z","avatar_url":"https://github.com/devints47.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SEO Foundry\n\n**SEO Foundry** is a monorepo of tools designed to enhance the SEO of a web developer's website. Our collection of packages helps automate the generation and optimization of SEO assets, social media previews, favicons, and other visual elements that improve your site's search engine visibility and social sharing performance.\n\n---\n\n## 🛠 Available Tools\n\n### [`pixel-forge`](./packages/pixel-forge)\nA comprehensive generator for social media previews, favicons, and visual assets across all platforms. Perfect for:\n- **Open Graph images** for Facebook, LinkedIn, and other social platforms\n- **Twitter Cards** for enhanced tweet previews\n- **Favicons** in all required sizes and formats\n- **PWA icons** for progressive web applications\n- **Platform-specific assets** for Instagram, TikTok, and more\n\n---\n\n## 🏗 Monorepo Structure\n\nThis project uses a **monorepo structure** with PNPM workspaces to manage multiple SEO-focused packages:\n\n```\nseo-foundry/\n├── packages/\n│   └── pixel-forge/        # Visual asset generation\n├── pnpm-workspace.yaml     # Workspace configuration\n└── package.json           # Root package configuration\n```\n\n---\n\n## 🚀 Quick Start\n\n### Install SEO Foundry (Aggregator)\n```bash\n# Global install (recommended for CLI usage)\npnpm add -g seo-foundry\n\n# Or as a project dependency\npnpm add seo-foundry\n```\n\n### Install Individual Tools\n```bash\n# Typically not required—`seo-foundry` includes them. If you want a tool standalone:\npnpm add pixel-forge\npnpm add -g pixel-forge\n```\n\n### Generate SEO Assets (via unified CLI)\n```bash\n# Discover available tools and commands\nseo-foundry --help\n\n# Run pixel-forge subcommands through the aggregator\nseo-foundry pixel-forge generate --config ./seo-config.json\nseo-foundry pixel-forge favicon --input ./logo.png\nseo-foundry pixel-forge social --template modern --title \"My Awesome Site\"\n```\n\n---\n\n## 📦 Package Management\n\nThis monorepo uses [`pnpm`](https://pnpm.io/) with workspaces for efficient dependency management:\n\n```bash\n# Install all dependencies\npnpm install\n\n# Build all packages\npnpm build\n\n# Work on a specific package\ncd packages/pixel-forge\npnpm dev\n```\n\n---\n\n## 🧰 After Cloning (Maintainers)\n\n```bash\n# 1) Install dependencies\npnpm install\n\n# 2) Sanity-check the aggregator CLI locally\npnpm run cli -- --help\npnpm run cli -- pixel-forge --version\n\n# 3) Build all packages (no-op for aggregator; useful for workspaces)\npnpm build\n```\n\n### Optional: Work on a tool locally\nIf you’re developing a tool (e.g., `pixel-forge`) locally and want the aggregator to use your local build, you have two options:\n\n1) Use NPM/Yarn/Pnpm link\n```bash\ncd packages/pixel-forge\npnpm install\npnpm build\npnpm link --global\n\ncd ../../\npnpm link --global pixel-forge\n```\n\n2) Temporarily point the dependency to a file/path (not for publishing)\n```json\n// package.json (root)\n{\n  \"dependencies\": {\n    \"pixel-forge\": \"file:packages/pixel-forge\"\n  }\n}\n```\n\nRevert to a semver version (e.g., `^1.0.4`) before publishing `seo-foundry`.\n\n---\n\n## ➕ Adding New Tools\n\n1) Build and publish the new tool from its own repo (ensure it has an NPM `bin` entry)\n2) Add it to `dependencies` in the root `package.json`\n3) Map it in `bin/seo-foundry.js` so `seo-foundry \u003ctool\u003e ...` works\n4) Update this README (Available Tools + examples)\n\nThis keeps each tool independent while providing a unified UX.\n\n---\n\n## 📋 Roadmap\n\nPlanned SEO tools for future releases:\n- **aria tags**: Automated aria tag generation and optimization\n- **meta tags**: Automated meta tag generation and optimization\n- **schema builder**: Structured data and JSON-LD generation\n- **sitemap generator**: Dynamic sitemap creation and maintenance\n- **performance optimizers**: Core Web Vitals and performance analysis\n\n---\n\n## 💡 License\n\nThis project is [MIT Licensed](./LICENSE) and maintained by [Devin Singh](mailto:devin@devinops.com) and [Kendall Jackson](mailto:kendallkj00@gmail.com).\n\n---\n\n## 🙋 Support\n\n- **Issues**: [GitHub Issues](https://github.com/devints47/seo-foundry/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/devints47/seo-foundry/discussions)\n- **Email**: [devin@devinops.com](mailto:devin@devinops.com)\n\n---\n\n**Happy building!** 🚀 Make your website SEO-ready with SEO Foundry.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevints47%2Fseo-foundry-pkg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevints47%2Fseo-foundry-pkg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevints47%2Fseo-foundry-pkg/lists"}