{"id":32374715,"url":"https://github.com/erolleddev/seo","last_synced_at":"2026-06-20T23:31:59.271Z","repository":{"id":298327509,"uuid":"999462699","full_name":"ErolledDev/seo","owner":"ErolledDev","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-13T09:54:09.000Z","size":496,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-24T22:42:53.827Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://seo-lovat.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ErolledDev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-10T09:35:42.000Z","updated_at":"2025-06-13T09:54:12.000Z","dependencies_parsed_at":"2025-06-10T15:19:25.104Z","dependency_job_id":"309349d1-fd50-4bcf-abff-5d859a9f17bd","html_url":"https://github.com/ErolledDev/seo","commit_stats":null,"previous_names":["erolleddev/seo"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ErolledDev/seo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ErolledDev%2Fseo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ErolledDev%2Fseo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ErolledDev%2Fseo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ErolledDev%2Fseo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ErolledDev","download_url":"https://codeload.github.com/ErolledDev/seo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ErolledDev%2Fseo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34589204,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-20T02:00:06.407Z","response_time":98,"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":[],"created_at":"2025-10-24T22:42:09.634Z","updated_at":"2026-06-20T23:31:59.255Z","avatar_url":"https://github.com/ErolledDev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dynamic SEO Meta Tag Redirection System\n\nA powerful Next.js application that creates unique, indexable landing pages with dynamic meta tags for optimal SEO performance. Perfect for creating SEO-optimized redirect pages that search engines love and users trust.\n\n## 🚀 Features\n\n### Core Functionality\n- **Dynamic Meta Tag Generation**: Automatically generates unique meta tags, Open Graph data, and Twitter Cards based on URL parameters\n- **Server-Side Rendering**: Ensures search engines can properly index each unique parameterized URL\n- **SEO Optimization**: Self-referencing canonical tags, structured data, and proper HTML semantics\n- **Smart Redirects**: User-friendly redirect pages with countdown timers and preview options\n\n### Management Interface\n- **Admin Dashboard**: Intuitive interface for creating and managing redirect configurations\n- **Real-time Preview**: Preview redirect pages before publishing\n- **Bulk Operations**: Efficiently manage multiple redirects\n- **URL Generation**: Automatic generation of SEO-optimized URLs\n\n### SEO \u0026 Analytics\n- **XML Sitemap Generation**: Automatically generates and updates XML sitemaps\n- **Search Engine Ready**: Optimized for Google, Bing, and other search engines\n- **Analytics Integration**: Built-in tracking capabilities and performance monitoring\n- **Mobile Responsive**: Optimized for all devices and screen sizes\n\n## 🛠️ Technology Stack\n\n- **Framework**: Next.js 13+ with App Router\n- **Language**: TypeScript\n- **Styling**: Tailwind CSS\n- **UI Components**: shadcn/ui + Radix UI\n- **Icons**: Lucide React\n- **Deployment**: Vercel/Netlify ready\n\n## 📋 How It Works\n\n1. **Create Redirect**: Use the admin panel to create new redirect configurations with custom meta tags\n2. **Generate URL**: System generates unique URLs with dynamic parameters for each redirect page\n3. **SEO Benefits**: Search engines index each unique URL with its custom meta tags and content\n\n## 🔧 Installation \u0026 Setup\n\n1. **Clone the repository**\n   ```bash\n   git clone \u003crepository-url\u003e\n   cd seo-redirect-system\n   ```\n\n2. **Install dependencies**\n   ```bash\n   npm install\n   ```\n\n3. **Set up environment variables**\n   ```bash\n   cp .env.example .env.local\n   ```\n   Update the following variables:\n   ```\n   NEXT_PUBLIC_BASE_URL=http://localhost:3000\n   ```\n\n4. **Run the development server**\n   ```bash\n   npm run dev\n   ```\n\n5. **Open your browser**\n   Navigate to `http://localhost:3000`\n\n## 📊 Usage Examples\n\n### Basic Redirect URL Structure\n```\nhttps://yourdomain.com/u?title=Your%20Page%20Title\u0026desc=Your%20description\u0026image=https://example.com/image.jpg\u0026url=https://target-site.com\n```\n\n### Example URLs\n- **Product Page**: `/u?title=Premium%20Leather%20Wallet\u0026desc=Handcrafted%20wallet\u0026image=https://example.com/wallet.jpg\u0026url=https://shop.com/wallet`\n- **Service Page**: `/u?title=Web%20Design%20Services\u0026desc=Professional%20web%20design\u0026image=https://example.com/design.jpg\u0026url=https://agency.com/services`\n- **Article Page**: `/u?title=SEO%20Tips%20Guide\u0026desc=Complete%20SEO%20guide\u0026image=https://example.com/seo.jpg\u0026url=https://blog.com/seo-tips`\n\n## 🎯 URL Parameters\n\n| Parameter | Required | Description |\n|-----------|----------|-------------|\n| `title` | Yes | Page title and og:title |\n| `desc` | Yes | Meta description and og:description |\n| `url` | Yes | Target URL for redirection |\n| `image` | No | Image URL for og:image and twitter:image |\n| `keywords` | No | Meta keywords |\n| `site_name` | No | og:site_name |\n| `type` | No | og:type (website, article, product, etc.) |\n\n## 🔍 SEO Best Practices\n\n### Meta Tags Generated\n- `\u003ctitle\u003e` - Dynamic page title\n- `\u003cmeta name=\"description\"\u003e` - Dynamic description\n- `\u003cmeta name=\"keywords\"\u003e` - Dynamic keywords\n- `\u003clink rel=\"canonical\"\u003e` - Self-referencing canonical URL\n- Open Graph tags for social sharing\n- Twitter Card tags for Twitter sharing\n- Structured data markup\n\n### Search Engine Optimization\n- **Server-Side Rendering**: All meta tags are generated server-side\n- **Unique URLs**: Each parameter combination creates a unique, indexable page\n- **XML Sitemap**: Automatically generated and updated\n- **Canonical URLs**: Proper canonical tag implementation\n- **Mobile Responsive**: Optimized for all devices\n\n## 📁 Project Structure\n\n```\n├── app/\n│   ├── admin/                 # Admin dashboard\n│   ├── api/\n│   │   └── sitemap.xml/      # Dynamic sitemap generation\n│   ├── u/                    # Dynamic redirect pages\n│   ├── globals.css           # Global styles\n│   ├── layout.tsx           # Root layout\n│   └── page.tsx             # Homepage\n├── components/\n│   ├── ui/                  # UI components (shadcn/ui)\n│   └── RedirectPage.tsx     # Redirect page component\n├── lib/\n│   ├── redirects.ts         # Redirect management logic\n│   └── utils.ts            # Utility functions\n└── README.md\n```\n\n## 🚀 Deployment\n\n### Vercel (Recommended)\n1. Connect your repository to Vercel\n2. Set environment variables:\n   ```\n   NEXT_PUBLIC_BASE_URL=https://yourdomain.com\n   ```\n3. Deploy automatically on push to main branch\n\n### Netlify\n1. Build command: `npm run build`\n2. Publish directory: `out`\n3. Set environment variables in Netlify dashboard\n\n### Custom Server\n1. Build the application: `npm run build`\n2. Serve the static files from the `out` directory\n\n## 📈 Analytics \u0026 Monitoring\n\n### XML Sitemap\n- Automatically generated at `/api/sitemap.xml`\n- Includes all redirect URLs\n- Updates automatically when redirects are added/modified\n- Submit to Google Search Console and Bing Webmaster Tools\n\n### Search Console Integration\n1. Add your domain to Google Search Console\n2. Submit the sitemap: `https://yourdomain.com/api/sitemap.xml`\n3. Monitor indexing status and performance\n\n### Tracking Setup\n- Add Google Analytics tracking code to `app/layout.tsx`\n- Implement custom events for redirect clicks\n- Monitor redirect performance and user behavior\n\n## 🔧 Customization\n\n### Adding Custom Fields\n1. Update the `RedirectConfig` interface in `lib/redirects.ts`\n2. Add form fields in the admin panel\n3. Update the meta tag generation logic\n\n### Styling\n- Customize colors in `tailwind.config.ts`\n- Modify component styles in `app/globals.css`\n- Update UI components in `components/ui/`\n\n### Database Integration\nReplace the in-memory storage in `lib/redirects.ts` with your preferred database:\n- PostgreSQL with Prisma\n- MongoDB with Mongoose\n- Supabase\n- Firebase Firestore\n\n## 🐛 Troubleshooting\n\n### Common Issues\n\n**Redirects not working**\n- Check that the target URL is valid and accessible\n- Verify the redirect configuration is saved correctly\n\n**Meta tags not appearing**\n- Ensure server-side rendering is working\n- Check the browser's view source to see generated HTML\n\n**Sitemap not updating**\n- Clear browser cache\n- Verify the redirect data is being saved correctly\n\n**Build errors**\n- Check TypeScript types\n- Ensure all dependencies are installed\n- Verify Next.js configuration\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Add tests if applicable\n5. Submit a pull request\n\n## 📞 Support\n\nFor support and questions:\n- Open an issue on GitHub\n- Check the documentation\n- Review the troubleshooting section\n\n---\n\nBuilt with ❤️ using Next.js, TypeScript, and Tailwind CSS","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferolleddev%2Fseo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ferolleddev%2Fseo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferolleddev%2Fseo/lists"}