# Article Idea Generator - Full Documentation

## Overview

Article Idea Generator is a free, AI-powered web application that helps writers, bloggers, content marketers, and journalists generate creative, SEO-optimized article titles and abstracts. The tool uses OpenAI's GPT-4o-mini model to produce human-like, engaging content ideas.

## Target Audience

- **Bloggers**: Need fresh ideas for regular content
- **Content Marketers**: Creating SEO-driven content strategies
- **Journalists**: Finding angles for news stories
- **Students**: Academic paper title inspiration
- **YouTubers**: Video title ideas
- **Podcasters**: Episode naming
- **Social Media Managers**: Engaging post ideas

## Core Functionality

### Title Generation

When a user enters a topic:
1. The topic is sent to the GPT-4o-mini API
2. The AI generates 5 unique, SEO-optimized titles
3. Each title is designed to be:
   - Engaging and clickable
   - Search engine friendly
   - Free of AI-sounding buzzwords
   - Naturally written

### Abstract Generation

For any generated title, users can:
1. Click "Generate Abstract"
2. Receive a 2-3 paragraph summary
3. Use it as a starting point for their article

### Voice Input

- Uses Web Speech API
- Supports English language
- Provides real-time feedback
- Falls back gracefully on unsupported browsers

## Technical Architecture

### Frontend
- **Framework**: Next.js 13.1.5
- **UI Library**: React 18.2.0
- **Styling**: Tailwind CSS
- **Animations**: Framer Motion
- **Theme**: next-themes (dark/light mode)

### Backend
- **API Routes**: Next.js API routes
- **AI Model**: OpenAI GPT-4o-mini
- **Rate Limiting**: 10 requests/minute/IP

### Infrastructure
- **Hosting**: Vercel
- **PWA**: next-pwa for offline support
- **Analytics**: Vercel Analytics

## API Parameters

The generation API uses:
- **Model**: gpt-4o-mini
- **Temperature**: 0.7 (balanced creativity)
- **Max Tokens**: 800
- **System Prompt**: Instructs natural, SEO-friendly output

## User Interface

### Home Page
- Topic input field with character count
- Voice input button
- Generate button
- Results display with copy/share options
- Recent searches sidebar

### FAQ Page
- Common questions answered
- SEO-optimized with Schema.org FAQPage markup

### Error Pages
- Custom 404 with helpful navigation
- Custom 500 with retry functionality

## SEO Implementation

### Meta Tags
- Title, description, keywords
- Open Graph tags for social sharing
- Twitter Card tags
- Canonical URLs

### Structured Data
- WebApplication schema on home page
- FAQPage schema on FAQ page
- BreadcrumbList for navigation

### Technical SEO
- XML Sitemap at /sitemap.xml
- Robots.txt configuration
- Security headers (HSTS, CSP basics)

## Free Writing Tools

Beyond AI generation, Article Idea Generator offers a suite of free writing tools.

### Word Counter Tool

**URL**: https://articleideagenerator.com/tools/word-counter

**Features**:
- Real-time word count
- Character count (with and without spaces)
- Sentence count
- Paragraph count
- Reading time (200 WPM average)
- Speaking time (150 WPM average)
- Top 5 keyword frequency analysis
- Copy stats to clipboard
- Mobile-responsive design

**Use Cases**:
- Checking article/essay word limits
- Meeting assignment requirements
- SEO content length optimization
- Preparing speeches with time estimates
- Keyword density analysis

**Technical Details**:
- Client-side processing (no data sent to server)
- Instant real-time updates
- Stop word filtering for keyword analysis
- Accessible with keyboard navigation

### QR Code Generator Tool

**URL**: https://articleideagenerator.com/tools/qr-code-generator

**Features**:
- 17+ QR code types supported:
  - **Basic**: URL/Website links, Plain text, WiFi credentials, vCard contacts, Email, Phone, SMS, Location, Calendar events
  - **Social**: Twitter/X profiles, YouTube videos/channels, Facebook profiles, App Store links
  - **Payments**: Bitcoin (BIP21), Ethereum (EIP-681), Cardano (CIP-13), Solana Pay
- Customization options:
  - 8 color presets (Classic, Ocean, Forest, Sunset, Coral, Lavender, Midnight, Monochrome)
  - Custom foreground/background colors
  - Logo upload support (auto-adjusts error correction)
  - 5 frame styles: None, Simple Border, Rounded, Badge, Banner
  - Custom frame text (e.g., "SCAN ME")
  - 6 style presets: Clean, Scan Me, Business, Restaurant, Modern, Dark Mode
  - 5 size options (128px to 512px)
  - 4 error correction levels (L, M, Q, H)
  - Quiet zone margin toggle
- Multiple download formats:
  - PNG (high resolution, best for web)
  - SVG (best for print, scalable)
  - JPG (smaller file size)
- Copy to clipboard functionality
- Local history storage (last 10 QR codes)
- **Batch Generation Mode**:
  - Generate multiple QR codes at once (URL type)
  - Input: one URL per line, optional label prefix (e.g., "My Site,https://example.com")
  - Upload CSV/TXT files
  - Apply styles to all batch QR codes
  - Download all as ZIP file
  - Preview all generated codes

**Use Cases**:
- Business cards with vCard QR codes
- Restaurant/cafe WiFi sharing with custom branding
- Product packaging links with company logo
- Event marketing with calendar QR codes
- Contact sharing at conferences
- Cryptocurrency payment links
- App download links (iOS/Android)
- Bulk QR code generation for marketing campaigns
- Social media profile sharing

**Technical Details**:
- Client-side QR generation using qrcode.react (preview) and qrcode (high-res)
- No data sent to server (100% private)
- Canvas-based rendering for downloads
- High-resolution output (2048x2048 for batch)
- LocalStorage for history persistence
- JSZip for batch ZIP downloads
- Mobile-responsive design

### Tools Landing Page

**URL**: https://articleideagenerator.com/tools

Browse all available writing tools with descriptions and "coming soon" badges for tools in development.

### Title Case Converter Tool

**URL**: https://articleideagenerator.com/tools/title-case

**Features**:
- 16 case conversion styles across 3 categories:
  - Writing styles (7): Title Case (AP), Title Case (Chicago), APA Style, Sentence case, Start Case, UPPERCASE, lowercase
  - Programming styles (7): camelCase, PascalCase, snake_case, kebab-case, CONSTANT_CASE, dot.case, path/case
  - Special styles (2): aLtErNaTiNg CaSe, iNVERSE cASE
- Real-time conversion as you type
- Auto-detects input case style
- One-click copy for each style
- Copy all styles at once
- Sample text quick-select buttons
- Character and word count display
- Paste from clipboard button
- Animated card interactions

**Use Cases**:
- Formatting headlines for articles (AP/Chicago style)
- Academic paper titles (APA style)
- Variable naming for code (camelCase, snake_case)
- CSS class names (kebab-case)
- Constant definitions (CONSTANT_CASE)
- URL slugs

**Technical Details**:
- Client-side processing (no data sent to server)
- Pure TypeScript conversion functions
- Mobile-responsive grid layout
- Accessible with keyboard navigation

### PDF Signer Tool

**URL**: https://articleideagenerator.com/tools/pdf-signer

**Features**:
- **Signature Creation Methods**:
  - Draw: Use mouse, trackpad, or touch to draw signature
  - Type: Choose from 5 handwriting fonts (Dancing Script, Great Vibes, Pacifico, Caveat, Satisfy)
  - Upload: Use existing signature image

- **Form Filling Tools**:
  - Full Name field (auto-populates from input)
  - Initials (auto-derived from name, e.g., "John Smith" → "JS")
  - Text fields (editable in-place)
  - Date stamps (auto-fills current date)
  - Checkboxes

- **Annotation Tools**:
  - Highlight with 5 colors (yellow, green, red, blue, orange)
  - Circle shapes with customizable color and stroke width
  - Rectangle shapes with customizable color and stroke width
  - Lines with customizable color and stroke width
  - Arrows with customizable color and stroke width
  - Strikethrough with customizable color
  - Image stamps (logos, custom graphics up to 5MB)

- **Element Manipulation**:
  - Drag and drop positioning
  - Resize handles (8-point: corners and edges)
  - Delete individual elements
  - Select and edit elements

- **PDF Features**:
  - Multi-page navigation
  - Zoom controls (50% to 300%)
  - Page thumbnails
  - Instant download with embedded annotations

- **Privacy**:
  - 100% client-side processing
  - Files never uploaded to servers
  - No data collection

**Use Cases**:
- Signing contracts and agreements remotely
- Filling PDF forms without printing
- Adding approval stamps to documents
- Annotating PDFs for review
- Adding company logos to documents
- Highlighting important sections
- Striking through outdated information

**Technical Details**:
- PDF.js for rendering
- pdf-lib for PDF modification
- Canvas-based element rendering
- Client-side only (no server uploads)
- Supports PDFs up to 50MB
- Touch-friendly for mobile/tablet

### Background Remover Tool

**URL**: https://articleideagenerator.com/tools/background-remover

**Features**:
- **AI-Powered Removal**:
  - One-click automatic background removal
  - Advanced machine learning model runs in browser
  - Precise edge detection for hair, fur, transparent objects
  - Works with people, products, animals, and objects

- **Background Options**:
  - Transparent PNG (checkerboard preview)
  - Solid color with 12 preset colors + custom picker
  - Custom background image upload
  - Blur original background with adjustable intensity (5-30px)
  - Recent colors saved locally

- **Image Comparison**:
  - Before/after slider comparison
  - Toggle between result and comparison view
  - Real-time preview of background changes

- **Download Options**:
  - PNG with transparency
  - JPG with applied background
  - High-quality export (95% quality)

- **Privacy**:
  - 100% client-side AI processing
  - Images never uploaded to servers
  - No data collection or storage

**Supported Formats**:
- PNG, JPG, WebP
- Up to 20MB file size

**Use Cases**:
- E-commerce product photos
- Profile pictures and headshots
- Marketing materials
- Social media content
- Creative design projects
- Replacing photo backgrounds

**Technical Details**:
- U²-Net model via @imgly/background-removal
- Runs entirely in browser (WebGL/WebAssembly)
- Canvas API for image compositing
- GPU-accelerated when available
- Mobile-responsive with touch support

### Planned Tools

- **Character Counter**: Track character limits for Twitter (280), LinkedIn (3000), meta descriptions (160)
- **Reading Time Calculator**: Generate "X min read" badges for blogs
- **Headline Analyzer**: Score headlines for emotional impact, power words, and SEO

## Accessibility

- Semantic HTML structure
- ARIA labels on interactive elements
- Keyboard navigation support
- Focus indicators
- Reduced motion support
- Color contrast compliance

## Privacy

- No user accounts required
- Recent searches stored in localStorage (client-side only)
- No personal data collected
- Rate limiting by IP (not stored)

## Limitations

- 10 requests per minute per IP
- English language only
- Requires JavaScript
- Voice input requires microphone permission

## Common Questions

**Q: Is it free?**
A: Yes, completely free with no signup required.

**Q: What AI model is used?**
A: OpenAI's GPT-4o-mini model.

**Q: Can I use the generated titles?**
A: Yes, all generated content is yours to use.

**Q: Is there an API?**
A: No public API is available.

**Q: How many titles per request?**
A: 5 unique titles per topic.

## Version History

- **v1.0**: Initial release with GPT-3.5-turbo
- **v2.0**: Upgraded to GPT-4o-mini, added voice input, SEO improvements

## Links

- Production: https://articleideagenerator.com
- Source Code: https://github.com/Olanetsoft/article-idea-generator
- Issues: https://github.com/Olanetsoft/article-idea-generator/issues