Amazon Suspension Appeal (appeal.tools)

Amazon Suspension Appeal (appeal.tools) was a fully automated, multi-language content and SaaS platform dedicated to helping Amazon sellers with account reinstatement, compliance, and appeal strategies.

Features & Highlights

• Automated Content Generation:
  Leveraged Gemini AI to generate high-quality, Amazon-specific appeal guides, compliance articles, and best practices in both English and Chinese.
• Longtail Keyword & Topic Pool:
  Built a dynamic pool of longtail keywords and topics, sourced from AI, Google Trends, and manual curation, ensuring content diversity and SEO strength.
• Multi-language & Multi-region Support:
  All content, prompts, and legal pages supported both English and Chinese, with plans for further localization (e.g., Arabic, German).
• Modern UI/UX:
  Responsive homepage, article lists, detail pages, hot topics, and a SaaS early access page, all styled with a consistent brand color scheme and card-based layout.
• SEO & Social Sharing:
  Dynamic sitemap.xml, robots.txt, Open Graph meta tags, Twitter cards, and canonical URLs for optimal search engine indexing and social media sharing.
• User Engagement:
  Included email collection for SaaS beta users, cookie consent, feedback widget, and legal pages (Privacy Policy, Terms, About, Contact).
• Analytics & Hot Content:
  Real-time view count tracking for articles and topics, with hot articles and topics displayed across the site.
• Admin Automation:
  GitHub Actions and Supabase scripts for automated content generation, keyword seeding, topic management, and data cleanup.

Tech Stack

• Frontend: Next.js 15 (App Router), Tailwind CSS, shadcn/ui, react-markdown, react-share, @heroicons/react
• Backend/Database: Supabase (Postgres, Auth, Storage)
• AI/Content Generation: Google Gemini API (with advanced prompt engineering and markdown output)
• Automation: GitHub Actions for scheduled content/keyword generation and data management
• Deployment: Vercel (with custom domain, HTTPS, and CDN)
• SEO: Dynamic metadata, Open Graph, sitemap.xml, robots.txt

Development Journey

• Initial MVP:
  Started with a simple Next.js content site, then quickly integrated Supabase for data management and Gemini AI for content generation.
• Iterative Feature Expansion:
  Added multi-language support, dynamic topic/keyword pools, automated article generation, and a SaaS email collection page.
• SEO & Compliance:
  Implemented dynamic SEO meta tags, Open Graph, sitemap.xml, robots.txt, and all required legal pages in both languages.
• User Experience:
  Unified site color scheme, card-based layout, responsive design, and modern navigation/footer for a professional look and feel.
• Automation & Scaling:
  Developed scripts and workflows for automated keyword seeding, topic management, and content production, enabling true “set-and-forget” operation.

Challenges & Lessons Learned

• AI Content Formatting:
  Ensured all AI-generated content was in markdown and strictly JSON-formatted, with robust error handling for edge cases.
• Supabase Integration:
  Managed multi-table relationships (articles, topics, keywords) and optimized queries for performance and data integrity.
• SEO Consistency:
  Maintained up-to-date sitemap.xml and robots.txt, and ensured all pages had correct meta tags and Open Graph data.
• Legal & Compliance:
  Created comprehensive, multi-language legal pages and cookie consent to meet international standards.
• Scalability:
  Designed the system to be easily cloned and parameterized for other platforms (e.g., eBay, PayPal) with minimal code changes.

Sunset & Legacy

As Amazon’s policies and the competitive landscape evolved, the project was sunset to focus on new SaaS tools and more advanced AI-driven solutions.
Legacy:
The codebase and architecture remain a robust template for future automated content and compliance platforms, and the lessons learned continue to inform new projects in the AI content and e-commerce compliance space.