🎨 ITBlogPros Article Studio - Complete Overview

A professional web application that transforms your article creation workflow


🌟 What Is This?

Article Studio is a complete web-based solution for generating, previewing, and publishing ITBlogPros articles. It consolidates your entire workflow into a beautiful, easy-to-use interface.

Before Article Studio

❌ Multiple terminal windows open
❌ Copying/pasting commands
❌ Manual Amazon ASIN validation
❌ Separate preview process
❌ Manual git operations
❌ 15-20 minutes per article
❌ Error-prone manual steps

After Article Studio

✅ Single web interface
✅ Click buttons, see progress
✅ Automatic Amazon validation
✅ Integrated preview with one click
✅ One-click publishing
✅ 5-7 minutes per article
✅ Automated, reliable workflow

🎯 Key Benefits

For You (The User)

  1. Save Time

  2. Reduce Errors

  3. Better Experience

  4. Easier Management

For Your Business

  1. Increase Output

  2. Better Quality

  3. Improved Workflow


🏗️ Architecture

Technology Stack

Backend:

Frontend:

Integrations:

File Structure

article-studio/
│
├── server.js                      # Main Express server
├── package.json                   # Dependencies
├── START.bat                      # Quick launch script
│
├── public/                        # Web UI
│   ├── index.html                 # Dashboard HTML
│   ├── styles.css                 # Styling (500+ lines)
│   └── app.js                     # Frontend logic (400+ lines)
│
├── services/                      # Backend services
│   ├── article-generator.js       # Gemini integration
│   ├── amazon-validator.js        # ASIN validation
│   ├── bing-submitter.js          # IndexNow submission
│   ├── git-publisher.js           # Git operations
│   └── database.js                # SQLite database
│
├── database/                      # Data storage
│   └── articles.db                # SQLite database
│
├── README.md                      # Main documentation
├── SETUP-GUIDE.md                 # Installation guide
└── .gitignore                     # Git ignore rules

🔄 Complete Workflow

1. Generation Phase (2-3 minutes)

User enters keyword
    ↓
Server creates job
    ↓
Research Bing queries (10%)
    ↓
Generate article with Gemini (30%)
    ↓
Validate Amazon ASINs (60%)
    ↓
Calculate quality score (80%)
    ↓
Save to database + file (90%)
    ↓
Complete (100%)

Real-time updates: User sees progress bar and status messages

2. Preview Phase (3 seconds)

User clicks "Start Preview Server"
    ↓
Server spawns Eleventy process
    ↓
Eleventy builds site
    ↓
Server running on localhost:8080
    ↓
Browser opens automatically
    ↓
User navigates full site

What user sees: Complete site with new article in context

3. Publishing Phase (30 seconds)

User clicks "Publish"
    ↓
Modal shows commit message
    ↓
User confirms
    ↓
Server adds file to git
    ↓
Server commits changes
    ↓
Server pushes to GitHub
    ↓
(Optional) Submit to Bing
    ↓
Update article status to "published"
    ↓
Cloudflare auto-deploys

Result: Article live on itblogpros.com in 2-3 minutes


📊 Database Schema

Articles Table

Stores all generated articles:

CREATE TABLE articles (
  id INTEGER PRIMARY KEY,
  keyword TEXT,              -- Original search keyword
  title TEXT,                -- Article title
  content TEXT,              -- Full markdown content
  filename TEXT,             -- YYYY-MM-DD-slug.md
  quality_score INTEGER,     -- 0-100 quality score
  amazon_links INTEGER,      -- Total Amazon links
  valid_amazon_links INTEGER,-- Valid ASINs
  status TEXT,               -- 'draft' or 'published'
  created_at DATETIME,       -- When generated
  published_at DATETIME      -- When published
)

Amazon Links Table

Tracks product validation:

CREATE TABLE amazon_links (
  id INTEGER PRIMARY KEY,
  article_id INTEGER,        -- Foreign key to articles
  asin TEXT,                 -- Amazon product ID
  product_name TEXT,         -- Product title
  is_valid BOOLEAN,          -- Validation status
  last_checked DATETIME      -- When validated
)

Future additions:


🎨 UI Features

Dashboard

Header Stats:

Generation Card:

Articles List:

Modals

Publish Modal:

Delete Modal:

Color Scheme

Primary Colors:

Neutral Colors:

Typography:


🔌 API Reference

Generation Endpoints

POST /api/generate

Request:
{
  "keyword": "WiFi 7 routers"
}

Response:
{
  "success": true,
  "jobId": "1642345678901"
}

GET /api/jobs/:jobId

Response:
{
  "success": true,
  "job": {
    "status": "generating",
    "progress": 60,
    "message": "Validating Amazon ASINs...",
    "keyword": "WiFi 7 routers"
  }
}

Article Endpoints

GET /api/articles

Response:
{
  "success": true,
  "articles": [
    {
      "id": 1,
      "keyword": "WiFi 7 routers",
      "title": "WiFi 7 vs WiFi 6...",
      "quality_score": 85,
      "amazon_links": 3,
      "status": "draft",
      "created_at": "2025-01-16T10:00:00Z"
    }
  ]
}

DELETE /api/articles/:id

Response:
{
  "success": true,
  "message": "Article deleted"
}

Preview Endpoints

POST /api/preview/start

Response:
{
  "success": true,
  "message": "Preview server starting...",
  "url": "http://localhost:8080"
}

POST /api/preview/stop

Response:
{
  "success": true,
  "message": "Preview server stopped"
}

Publishing Endpoints

POST /api/publish/:articleId

Request:
{
  "commitMessage": "Published: WiFi 7 Article",
  "submitToBing": true
}

Response:
{
  "success": true,
  "message": "Article published successfully!",
  "result": {
    "filename": "2025-01-16-wifi-7-routers.md",
    "commitMessage": "Published: WiFi 7 Article"
  }
}

🚀 Performance

Generation Speed

Total: 2-3 minutes per article

Preview Speed

Total: 3 seconds to preview

Publishing Speed

Total: 10-15 seconds to publish


🛠️ Maintenance

Regular Tasks

Daily:

Weekly:

Monthly:

Backup Strategy

Database Backups:

# Manual backup
copy database\articles.db database\articles-backup-2025-01-16.db

# Automated (add to scheduled task)
robocopy database\ backups\ articles.db /MOT:60

Article Backups: Your articles are already in git, so they're backed up!


🔮 Future Roadmap

Phase 1 (Current)

Phase 2 (Next Month)

Phase 3 (Quarter 2)

Phase 4 (Long Term)


📈 Success Metrics

Workflow Efficiency

Before Article Studio:

After Article Studio:

Improvement:

Quality Improvements


🎓 Learning Resources

For Developers

Express.js:

SQLite:

Gemini API:

For Users

Article Writing:

Git Basics:


📞 Support & Contact

Getting Help

  1. Check Documentation:

  2. Common Issues:

  3. Still Stuck:

Contributing

Want to improve Article Studio?

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a pull request

Ideas welcome! Even if you can't code, suggestions help.


🎉 Conclusion

You now have a complete, professional article generation system that:

✅ Saves you 10-15 minutes per article ✅ Increases quality and consistency ✅ Reduces errors and manual work ✅ Provides beautiful, easy-to-use interface ✅ Integrates with all your existing tools ✅ Tracks everything in a database ✅ Makes publishing one-click simple

The result?

More articles. Better quality. Less time. More revenue.


Built with ❤️ for ITBlogPros

Making content creation effortless, one article at a time.