🤖 AI WordPress Content Generator

Generate professional, SEO-optimized blog posts in seconds using Groq AI (Llama 3.3 70B)

An intelligent web application that leverages Groq's ultra-fast AI to create complete WordPress blog posts with titles, content, meta descriptions, and tags in under 3 seconds.

🌟 Live Demo

🔗 Try it now!

---

✨ Features

• ⚡ Ultra Fast Generation: Create 400-600 word blog posts in 2-3 seconds (powered by Groq)
• 🎯 SEO Optimized: Automatically generates SEO-friendly titles, meta descriptions, and relevant tags
• 📝 Professional Quality: Llama 3.3 70B ensures well-written, engaging, and valuable content
• 📋 One-Click Copy: Copy all generated content to clipboard instantly
• 📤 WordPress Publishing: One-click publish directly to your WordPress site
• 📱 Fully Responsive: Beautiful UI that works seamlessly on desktop, tablet, and mobile
• 🎨 Modern Design: Clean, professional interface built with Tailwind CSS
• 🚀 Lightning Fast: Groq API provides the fastest AI inference in the market

---

📤 WordPress Publishing Feature

This app includes one-click WordPress publishing that sends generated content directly to your WordPress site.

🌐 CRITICAL: Live WordPress Site Required

WordPress publishing ONLY works with a LIVE, hosted WordPress site with a real domain name.

✅ What Works (Recommended for Production):

• Hosted WordPress on providers like:
  • Bluehost, SiteGround, WP Engine, Kinsta, DreamHost
  • Your own VPS/server
  • Any WordPress with a public URL like https://yourdomain.com

❌ What Does NOT Work:

• Local WordPress on your laptop (XAMPP, MAMP, LocalWP)
• localhost or http://ai-wp.local
• Private networks without public internet access

🤔 Why Local WordPress Doesn't Work

When you deploy this app on Vercel (cloud), it runs on Vercel's servers in the cloud. Your local WordPress runs on your laptop. They cannot communicate because:

1. 🔒 Your laptop is not accessible from the internet
2. 🌐 Vercel servers cannot reach localhost or http://ai-wp.local
3. 📡 It's like trying to call a phone that's turned off and disconnected

Think of it this way:

• Vercel = Office in New York
• Your Laptop = Office in your home
• Without a public address, they can't send mail to each other

🔧 What About Ngrok?

Ngrok is a tool that creates a temporary tunnel from the internet to your laptop. It gives your local WordPress a public URL like https://abc123.ngrok-free.app.

⚠️ Why We DON'T Recommend Ngrok for Production:

Problem	Impact
❌ URL Changes Every Restart	You get a new URL each time. Must update Vercel settings constantly.
❌ Laptop Must Run 24/7	Close your laptop = publishing stops working.
❌ 2-Hour Session Timeout	Free tier disconnects every 2 hours.
❌ Browser Warning Pages	Ngrok shows security warnings that break API calls.
❌ Complex WordPress Config	Must change WordPress site URLs, which can break your local site.
❌ Unreliable	Connection drops, timeouts, and errors are common.
❌ Not Professional	Temporary URLs look unprofessional to clients.

Bottom Line: Ngrok is ONLY for testing/development, NOT for production or real users.

✅ The Right Way: Use Live WordPress Hosting

For production use, you MUST have a hosted WordPress site. Here's why this is the professional solution:

Benefit	Why It Matters
✅ Always Available	Works 24/7, even when your laptop is off
✅ Permanent URL	Set once, never changes
✅ 99.9% Uptime	Professional hosting with reliability guarantees
✅ Fast Performance	Optimized servers, CDN, caching
✅ Secure	SSL certificates, backups, security updates included
✅ Simple Setup	Configure once, works forever
✅ Professional	Real domain name for your business

💰 Cost of Hosted WordPress

Good news: It's very affordable!

Hosting Type	Cost	Best For
Shared Hosting	$3-10/month	Small blogs, startups
Managed WordPress	$15-30/month	Professional sites, agencies
VPS Hosting	$20-50/month	High traffic, custom needs

Popular Providers:

• Bluehost - $2.95/month (beginner-friendly)
• Hostinger - $2.99/month (budget option)
• SiteGround - $14.99/month (best performance)
• WP Engine - $30/month (premium managed)

What's Included:

• ✅ Domain name (yoursite.com)
• ✅ WordPress hosting
• ✅ SSL certificate (HTTPS)
• ✅ Email accounts
• ✅ 24/7 support
• ✅ Automatic backups

🚀 Quick Setup Guide (5 Minutes)

Step 1: Get WordPress Hosting

1. Choose a hosting provider (Bluehost, SiteGround, etc.)
2. Sign up and select a plan
3. Choose your domain name (yoursite.com)
4. Install WordPress (usually 1-click install)
5. Your site will be live at https://yoursite.com

Step 2: Configure WordPress (2 minutes)

1. Login to WordPress Admin

   • Go to https://yoursite.com/wp-admin

2. Fix Permalinks (REQUIRED)

   • Navigate to: Settings → Permalinks
   • Select: Post name
   • Click: Save Changes
   • ⚠️ Without this, publishing will fail with 405 errors

3. Create Application Password

   • Go to: Users → Profile
   • Scroll to: Application Passwords
   • Name: AI Content Generator
   • Click: Add New Application Password
   • COPY THE PASSWORD (you can't see it again!)
   • Remove all spaces: 25ZS rpJA ICFZ → 25ZSrpJAICFZ

Step 3: Configure Vercel (2 minutes)

cd webapp

# Add WordPress API URL
vercel env add WP_API_URL production
# Enter: https://yoursite.com/wp-json/wp/v2

# Add WordPress username
vercel env add WP_USER production
# Enter: your_wordpress_username

# Add WordPress application password
vercel env add WP_APP_PASS production
# Enter: your_application_password_no_spaces

# Add Groq API key
vercel env add GROQ_API_KEY production
# Enter: your_groq_api_key

Step 4: Deploy

vercel --prod

Step 5: Test

1. Visit your Vercel URL
2. Generate content
3. Click "Publish to WordPress"
4. ✅ Check your WordPress site - post is live!

📋 Production Checklist

Before going live, verify:

• WordPress is hosted (not local)
• Domain name works (https://yoursite.com loads)
• Permalinks set to "Post name"
• Application password created and saved
• All 4 environment variables set in Vercel
• Test publish works successfully

🆘 Common Errors & Solutions

Error: "405 Not Allowed"

Cause: WordPress permalinks not configured
Fix: Settings → Permalinks → "Post name" → Save Changes

Error: "401 Unauthorized"

Cause: Invalid credentials
Fix:

1. Regenerate Application Password
2. Remove ALL spaces from password
3. Update WP_APP_PASS in Vercel
4. Redeploy: vercel --prod

Error: "404 Not Found"

Cause: WordPress REST API not accessible
Fix:

1. Check permalinks (must be "Post name", not "Plain")
2. Visit https://yoursite.com/wp-json/wp/v2 - should show JSON
3. Check if security plugin is blocking REST API

Error: "Connection Error"

Cause: WordPress site not reachable
Fix:

1. Verify site is online: visit https://yoursite.com
2. Check WP_API_URL is correct
3. Ensure site has SSL (https, not http)

📚 Need More Help?

• Complete Guide: See DEPLOYMENT.md for detailed instructions
• Quick Start: See QUICKSTART.md for 5-minute setup
• Troubleshooting: See DEPLOYMENT.md troubleshooting section

---

🛠️ Tech Stack

Technology	Purpose
Next.js 14	React framework with App Router
React	UI component library
Tailwind CSS	Utility-first CSS framework
Groq API	Ultra-fast AI (Llama 3.3 70B)
Lucide React	Beautiful icon library
Vercel	Deployment platform

---

🚀 Local Development

Prerequisites

• Node.js 18+ (Download)
• npm 8+ (comes with Node.js)
• Groq API key (Get free)

Quick Start

# Navigate to project
cd ai-wordpress-automation/webapp

# Install dependencies
npm install

# Create environment file
echo "GROQ_API_KEY=your_groq_api_key_here" > .env.local

# Run development server
npm run dev

# Open browser
# Visit: http://localhost:3000

Note: WordPress publishing won't work locally. You need a live WordPress site (see above).

---

📖 Usage Guide

Generating Content

1. Enter a Topic

   • Example: "How to start a forex trading business"
   • Example: "10 benefits of remote work"
   • Example: "Introduction to cryptocurrency for beginners"

2. Click "Generate Content" or press Enter

3. Wait 2-3 seconds for AI to create your content

4. Review the Results:

   • Blog post title
   • Full content (400-600 words)
   • SEO meta description
   • Relevant tags

5. Copy or Publish:

   • Click "Copy All" to copy to clipboard
   • Click "Publish to WordPress" to publish directly

Pro Tips

• Be Specific: "10 beginner yoga poses for flexibility" vs "fitness"
• Include Keywords: "Best practices for remote work in 2024"
• Target Audience: "How to start investing for college students"
• Use Numbers: "5 ways to..." or "Top 10..."

---

🚢 Deployment to Vercel

Step 1: Push to GitHub

git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/YOUR_USERNAME/YOUR_REPO.git
git push -u origin master

Step 2: Deploy on Vercel

1. Go to vercel.com
2. Click "New Project"
3. Import your GitHub repository
4. Root Directory: webapp
5. Framework: Next.js (auto-detected)
6. Add environment variables (see above)
7. Click "Deploy"

---

📊 Performance

• Generation Speed: 2-3 seconds
• Content Quality: Professional, SEO-optimized
• Uptime: 99.9% (Vercel edge network)
• Cost: Free tier supports thousands of generations

---

📝 License

MIT License - Free to use for personal and commercial projects

---

👤 Author

Built with ❤️ using Next.js, React, Tailwind CSS, and Groq AI

---

🙏 Acknowledgments

• Groq - Fastest AI inference API
• Meta - Llama 3.3 70B model
• Vercel - Seamless deployment
• Next.js Team - Amazing React framework

---

Last Updated: January 2026
Version: 2.0.0
Status: ✅ Production Ready