Article Title
+Excerpt...
+ Read more → +, , , )
+- Formatting rules
+
+**Section 4: Style & Quality** (80 tokens)
+- Tone guidance
+- Keyword usage
+- Avoid generic phrases
+- Examples of good vs bad openings
+
+**Section 5: Content Structure Types** (90 tokens)
+- article: {structure description}
+- guide: {structure description}
+- review: {structure description}
+- comparison: {structure description}
+- listicle: {structure description}
+- cluster_hub: {structure description}
+
+**Section 6: Output Format with Example** (100 tokens)
+- JSON structure
+- Show abbreviated example with proper HTML
+
+**Total:** ~500 tokens (vs current ~550, but much more precise)
+
+---
+
+### D. Image Prompt Improvements
+
+#### Goals
+- Generate visually diverse prompts
+- Better context from article content
+- Specify image placement guidelines
+- Improve prompt detail and clarity
+
+#### Proposed Extraction Prompt Structure
+
+**Section 1: Task & Context** (50 tokens)
+```
+Extract image prompts from this article for visual content placement.
+
+Article: {title}
+Content: {content}
+Required: 1 featured + {max_images} in-article images
+```
+
+**Section 2: Image Types & Guidelines** (100 tokens)
+```
+Featured Image:
+- Hero visual representing article's main theme
+- Broad, engaging, high-quality
+- Should work at large sizes (1200×630+)
+
+In-Article Images (place strategically):
+1. After introduction
+2. Mid-article (before major H2 sections)
+3. Supporting specific concepts or examples
+4. Before conclusion
+
+Each prompt must describe:
+- Subject & composition
+- Visual style (photographic, minimal, editorial)
+- Mood & lighting
+- Color palette suggestions
+- Avoid: text, logos, faces (unless relevant)
+```
+
+**Section 3: Prompt Quality Rules** (80 tokens)
+- Be specific and descriptive (not generic)
+- Include scene details, angles, perspective
+- Specify lighting, time of day if relevant
+- Mention style references
+- Ensure diversity across all images
+- No duplicate concepts
+
+**Section 4: Output Format** (50 tokens)
+- JSON structure
+- Show example with good vs bad prompts
+
+#### Proposed Template Prompt Improvement
+
+Replace current template with:
+
+```
+A {style} photograph for "{post_title}". {image_prompt}.
+Composition: {composition_hint}. Lighting: {lighting_hint}.
+Mood: {mood}. Style: clean, modern, editorial web content.
+No text, watermarks, or logos.
+```
+
+Where:
+- {style} - photographic, minimalist, lifestyle, etc.
+- {composition_hint} - center-framed, rule-of-thirds, wide-angle, etc.
+- {lighting_hint} - natural daylight, soft indoor, dramatic, etc.
+- {mood} - professional, warm, energetic, calm, etc.
+
+---
+
+## Implementation Plan
+
+### Phase 1: Clustering Prompt (Week 1)
+
+**Tasks:**
+1. ✅ Draft new clustering prompt with examples
+2. ✅ Test with sample keyword sets (20, 50, 100 keywords)
+3. ✅ Compare outputs: old vs new
+4. ✅ Validate cluster quality (manual review)
+5. ✅ Update `PromptRegistry.DEFAULT_PROMPTS['clustering']`
+6. ✅ Deploy and monitor
+
+**Success Criteria:**
+- Consistent cluster count (5-15)
+- No single-keyword clusters
+- Clear, descriptive names
+- Concise descriptions (20-30 words)
+- 95%+ of keywords clustered
+
+---
+
+### Phase 2: Idea Generation Prompt (Week 1-2)
+
+**Tasks:**
+1. ✅ Draft new ideas prompt with examples
+2. ✅ Test with 5-10 clusters
+3. ✅ Validate cluster_hub vs supporting idea distinction
+4. ✅ Check covered_keywords accuracy
+5. ✅ Verify content_structure alignment
+6. ✅ Update `PromptRegistry.DEFAULT_PROMPTS['ideas']`
+7. ✅ Deploy and monitor
+
+**Success Criteria:**
+- Clear distinction between hub and supporting ideas
+- Accurate covered_keywords extraction
+- Appropriate word count estimates
+- Outlines match content_structure type
+- No duplicate ideas within cluster
+
+---
+
+### Phase 3: Content Generation Prompt (Week 2)
+
+**Tasks:**
+1. ✅ Draft new content prompt with word count logic
+2. ✅ Implement dynamic variable replacement in `build_prompt()`
+3. ✅ Test with 500, 1000, 1500 word targets
+4. ✅ Validate actual word counts (automated counting)
+5. ✅ Test all content_structure types
+6. ✅ Verify HTML quality and consistency
+7. ✅ Update `PromptRegistry.DEFAULT_PROMPTS['content_generation']`
+8. ✅ Deploy and monitor
+
+**Code Change Required:**
+
+**File:** `backend/igny8_core/ai/functions/generate_content.py`
+
+**Method:** `build_prompt()`
+
+**Add word count calculation:**
+
+```python
+def build_prompt(self, data: Any, account=None) -> str:
+ task = data if not isinstance(data, list) else data[0]
+
+ # Calculate adaptive word count parameters
+ target_words = task.word_count or 1000
+
+ if target_words <= 600:
+ intro_words = 60
+ section_count = 5
+ section_words = 80
+ hook_words = 25
+ elif target_words <= 1200:
+ intro_words = 120
+ section_count = 6
+ section_words = 140
+ hook_words = 35
+ else:
+ intro_words = 180
+ section_count = 7
+ section_words = 180
+ hook_words = 45
+
+ # Get prompt and replace variables
+ prompt = PromptRegistry.get_prompt(
+ function_name='generate_content',
+ account=account,
+ task=task,
+ context={
+ 'TARGET_WORD_COUNT': target_words,
+ 'INTRO_WORDS': intro_words,
+ 'SECTION_COUNT': section_count,
+ 'SECTION_WORDS': section_words,
+ 'HOOK_WORDS': hook_words,
+ # ... existing context
+ }
+ )
+
+ return prompt
+```
+
+**Success Criteria:**
+- 95%+ of generated content within ±5% of target word count
+- HTML structure consistent
+- Content structure types clearly differentiated
+- Keyword integration natural
+- No sections starting with lists
+
+---
+
+### Phase 4: Image Prompt Improvements (Week 2-3)
+
+**Tasks:**
+1. ✅ Draft new extraction prompt with placement guidelines
+2. ✅ Draft new template prompt with style variables
+3. ✅ Test with 10 sample articles
+4. ✅ Validate image diversity and relevance
+5. ✅ Update both prompts in registry
+6. ✅ Update `GenerateImagePromptsFunction` to use new template
+7. ✅ Deploy and monitor
+
+**Success Criteria:**
+- No duplicate image concepts in same article
+- Prompts are specific and detailed
+- Featured image distinct from in-article images
+- Image placement logically distributed
+- Generated images relevant to content
+
+---
+
+## Prompt Versioning & Testing
+
+### Version Control
+
+**Recommendation:** Store prompt versions in database for A/B testing
+
+**Schema:**
+
+```python
+class AIPromptVersion(models.Model):
+ prompt_type = CharField(choices=PROMPT_TYPE_CHOICES)
+ version = IntegerField()
+ prompt_value = TextField()
+ is_active = BooleanField(default=False)
+ created_at = DateTimeField(auto_now_add=True)
+ performance_metrics = JSONField(default=dict) # Track success rates
+```
+
+**Process:**
+1. Test new prompt version alongside current
+2. Compare outputs on same inputs
+3. Measure quality metrics (manual + automated)
+4. Gradually roll out if better
+5. Keep old version as fallback
+
+---
+
+### Automated Quality Metrics
+
+**Implement automated checks:**
+
+| Metric | Check | Threshold |
+|--------|-------|-----------|
+| Word Count Accuracy | `abs(actual - target) / target` | < 0.05 (±5%) |
+| HTML Validity | Parse with BeautifulSoup | 100% valid |
+| Keyword Presence | Count keyword mentions | ≥ 3 for primary |
+| Structure Compliance | Check H2/H3 hierarchy | Valid structure |
+| Cluster Count | Number of clusters | 5-15 |
+| Cluster Size | Keywords per cluster | 3-10 |
+| No Duplicates | Keyword appears once | 100% unique |
+
+**Log results:**
+- Track per prompt version
+- Identify patterns in failures
+- Use for prompt iteration
+
+---
+
+## Model Selection & Optimization
+
+### Current Models
+
+**Location:** `backend/igny8_core/ai/settings.py`
+
+**Default Models per Function:**
+- Clustering: GPT-4 (expensive but accurate)
+- Ideas: GPT-4 (creative)
+- Content: GPT-4 (quality)
+- Image Prompts: GPT-3.5-turbo (simpler task)
+- Images: DALL-E 3 / Runware
+
+### Optimization Opportunities
+
+**Cost vs Quality Tradeoffs:**
+
+| Function | Current | Alternative | Cost Savings | Quality Impact |
+|----------|---------|-------------|--------------|----------------|
+| Clustering | GPT-4 | GPT-4-turbo | 50% | Minimal |
+| Ideas | GPT-4 | GPT-4-turbo | 50% | Minimal |
+| Content | GPT-4 | GPT-4-turbo | 50% | Test required |
+| Image Prompts | GPT-3.5 | Keep | - | - |
+
+**Recommendation:** Test GPT-4-turbo for all text generation tasks
+- Faster response time
+- 50% cost reduction
+- Similar quality for structured outputs
+
+---
+
+## Success Metrics
+
+- ✅ Word count accuracy: 95%+ within ±5%
+- ✅ Clustering quality: No single-keyword clusters
+- ✅ Idea generation: Clear hub vs supporting distinction
+- ✅ HTML validity: 100%
+- ✅ Keyword integration: Natural, not stuffed
+- ✅ Image prompt diversity: No duplicates
+- ✅ User satisfaction: Fewer manual edits needed
+- ✅ Processing time: <10s for 1000-word article
+- ✅ Credit cost: 30% reduction with model optimization
+
+---
+
+## Related Files Reference
+
+### Backend
+- `backend/igny8_core/ai/prompts.py` - Prompt registry and defaults
+- `backend/igny8_core/ai/functions/auto_cluster.py` - Clustering function
+- `backend/igny8_core/ai/functions/generate_ideas.py` - Ideas function
+- `backend/igny8_core/ai/functions/generate_content.py` - Content function
+- `backend/igny8_core/ai/functions/generate_image_prompts.py` - Image prompts
+- `backend/igny8_core/ai/settings.py` - Model configuration
+- `backend/igny8_core/modules/system/models.py` - AIPrompt model
+
+### Testing
+- Create test suite: `backend/igny8_core/ai/tests/test_prompts.py`
+- Test fixtures with sample inputs
+- Automated quality validation
+- Performance benchmarks
+
+---
+
+## Notes
+
+- All prompt changes should be tested on real data first
+- Keep old prompts in version history for rollback
+- Monitor user feedback on content quality
+- Consider user-customizable prompt templates (advanced feature)
+- Document prompt engineering best practices for team
+- SAG clustering prompt (mentioned in original doc) to be handled separately as specialized architecture
diff --git a/docs/PRE-LAUNCH/ITEM-4-PAGE-FLOW-UX.md b/docs/PRE-LAUNCH/ITEM-4-PAGE-FLOW-UX.md
new file mode 100644
index 00000000..c04a9fde
--- /dev/null
+++ b/docs/PRE-LAUNCH/ITEM-4-PAGE-FLOW-UX.md
@@ -0,0 +1,745 @@
+# Item 4: Page Flow and Workflow UX Improvements
+
+**Priority:** High
+**Target:** Production Launch
+**Last Updated:** December 11, 2025
+
+---
+
+## Overview
+
+Improve overall navigation, page structure, workflow clarity, and helper systems across all main user-facing areas including Setup, Workflow (Planner/Writer), Account, and Settings. This encompasses page flow standardization, helper notifications, tooltips, metrics panels, and notification systems.
+
+---
+
+## Current Implementation Analysis
+
+### Main Menu Groups
+
+**Location:** `frontend/src/layout/AppLayout.tsx` and navigation components
+
+**Current Groups:**
+1. **Setup** - Sites, Sectors, Integrations setup
+2. **Workflow** - Planner (Keywords, Clusters, Ideas) and Writer (Tasks, Content, Images)
+3. **Account** - Billing, Team, Profile
+4. **Settings** - System settings, prompts, preferences
+
+**Issues:**
+- Inconsistent page header patterns across groups
+- Some pages missing breadcrumbs or context
+- Linear workflows (Planner → Writer) not clearly guided
+- Cross-navigation between related pages unclear
+
+---
+
+### Page Header Component
+
+**Location:** `frontend/src/components/common/PageHeader.tsx`
+
+**Current Features:**
+- Page title
+- Last updated timestamp
+- Site/Sector selector (can be hidden)
+- Optional refresh button
+- Optional badge
+- Optional navigation tabs
+
+**Strengths:**
+✅ Standardized across modules
+✅ Site/sector context management
+✅ Auto-loads sectors when site changes
+
+**Missing:**
+❌ No breadcrumbs for deeper navigation
+❌ No contextual help link
+❌ No step indicators for workflows
+❌ No quick action buttons section
+
+---
+
+### Module Navigation Tabs
+
+**Location:** `frontend/src/components/navigation/ModuleNavigationTabs.tsx`
+
+**Current Usage:**
+- Planner pages: Keywords | Clusters | Ideas | Mapping
+- Writer pages: Tasks | Content | Images
+
+**Strengths:**
+✅ Consistent tab design
+✅ Active tab highlighting
+✅ Responsive layout
+
+**Missing:**
+❌ No tab progress indicators
+❌ No disabled state for incomplete prerequisites
+❌ No tooltips explaining each tab
+
+---
+
+### Helper Systems
+
+**Current State:**
+- No systematic helper notifications
+- No onboarding tooltips
+- No inline guidance text
+- No contextual help system
+
+**What's Needed:**
+- Welcome messages for first-time page visits
+- Tooltips for icons and complex actions
+- Inline help text under form fields
+- Step-by-step workflow banners
+- Contextual "Learn more" links
+
+---
+
+### Metrics Display
+
+**Current Locations:**
+- Dashboard: Overview metrics
+- Individual pages: Table counts, filters
+- Footer: Module-specific metrics (some pages only)
+
+**Component:** `frontend/src/components/dashboard/ModuleMetricsFooter.tsx`
+
+**Issues:**
+- Inconsistent placement (some pages have footer metrics, some don't)
+- No collapsible panel option
+- Metrics not updated in real-time
+- No metric explanations (tooltips)
+
+---
+
+## Required Improvements
+
+### A. Standardize Page Structure
+
+#### Universal Page Template
+
+All workflow pages should follow this structure:
+
+```tsx
+
+ {/* 1. Page Header */}
+
+ {/* Tables, forms, cards, etc. */}
+
+
+ {/* 6. Bottom Metrics Panel (collapsible) */}
+
+
+
+
+{/* Rich content tooltip */}
+
+ Clustering
+ Groups keywords by semantic similarity
+ Learn more →
+
+}>
+
+```
+
+---
+
+#### 4. InlineGuidance Component
+
+**File:** `frontend/src/components/helper/InlineGuidance.tsx` (NEW)
+
+**Purpose:** Small help text under form fields
+
+**Props:**
+```typescript
+interface InlineGuidanceProps {
+ text: string;
+ type?: 'info' | 'warning' | 'error';
+ icon?: ReactNode;
+}
+```
+
+**UI Design:**
+```
+[Input Field: Enter keyword]
+ℹ️ Use lowercase, no special characters. Separate multiple keywords with commas.
+```
+
+**Usage:**
+```tsx
+
+
+
+```
+
+---
+
+#### 5. Enhanced MetricsPanel Component
+
+**File:** `frontend/src/components/dashboard/ModuleMetricsPanel.tsx` (NEW)
+
+**Improvements over current MetricsFooter:**
+- Collapsible/expandable
+- Fixed to bottom or inline at page bottom
+- Real-time updates
+- Tooltips explaining each metric
+- Click to filter/drill-down
+- Export metrics option
+
+**Props:**
+```typescript
+interface MetricsPanelProps {
+ title: string;
+ metrics: Array<{
+ label: string;
+ value: string | number;
+ subtitle?: string;
+ icon?: ReactNode;
+ color?: string;
+ tooltip?: string;
+ onClick?: () => void;
+ }>;
+ collapsible?: boolean;
+ defaultCollapsed?: boolean;
+ position?: 'fixed' | 'relative';
+}
+```
+
+**UI Design (Expanded):**
+```
+┌─────────────────────────────────────────────────────────┐
+│ ▼ Keyword Metrics [Collapse] × │
+├─────────────────────────────────────────────────────────┤
+│ Total: 450 │ New: 120 │ Mapped: 330 │ Vol: 125K │
+│ ℹ️ All saved │ ℹ️ Unmapped │ ℹ️ In cluster │ ℹ️ Search │
+│ │ │ │ volume │
+└─────────────────────────────────────────────────────────┘
+```
+
+**UI Design (Collapsed):**
+```
+▶ Keyword Metrics: 450 total, 120 new, 330 mapped
+```
+
+---
+
+### C. Navigation Improvements
+
+#### 1. Add Breadcrumbs
+
+**Component:** `frontend/src/components/navigation/Breadcrumbs.tsx` (NEW)
+
+**Usage:**
+```tsx
+
+
+```
+
+---
+
+### E. Notification System
+
+#### Notification Types
+
+| Type | Use Case | Display | Action |
+|------|----------|---------|--------|
+| **Progress** | Task started, queued, processing | Blue info icon | View progress modal |
+| **Success** | Task completed, export success | Green check icon | View result |
+| **Failure** | API error, validation failed | Red error icon | View error details, retry |
+| **Action Required** | Missing settings, incomplete setup | Orange warning icon | Navigate to fix |
+
+#### Notification Dropdown
+
+**Location:** Header, bell icon with badge count
+
+**Features:**
+- List notifications chronologically
+- Read/unread states
+- Mark all as read
+- Filter by type
+- Clear all button
+- Links to relevant pages
+
+**Example Notification:**
+```
+┌─────────────────────────────────────────────┐
+│ 🔵 Content Generation Started │
+│ "Best SEO Tools 2024" - 2 minutes ago │
+│ [View Progress] │
+├─────────────────────────────────────────────┤
+│ ✅ Clustering Completed │
+│ 45 keywords → 8 clusters - 10 min ago │
+│ [View Clusters] │
+├─────────────────────────────────────────────┤
+│ ❌ Image Generation Failed │
+│ Insufficient credits - 1 hour ago │
+│ [Purchase Credits] [Dismiss] │
+└─────────────────────────────────────────────┘
+```
+
+#### Implementation
+
+**Backend:**
+- Create `Notification` model with account FK
+- API endpoints: list, mark read, clear
+- Emit notifications on key events
+
+**Frontend:**
+- `useNotifications()` hook
+- `NotificationDropdown` component
+- Auto-refresh every 30 seconds
+- WebSocket support (future enhancement)
+
+---
+
+### F. Header Metrics Enhancement
+
+**Current:** Basic stats in dashboard
+
+**Improved:** Always-visible header metrics
+
+**Location:** Right side of header (next to user menu)
+
+**Display:**
+```
+[Icon] 3 In Progress | [Icon] 5 Completed | [Icon] 2,450 Credits | [Bell] 7
+```
+
+**Click to expand:**
+- In Progress: Show list of running tasks
+- Completed: Recent completions
+- Credits: Usage breakdown, purchase link
+- Bell: Notification dropdown
+
+---
+
+## Page-Specific Improvements
+
+### Planner Pages
+
+#### Keywords Page
+
+**Add:**
+- ✅ Helper: "Import keywords or add manually to start"
+- ✅ Tooltip on "Cluster" button: "Group keywords by semantic similarity"
+- ✅ Inline guidance on import: "CSV format: keyword, volume, difficulty"
+- ✅ Next step button: "Cluster Keywords →"
+- ✅ Metrics panel: Total, New, Mapped, Avg Volume
+
+#### Clusters Page
+
+**Add:**
+- ✅ Helper: "Clusters organize keywords into topic groups"
+- ✅ Step banner: Step 2/3 in Planner workflow
+- ✅ Tooltip on cluster cards: Show keyword count, volume
+- ✅ Next step: "Generate Ideas →"
+- ✅ Metrics panel: Clusters, Avg size, Total volume
+
+#### Ideas Page
+
+**Add:**
+- ✅ Helper: "Content ideas are generated from your clusters"
+- ✅ Step banner: Step 3/3 in Planner workflow
+- ✅ Content structure badge with tooltip
+- ✅ Next step: "Create Tasks →" (converts to tasks)
+- ✅ Metrics panel: Ideas, Cluster hubs, Word count estimates
+
+---
+
+### Writer Pages
+
+#### Tasks Page
+
+**Add:**
+- ✅ Helper: "Tasks are content generation jobs queued for AI"
+- ✅ Step banner: Step 1/3 in Writer workflow
+- ✅ Status badges with tooltips
+- ✅ Next step: "Generate Content →"
+- ✅ Metrics panel: Total tasks, Queued, Completed, Total words
+
+#### Content Page
+
+**Add:**
+- ✅ Helper: "Review and edit AI-generated content before publishing"
+- ✅ Step banner: Step 2/3 in Writer workflow
+- ✅ Status badges (draft/review/published)
+- ✅ Next step: "Generate Images →"
+- ✅ Metrics panel: Total content, Drafts, Published, Total words
+
+#### Images Page
+
+**Add:**
+- ✅ Helper: "Generate images for your content from AI prompts"
+- ✅ Step banner: Step 3/3 in Writer workflow
+- ✅ Image preview on hover
+- ✅ Next step: "Publish to WordPress →"
+- ✅ Metrics panel: Total images, Generated, Published
+
+---
+
+### Automation Page
+
+**Add:**
+- ✅ Helper: "Automation runs the entire workflow automatically"
+- ✅ Stage progress cards with clear metrics
+- ✅ Pause/Resume/Cancel controls
+- ✅ Real-time stage updates
+- ✅ Estimated completion time
+- ✅ Credit consumption display
+
+---
+
+## Implementation Plan
+
+### Phase 1: New Components (Week 1)
+1. ✅ Create StepBanner component
+2. ✅ Create HelperNotification component
+3. ✅ Enhance Tooltip component
+4. ✅ Create InlineGuidance component
+5. ✅ Create MetricsPanel component
+
+### Phase 2: Navigation (Week 1-2)
+1. ✅ Create Breadcrumbs component
+2. ✅ Add cross-navigation buttons
+3. ✅ Implement workflow progress indicator
+4. ✅ Update ModuleNavigationTabs with tooltips
+
+### Phase 3: Settings Reorganization (Week 2)
+1. ✅ Create new Settings pages structure
+2. ✅ Migrate existing settings
+3. ✅ Create Settings hub landing page
+4. ✅ Add category cards
+
+### Phase 4: Notification System (Week 2-3)
+1. ✅ Create Notification model (backend)
+2. ✅ Create notification endpoints
+3. ✅ Create NotificationDropdown component
+4. ✅ Integrate with existing workflows
+5. ✅ Add bell icon with badge to header
+
+### Phase 5: Page Updates (Week 3)
+1. ✅ Update all Planner pages with new components
+2. ✅ Update all Writer pages with new components
+3. ✅ Update Automation page
+4. ✅ Add helpers, tooltips, metrics to each page
+
+---
+
+## Success Metrics
+
+- ✅ All workflow pages have step banners
+- ✅ All pages have helper notifications on first visit
+- ✅ All icons and actions have tooltips
+- ✅ All form fields have inline guidance
+- ✅ Settings are organized and easy to find
+- ✅ Users receive notifications for all key events
+- ✅ Cross-navigation reduces clicks to complete workflows
+- ✅ Metrics panels show real-time data
+- ✅ User feedback indicates clearer navigation
+
+---
+
+## Related Files Reference
+
+### Components (NEW)
+- `frontend/src/components/workflow/StepBanner.tsx`
+- `frontend/src/components/helper/HelperNotification.tsx`
+- `frontend/src/components/helper/InlineGuidance.tsx`
+- `frontend/src/components/navigation/Breadcrumbs.tsx`
+- `frontend/src/components/dashboard/MetricsPanel.tsx`
+- `frontend/src/components/notifications/NotificationDropdown.tsx`
+
+### Components (Enhance)
+- `frontend/src/components/common/PageHeader.tsx`
+- `frontend/src/components/navigation/ModuleNavigationTabs.tsx`
+- `frontend/src/components/ui/Tooltip.tsx`
+
+### Pages (Update)
+- All `frontend/src/pages/Planner/*.tsx`
+- All `frontend/src/pages/Writer/*.tsx`
+- `frontend/src/pages/Automation/*.tsx`
+- `frontend/src/pages/Settings/*.tsx` (reorganize)
+
+### Backend (NEW)
+- `backend/igny8_core/modules/system/models.py` - Add Notification model
+- `backend/igny8_core/modules/system/views.py` - Notification endpoints
+
+---
+
+## Notes
+
+- Helper notifications should be non-intrusive and dismissible
+- Tooltips should be brief (2-3 sentences max)
+- Metrics should update in real-time or near-real-time
+- Settings should be searchable (future enhancement)
+- Consider onboarding tour for new users (future phase)
+- All guidance text should be editable by admin (future enhancement)
diff --git a/docs/PRE-LAUNCH/ITEM-5-WORDPRESS-TEMPLATES.md b/docs/PRE-LAUNCH/ITEM-5-WORDPRESS-TEMPLATES.md
new file mode 100644
index 00000000..7f6584ab
--- /dev/null
+++ b/docs/PRE-LAUNCH/ITEM-5-WORDPRESS-TEMPLATES.md
@@ -0,0 +1,736 @@
+# Item 5: WordPress Content Template Improvements and Redesign
+
+**Priority:** High
+**Target:** Production Launch
+**Last Updated:** December 11, 2025
+
+---
+
+## Overview
+
+Redesign WordPress content templates to optimize image placement, content structure, and cluster hub landing pages. Implement adaptive templates for different article lengths (500, 1000, 1500 words) with intelligent image reuse logic and proper HTML formatting.
+
+---
+
+## Current Implementation Analysis
+
+### Content Template System
+
+**Location:** `backend/igny8_core/modules/publisher/` and content generation
+
+**Current State:**
+- Content generated as HTML in `Content.content_html` field
+- Images generated separately with prompts
+- No formal template system for WordPress publishing
+- Image placement done during content generation, not during publishing
+
+**Issues:**
+- No consistent image placement strategy
+- No adaptation for article length
+- Image reuse logic not implemented
+- Cluster hub pages not differentiated from regular content
+
+---
+
+### Content HTML Structure
+
+**Generated by:** `backend/igny8_core/ai/functions/generate_content.py`
+
+**Current Format:**
+```html
+Hook text...
+Introduction paragraph 1...
+Introduction paragraph 2...
+
+Section Heading 1
+Section content...
+
+ - List item 1
+ - List item 2
+
+
+Section Heading 2
+Section content...
+
+ Column 1 Column 2 Data 1 Data 2
+
+
+```
+
+**Issues:**
+- No image tags in HTML (images added separately)
+- No placeholder markers for image insertion
+- Section lengths not adaptive to total word count
+- Table structures sometimes inconsistent
+
+---
+
+### Image System
+
+**Models:**
+- `ContentImage` - Stores image URL, prompt, type (featured/in-article), position
+- Linked to `Content` via foreign key
+
+**Current Image Generation:**
+1. Content generated with HTML
+2. Image prompts extracted from content
+3. Images generated from prompts
+4. Images stored in `ContentImage` table
+5. Publishing combines content HTML + image URLs
+
+**Issues:**
+- No clear insertion points in HTML
+- Image position field not always used correctly
+- Featured image vs in-article distinction unclear
+- No reuse logic when fewer images than placeholders
+
+---
+
+## Image Placement Strategy
+
+### Placement Rules by Article Length
+
+#### 500-Word Article
+**Structure:** Intro + 2 sections + Conclusion
+
+**Image Placement:**
+- Position 1: After introduction (before first H2)
+- Position 2: Mid-article (before second H2 or within)
+- Position 3: Before conclusion (optional, if 3 images available)
+
+**Total Images:** 2-3
+
+---
+
+#### 1000-Word Article
+**Structure:** Intro + 4-5 sections + Conclusion
+
+**Image Placement:**
+- Position 1: After introduction
+- Position 2: After section 2
+- Position 3: After section 3 or 4 (mid-article)
+- Position 4: Before conclusion
+- Position 5: Within longest section (optional)
+
+**Total Images:** 3-5
+
+---
+
+#### 1500-Word Article
+**Structure:** Intro + 6-8 sections + Conclusion
+
+**Image Placement:**
+- Position 1: After introduction
+- Position 2: After section 2
+- Position 3: Mid-article (after section 4)
+- Position 4: After section 5 or 6
+- Position 5: Before conclusion
+- Position 6-7: Within longer sections (optional)
+
+**Total Images:** 4-7
+
+---
+
+### Image Reuse Logic
+
+**Scenario:** Not enough images for all placement positions
+
+| Available Images | Reuse Strategy |
+|------------------|----------------|
+| 1 image | Use 3 times: after intro, mid-article, before conclusion |
+| 2 images | Alternate: Image 1 → Image 2 → Image 1 → Image 2 (repeat pattern) |
+| 3 images | Use each twice: distribute evenly across positions |
+| 4+ images | Use each once until exhausted, then reuse starting from first |
+
+**Implementation Logic:**
+
+```python
+def get_image_for_position(position: int, available_images: list) -> Image:
+ """
+ Get image for a specific position using reuse logic.
+
+ Args:
+ position: 0-indexed position (0 = after intro, 1 = mid-article, etc.)
+ available_images: List of ContentImage objects
+
+ Returns:
+ ContentImage object to use at this position
+ """
+ if not available_images:
+ return None
+
+ num_images = len(available_images)
+
+ if num_images == 1:
+ # Reuse single image everywhere
+ return available_images[0]
+
+ elif num_images == 2:
+ # Alternate between images
+ return available_images[position % 2]
+
+ elif num_images == 3:
+ # Use each twice (0,1,2,0,1,2)
+ return available_images[position % 3]
+
+ else:
+ # Use each once, then repeat
+ return available_images[position % num_images]
+```
+
+---
+
+## Template System Design
+
+### Template Structure
+
+**Create:** `backend/igny8_core/modules/publisher/templates.py` (NEW)
+
+**Purpose:** Format content + images for WordPress publishing
+
+---
+
+### Base Content Template
+
+**Class:** `ContentTemplate`
+
+**Methods:**
+
+| Method | Purpose | Returns |
+|--------|---------|---------|
+| `prepare_content(content, images)` | Main entry point | Formatted HTML |
+| `insert_images(html, images, word_count)` | Insert images at positions | HTML with images |
+| `get_image_positions(word_count)` | Calculate insertion points | List of positions |
+| `format_image_html(image, alt_text)` | Format single image tag | HTML string |
+| `add_featured_image_meta(content, image)` | Set WordPress featured image | Meta dict |
+
+---
+
+### 500-Word Template
+
+**Class:** `ShortFormTemplate(ContentTemplate)`
+
+**Structure:**
+```html
+
+
+ Hook...
+ Intro paragraph 1...
+ Intro paragraph 2...
+
+
+
+ 
+ Image caption (optional)
+
+
+
+ Section Heading 1
+ Section content...
+
+
+
+
+
+
+
+ Section Heading 2
+ Section content...
+
+
+ Conclusion...
+
+```
+
+**Characteristics:**
+- 2-3 images total
+- Shorter sections (80-100 words each)
+- Minimal subsections
+- Concise lists and tables
+
+---
+
+### 1000-Word Template
+
+**Class:** `StandardTemplate(ContentTemplate)`
+
+**Structure:**
+```html
+
+
+ Hook...
+ Intro paragraphs...
+
+
+ ...
+
+
+ Section Heading 1
+ Paragraphs...
+ Subsection 1.1
+ Content...
+
+
+ Section Heading 2
+ Content...
+
+
+ ...
+
+
+ Section Heading 3
+ ...
+
+
+ ...
+
+
+ Section Heading 4
+ ...
+
+
+ ...
+
+
+ Conclusion
+ Summary and CTA...
+
+```
+
+**Characteristics:**
+- 3-5 images
+- Standard sections (140-160 words each)
+- 2-3 subsections per section
+- Mix of content types (paragraphs, lists, tables)
+
+---
+
+### 1500-Word Template
+
+**Class:** `LongFormTemplate(ContentTemplate)`
+
+**Structure:**
+```html
+
+
+ Hook (45 words)...
+ Intro paragraph 1 (70 words)...
+ Intro paragraph 2 (65 words)...
+
+
+ ...
+
+
+ Section Heading 1
+ Opening paragraph (80 words)...
+ Subsection 1.1
+ Content (50 words)...
+ Subsection 1.2
+ Content (50 words)...
+
+
+ Section Heading 2
+ Content...
+
+
+ ...
+
+
+
+
+ Section Heading 7
+ Final content section...
+
+
+ ...
+
+
+ Conclusion
+ Summary paragraph...
+ Call to action...
+
+```
+
+**Characteristics:**
+- 4-7 images
+- Longer sections (180-200 words each)
+- 3-4 subsections per section
+- Deeper content with more examples
+- Optional info boxes or callouts
+
+---
+
+## Cluster Hub Landing Page Template
+
+**Purpose:** Comprehensive resource page for topic clusters
+
+**Class:** `ClusterHubTemplate(ContentTemplate)`
+
+### Structure
+
+```html
+
+
+
+ {Cluster Name}
+ {Cluster Description}
+
+
+
+
+
+
+
+ What is {Cluster Name}?
+ Comprehensive introduction to the topic...
+ Why it matters and what you'll learn...
+
+
+
+
+ Key Concepts
+
+
+ Concept 1
+ Brief explanation...
+
+
+
+
+
+
+ ...
+
+
+
+ Explore Related Topics
+
+
+
+
+
+
+
+
+ Latest Articles
+
+
+
+
+
+
+
+
+
+
+
+ Most Popular
+
+
+
+
+
+
+
+ Stay Updated
+ Get the latest insights on {Cluster Name}...
+
+
+
+
+
+
+```
+
+---
+
+### Cluster Hub Features
+
+| Feature | Implementation | Purpose |
+|---------|----------------|---------|
+| **Hero Image** | Full-width banner | Visual impact, brand identity |
+| **Concept Cards** | 3-6 key concepts | Quick overview, scannable |
+| **Subcluster Grid** | Links to child clusters | Hierarchy navigation |
+| **Latest Articles** | Auto-query by cluster_id | Fresh content |
+| **Popular Articles** | Sorted by view_count | Engagement driver |
+| **CTA Block** | Email signup or action | Lead generation |
+| **Footer Nav** | Related cluster links | Internal linking |
+
+---
+
+### Conditional Variants
+
+#### Category Archive (WordPress Taxonomy)
+
+**Differences from Cluster Hub:**
+- Shows WordPress category tree
+- Includes post count per category
+- Pagination for article list
+- Filter by date, popularity
+
+#### Tag Archive
+
+**Differences:**
+- Shows related tags as cloud
+- Simpler layout (no hero, no concepts)
+- Focus on article list
+- Sorted by relevance
+
+#### Attribute Archive (Product/Service)
+
+**Differences:**
+- Shows attribute filter options
+- Product/service grid instead of article list
+- Comparison table
+- Filter by attribute values
+
+---
+
+## Implementation Plan
+
+### Phase 1: Template System Foundation (Week 1)
+
+**Tasks:**
+1. ✅ Create `ContentTemplate` base class
+2. ✅ Implement image position calculator
+3. ✅ Implement image reuse logic
+4. ✅ Create image HTML formatter with figure tags
+5. ✅ Add WordPress meta integration (featured image)
+
+**File:** `backend/igny8_core/modules/publisher/templates.py` (NEW)
+
+---
+
+### Phase 2: Article Length Templates (Week 1-2)
+
+**Tasks:**
+1. ✅ Implement `ShortFormTemplate` (500 words)
+2. ✅ Implement `StandardTemplate` (1000 words)
+3. ✅ Implement `LongFormTemplate` (1500 words)
+4. ✅ Test image insertion for each template
+5. ✅ Validate HTML output
+
+**Testing:**
+- Generate 10 articles per template
+- Verify word counts
+- Check image placement
+- Validate HTML structure
+
+---
+
+### Phase 3: Cluster Hub Template (Week 2)
+
+**Tasks:**
+1. ✅ Implement `ClusterHubTemplate`
+2. ✅ Create hero section builder
+3. ✅ Create concept card generator
+4. ✅ Implement article list query
+5. ✅ Add related cluster links
+6. ✅ Test with real clusters
+
+**File:** Same as Phase 1
+
+---
+
+### Phase 4: Publishing Integration (Week 2-3)
+
+**Tasks:**
+1. ✅ Update WordPress publisher to use templates
+2. ✅ Pass content + images to template
+3. ✅ Generate final HTML
+4. ✅ Send to WordPress with featured image meta
+5. ✅ Test full publishing workflow
+
+**File:** `backend/igny8_core/modules/publisher/views.py`
+
+**Method:** `publish_to_wordpress()`
+
+**Changes:**
+
+```python
+def publish_to_wordpress(content_id):
+ content = Content.objects.get(id=content_id)
+ images = ContentImage.objects.filter(content=content).order_by('position')
+
+ # Select template based on word count
+ if content.word_count <= 600:
+ template = ShortFormTemplate()
+ elif content.word_count <= 1200:
+ template = StandardTemplate()
+ else:
+ template = LongFormTemplate()
+
+ # Prepare content with images
+ final_html = template.prepare_content(content, images)
+
+ # Get featured image
+ featured_image = images.filter(type='featured').first()
+
+ # Publish to WordPress
+ wp_client.create_post(
+ title=content.title,
+ content=final_html,
+ featured_image_url=featured_image.image_url if featured_image else None,
+ # ... other meta
+ )
+```
+
+---
+
+### Phase 5: Taxonomy Templates (Week 3)
+
+**Tasks:**
+1. ✅ Implement category archive variant
+2. ✅ Implement tag archive variant
+3. ✅ Implement attribute archive variant
+4. ✅ Add conditional rendering logic
+5. ✅ Test all taxonomy types
+
+---
+
+## HTML Quality Standards
+
+### Image Tags
+
+**Format:**
+```html
+
+ 
+ {optional_caption}
+
+```
+
+**Alt Text Generation:**
+- Extract from image prompt
+- Include relevant keywords
+- Descriptive, not generic ("Person using laptop" → "Digital marketer analyzing SEO metrics on laptop")
+
+---
+
+### Responsive Images (Future)
+
+**Enhancement:**
+```html
+
+```
+
+**Requires:** Image resizing service or WordPress handling
+
+---
+
+### Content Wrapper
+
+**Purpose:** Consistent styling and layout
+
+```html
+
+
+
+```
+
+**WordPress Classes:**
+- `entry-content` - Standard WordPress content class
+- `wp-block-*` - Gutenberg block classes for proper styling
+
+---
+
+## Testing Requirements
+
+### Template Output Tests
+
+| Test Case | Expected Result |
+|-----------|-----------------|
+| 500-word article with 1 image | Image reused 3 times at strategic positions |
+| 1000-word article with 3 images | Each image used once, evenly distributed |
+| 1500-word article with 5 images | Images at intro, mid-points, and conclusion |
+| Article with 0 images | No image tags, content flows normally |
+| Cluster hub page | All sections rendered, related content populated |
+
+---
+
+### HTML Validation
+
+- ✅ All HTML valid (W3C validator)
+- ✅ All image tags have alt text
+- ✅ Heading hierarchy correct (H1 → H2 → H3)
+- ✅ No broken image links
+- ✅ Figure tags properly closed
+- ✅ WordPress classes applied correctly
+
+---
+
+### WordPress Integration Tests
+
+- ✅ Featured image set correctly
+- ✅ Images appear in correct positions
+- ✅ Content renders properly in WordPress editor
+- ✅ Mobile responsive (WordPress theme handles)
+- ✅ Image captions display correctly
+- ✅ Internal links work
+
+---
+
+## Success Metrics
+
+- ✅ 100% of articles have images placed correctly
+- ✅ Image reuse logic works for all scenarios
+- ✅ Article lengths match templates (±5% tolerance)
+- ✅ HTML validates 100%
+- ✅ Cluster hubs render all sections
+- ✅ WordPress publishing succeeds 100%
+- ✅ User feedback: content looks professional
+- ✅ No manual image placement needed
+
+---
+
+## Related Files Reference
+
+### Backend (NEW)
+- `backend/igny8_core/modules/publisher/templates.py` - Template system
+- `backend/igny8_core/modules/publisher/image_manager.py` - Image reuse logic
+
+### Backend (Update)
+- `backend/igny8_core/modules/publisher/views.py` - Publishing integration
+- `backend/igny8_core/ai/functions/generate_content.py` - Content structure
+
+### Models
+- `backend/igny8_core/business/content/models.py` - Content, ContentImage models
+
+---
+
+## Notes
+
+- Templates should be flexible enough for custom themes
+- Image captions optional (can extract from prompt or leave empty)
+- Cluster hub template can be used for category/tag pages
+- Consider adding shortcode support for advanced layouts
+- Future: Allow custom template selection per content piece
+- Future: Visual template editor for admins
diff --git a/docs/PRE-LAUNCH/ITEM-6-MARKETING-SITE.md b/docs/PRE-LAUNCH/ITEM-6-MARKETING-SITE.md
new file mode 100644
index 00000000..19c17412
--- /dev/null
+++ b/docs/PRE-LAUNCH/ITEM-6-MARKETING-SITE.md
@@ -0,0 +1,707 @@
+# Item 6: Frontend Marketing Site Updates
+
+**Priority:** High
+**Target:** Production Launch
+**Last Updated:** December 11, 2025
+
+---
+
+## Overview
+
+Update and polish the marketing website including homepage, features pages, product pages, use-case pages, pricing page, about, and contact pages. Ensure consistent branding, clear value propositions, and conversion-optimized layouts.
+
+---
+
+## Current Implementation
+
+### Marketing Site Structure
+
+**Location:** `frontend/src/pages/` (marketing section)
+
+**Current Pages:**
+- Homepage
+- Features (general)
+- Pricing
+- About
+- Contact
+- (Possibly others)
+
+**Issues:**
+- Content may be outdated or generic
+- Feature descriptions don't match current capabilities
+- Pricing page needs plan updates (from Item 2)
+- No dedicated product pages for each module
+- No use-case specific pages
+- Missing social proof and testimonials
+- CTAs not optimized
+
+---
+
+## Required Pages and Updates
+
+### A. Homepage
+
+**Location:** `frontend/src/pages/marketing/Home.tsx` or similar
+
+#### Current Issues
+- Value proposition unclear or generic
+- Feature highlights incomplete
+- Workflow demonstration missing
+- CTAs not prominent
+
+#### Required Sections
+
+**1. Hero Section**
+
+**Content:**
+- **Headline:** "AI-Powered Content Creation for SEO-Driven Websites"
+- **Subheadline:** "Transform your content strategy with semantic AI. Plan, write, and publish high-quality content that ranks."
+- **Primary CTA:** "Start Free Trial" (14-day trial, no credit card)
+- **Secondary CTA:** "See How It Works" (scroll to demo video)
+- **Hero Visual:** Animated workflow diagram or product screenshot
+
+**Design:**
+- Full-width, above fold
+- Gradient background or image
+- Logo grid: "Trusted by [companies/users]"
+
+---
+
+**2. Problem Statement**
+
+**Content:**
+- "Content creation is time-consuming and expensive"
+- "SEO is complex and constantly changing"
+- "Scaling content while maintaining quality is hard"
+- Visual: Problem illustration
+
+---
+
+**3. Solution Overview**
+
+**Content:**
+- "IGNY8 uses semantic AI to automate your entire content workflow"
+- 3 key benefits:
+ 1. **Plan:** AI clusters keywords into strategic topics
+ 2. **Write:** Generate SEO-optimized content in minutes
+ 3. **Publish:** Direct WordPress integration
+- Visual: 3-column benefit cards
+
+---
+
+**4. Feature Highlights**
+
+**Content:**
+- AI Planner: Keyword extraction → Clustering → Idea generation
+- AI Writer: Content generation → Image creation → SEO optimization
+- Automation: End-to-end workflow automation
+- Analytics: Track performance and ROI
+
+**Design:**
+- 4 feature cards with icons
+- Each card links to detailed feature page
+
+---
+
+**5. How It Works**
+
+**Content:**
+- Step-by-step workflow:
+ 1. Add keywords or import from GSC
+ 2. AI clusters keywords semantically
+ 3. Generate content ideas for each cluster
+ 4. AI writes SEO-optimized articles
+ 5. Generate images with AI
+ 6. Publish to WordPress automatically
+
+**Visual:**
+- Animated step diagram
+- Or short video demo (30-60 seconds)
+
+---
+
+**6. Social Proof**
+
+**Content:**
+- User testimonials (3-4 quotes)
+- Usage statistics:
+ - "10,000+ articles generated"
+ - "500+ active users"
+ - "95% time saved on content creation"
+- Company logos (if applicable)
+
+**Design:**
+- Testimonial cards with photos
+- Stats counter animation
+
+---
+
+**7. Pricing Preview**
+
+**Content:**
+- "Plans for every team size"
+- Show 3 plan tiers with key features
+- CTA: "View Full Pricing" → /pricing
+
+---
+
+**8. Final CTA**
+
+**Content:**
+- "Ready to transform your content strategy?"
+- Primary CTA: "Start Free Trial"
+- Secondary CTA: "Schedule Demo"
+
+---
+
+### B. Features Page
+
+**Location:** `frontend/src/pages/marketing/Features.tsx`
+
+#### Required Sections
+
+**1. Features Overview**
+
+**Content:**
+- List all major features with descriptions
+- Organized by category:
+ - **Planning & Strategy**
+ - Keyword Extraction
+ - Semantic Clustering
+ - Content Idea Generation
+ - SAG Mapping (if implemented)
+ - **Content Creation**
+ - AI Writing (multiple lengths)
+ - Content Structure Templates
+ - SEO Optimization
+ - Tone & Style Control
+ - **Visual Content**
+ - Image Prompt Generation
+ - AI Image Creation
+ - Image Optimization
+ - **Publishing & Distribution**
+ - WordPress Integration
+ - Automated Publishing
+ - Content Scheduling
+ - **Automation**
+ - End-to-end Workflow Automation
+ - Batch Processing
+ - Custom Workflows
+ - **Analytics & Insights**
+ - Content Performance Tracking
+ - SEO Metrics
+ - Credit Usage Reports
+
+**Design:**
+- Accordion or tab-based navigation
+- Feature cards with icons
+- "Learn More" links to detail pages
+
+---
+
+**2. Feature Comparison Table**
+
+**Content:**
+- Compare features across plans
+- Show which features are in which tier
+
+**Table:**
+
+| Feature | Free | Starter | Growth | Pro | Enterprise |
+|---------|------|---------|--------|-----|------------|
+| Keywords | 100 | 1,000 | 5,000 | 25,000 | Unlimited |
+| AI Clustering | ✓ | ✓ | ✓ | ✓ | ✓ |
+| Content Generation | ✓ | ✓ | ✓ | ✓ | ✓ |
+| Image Generation | ✓ | ✓ | ✓ | ✓ | ✓ |
+| WordPress Integration | ✓ | ✓ | ✓ | ✓ | ✓ |
+| Automation | ✗ | ✗ | ✓ | ✓ | ✓ |
+| API Access | ✗ | ✗ | ✓ | ✓ | ✓ |
+| Priority Support | ✗ | ✗ | ✗ | ✓ | ✓ |
+
+---
+
+### C. Product Pages (One per Module)
+
+**Create dedicated pages:**
+
+#### 1. AI Planner Page
+
+**URL:** `/product/planner`
+
+**Sections:**
+- Hero: "Plan Your Content Strategy with AI"
+- Problem: Manual keyword research is slow
+- Solution: Automated clustering and idea generation
+- Features:
+ - Keyword extraction from GSC
+ - Semantic clustering
+ - Content idea generation with outlines
+ - Visual cluster mapping
+- Use cases:
+ - Blog content planning
+ - Topic cluster strategy
+ - Content calendar creation
+- Demo video or screenshots
+- CTA: "Try Planner Free"
+
+---
+
+#### 2. AI Writer Page
+
+**URL:** `/product/writer`
+
+**Sections:**
+- Hero: "AI-Powered Content Creation"
+- Problem: Writing is time-consuming and expensive
+- Solution: Generate SEO-optimized content in minutes
+- Features:
+ - Multiple article lengths (500, 1000, 1500 words)
+ - Content structure templates
+ - SEO keyword integration
+ - Tone and style control
+- Use cases:
+ - Blog posts
+ - Product descriptions
+ - Landing pages
+ - Guides and tutorials
+- Demo video or screenshots
+- CTA: "Start Writing with AI"
+
+---
+
+#### 3. Automation Page
+
+**URL:** `/product/automation`
+
+**Sections:**
+- Hero: "Automate Your Entire Content Workflow"
+- Problem: Managing content at scale is complex
+- Solution: End-to-end automation from keywords to publication
+- Features:
+ - 7-stage automated workflow
+ - Batch processing
+ - Scheduled runs
+ - Progress monitoring
+- Use cases:
+ - Agency content production
+ - E-commerce catalog automation
+ - Multi-site management
+- Demo video or screenshots
+- CTA: "Automate Your Workflow"
+
+---
+
+### D. Use-Case Pages
+
+**Create industry/persona-specific pages:**
+
+#### 1. For Agencies
+
+**URL:** `/use-cases/agencies`
+
+**Content:**
+- Hero: "Scale Content Production for Your Clients"
+- Challenges: Managing multiple clients, tight deadlines, budget constraints
+- Solution: Automate content at scale without sacrificing quality
+- Features relevant to agencies:
+ - Multi-site management
+ - Team collaboration
+ - White-label potential (if applicable)
+ - Bulk operations
+- Case study or testimonial
+- Pricing: Focus on Growth and Pro plans
+- CTA: "Book Agency Demo"
+
+---
+
+#### 2. For E-commerce
+
+**URL:** `/use-cases/ecommerce`
+
+**Content:**
+- Hero: "Generate Product Content at Scale"
+- Challenges: Large product catalogs, SEO for products, content updates
+- Solution: Automate product descriptions, category pages, blog content
+- Features relevant to e-commerce:
+ - Product description generation
+ - Category landing pages
+ - SEO-optimized content
+ - Image generation for products
+- Case study or testimonial
+- CTA: "Start Free Trial"
+
+---
+
+#### 3. For Content Teams
+
+**URL:** `/use-cases/content-teams`
+
+**Content:**
+- Hero: "Supercharge Your Content Team"
+- Challenges: Content velocity, consistency, SEO optimization
+- Solution: AI assists writers, not replaces them
+- Features relevant to content teams:
+ - Content planning and ideation
+ - Draft generation
+ - SEO optimization
+ - Workflow automation
+- Case study or testimonial
+- CTA: "Try Team Plan"
+
+---
+
+### E. Pricing Page
+
+**Location:** `frontend/src/pages/marketing/Pricing.tsx`
+
+#### Required Updates (From Item 2)
+
+**1. Plan Tiers**
+
+Display all 5 tiers:
+- Free (hidden from public, internal only)
+- Starter ($29/mo or $299/year)
+- Growth ($99/mo or $1,019/year)
+- Pro ($299/mo or $3,077/year)
+- Enterprise (Custom pricing)
+
+**2. Monthly/Annual Toggle**
+
+- Default: Monthly
+- Show savings badge for annual ("Save 15%")
+- Update prices dynamically on toggle
+
+**3. Plan Cards**
+
+**Each card shows:**
+- Plan name
+- Price (monthly or annual)
+- "Most Popular" badge (Growth plan)
+- Key features (5-7 bullets):
+ - Monthly credits
+ - Max keywords, clusters, content, images
+ - Key features (automation, API, support)
+- CTA button:
+ - Free: "Start Free"
+ - Paid: "Start Trial" (14 days)
+ - Enterprise: "Contact Sales"
+
+**4. Detailed Comparison Table**
+
+Show full feature comparison (expandable):
+- All features listed
+- Checkmarks or values per plan
+- Tooltips explaining features
+
+**5. Credit System Explanation**
+
+**Section:**
+- "How Credits Work"
+- What credits are used for
+- How they're consumed (per operation)
+- How to buy more
+- Credit rollover rules (if applicable)
+
+**Example:**
+
+| Operation | Credits |
+|-----------|---------|
+| Keyword Clustering | 10 credits |
+| Idea Generation | 15 credits |
+| Content Generation (1000 words) | 10 credits |
+| Image Generation | 5 credits per image |
+
+**6. FAQ Section**
+
+**Questions to answer:**
+- What happens when I run out of credits?
+- Can I change plans mid-month?
+- Do unused credits roll over?
+- What's included in Enterprise?
+- Is there a free trial?
+- Can I cancel anytime?
+- What payment methods do you accept?
+- Do you offer refunds?
+
+**7. CTA Section**
+
+- "Still have questions?"
+- CTA: "Contact Sales" or "Schedule Demo"
+- Phone number, email, or chat option
+
+---
+
+### F. About Page
+
+**Location:** `frontend/src/pages/marketing/About.tsx`
+
+#### Required Sections
+
+**1. Mission Statement**
+
+- "Our mission is to democratize AI-powered content creation..."
+- Why IGNY8 exists
+- Vision for the future
+
+**2. Team** (if applicable)
+
+- Founder(s) photo and bio
+- Key team members
+- Company history/journey
+
+**3. Technology & Approach**
+
+- "Built on semantic AI and NLP"
+- Explanation of SAG architecture (simplified)
+- Why our approach is different/better
+
+**4. Values**
+
+- Quality over quantity
+- User-centric design
+- Transparency
+- Innovation
+
+**5. Contact**
+
+- How to reach us
+- Office location (if applicable)
+- Link to Contact page
+
+---
+
+### G. Contact Page
+
+**Location:** `frontend/src/pages/marketing/Contact.tsx`
+
+#### Required Elements
+
+**1. Contact Form**
+
+**Fields:**
+- Name (required)
+- Email (required)
+- Company (optional)
+- Message (required)
+- Subject dropdown:
+ - General Inquiry
+ - Sales
+ - Support
+ - Partnership
+ - Press
+
+**2. Alternative Contact Methods**
+
+- Email: support@igny8.com (or similar)
+- Phone: (if available)
+- Live chat: (if enabled)
+- Social media links
+
+**3. Support Resources**
+
+- Link to Help Center / Documentation
+- Link to FAQ
+- Link to Community (if applicable)
+
+**4. Office Location** (if applicable)
+
+- Address
+- Map embed
+
+---
+
+## Design & Branding Guidelines
+
+### Visual Design
+
+**Color Scheme:**
+- Primary: Brand blue/purple
+- Secondary: Accent colors
+- Neutral: Grays for text and backgrounds
+
+**Typography:**
+- Headings: Bold, clear hierarchy
+- Body: Readable, 16px+ base size
+- Code/monospace: For technical content
+
+**Imagery:**
+- Product screenshots
+- Workflow diagrams
+- Illustrations for concepts
+- Real user photos for testimonials
+
+**Icons:**
+- Consistent icon set throughout
+- Use for feature highlights, benefits
+
+---
+
+### Tone & Voice
+
+**Brand Voice:**
+- Professional but approachable
+- Technical but not jargon-heavy
+- Confident but not boastful
+- Helpful and supportive
+
+**Messaging Principles:**
+- Focus on benefits, not just features
+- Use clear, concise language
+- Avoid marketing fluff
+- Be specific with numbers and results
+- Address pain points directly
+
+---
+
+### Call-to-Actions
+
+**Primary CTAs:**
+- "Start Free Trial" (most common)
+- "Get Started Free"
+- "Try IGNY8 Free"
+
+**Secondary CTAs:**
+- "Schedule Demo"
+- "Contact Sales"
+- "Learn More"
+- "View Pricing"
+
+**CTA Design:**
+- Primary: Large, prominent button (brand color)
+- Secondary: Outline button or link
+- Clear contrast with background
+- Include arrow or icon for clarity
+
+---
+
+## SEO Optimization
+
+### Meta Tags
+
+**Each page needs:**
+- Title tag (50-60 chars)
+- Meta description (150-160 chars)
+- OG tags (for social sharing)
+- Schema markup (Organization, Product, FAQ)
+
+**Example (Homepage):**
+```html
+IGNY8 - AI-Powered Content Creation for SEO-Driven Websites
+
+
+
+
+```
+
+---
+
+### Keyword Optimization
+
+**Target Keywords per Page:**
+
+| Page | Primary Keyword | Secondary Keywords |
+|------|----------------|-------------------|
+| Homepage | AI content creation | SEO automation, content strategy, semantic AI |
+| Features | AI content platform features | content automation tools, SEO software |
+| Planner | AI content planning | keyword clustering, topic research, content ideation |
+| Writer | AI article writer | content generation, SEO writing, blog automation |
+| Pricing | AI content pricing | content automation cost, SEO software pricing |
+| Agencies | AI content for agencies | agency content automation, white-label content |
+
+---
+
+### Performance
+
+**Requirements:**
+- Page load time < 3 seconds
+- Lighthouse score > 90
+- Mobile-friendly (responsive)
+- Core Web Vitals: Pass all metrics
+
+---
+
+## Implementation Plan
+
+### Phase 1: Content Audit & Updates (Week 1)
+1. ✅ Audit all existing marketing pages
+2. ✅ Identify outdated or missing content
+3. ✅ Write new content for homepage
+4. ✅ Update features page content
+5. ✅ Draft about and contact pages
+
+### Phase 2: New Pages (Week 1-2)
+1. ✅ Create product pages (Planner, Writer, Automation)
+2. ✅ Create use-case pages (Agencies, E-commerce, Content Teams)
+3. ✅ Write content for each page
+4. ✅ Design page layouts
+
+### Phase 3: Pricing Page (Week 2)
+1. ✅ Implement plan comparison table
+2. ✅ Add monthly/annual toggle
+3. ✅ Add credit cost table
+4. ✅ Write FAQ section
+5. ✅ Test all CTAs
+
+### Phase 4: Design & Branding (Week 2-3)
+1. ✅ Finalize color scheme and typography
+2. ✅ Create or source imagery
+3. ✅ Design icons for features
+4. ✅ Create demo videos or screenshots
+5. ✅ Ensure mobile responsiveness
+
+### Phase 5: SEO & Performance (Week 3)
+1. ✅ Add meta tags to all pages
+2. ✅ Implement schema markup
+3. ✅ Optimize images (compression, lazy loading)
+4. ✅ Test page speed
+5. ✅ Submit sitemap to search engines
+
+---
+
+## Success Metrics
+
+- ✅ All pages load in < 3 seconds
+- ✅ Lighthouse score > 90 for all pages
+- ✅ Mobile responsive (all pages)
+- ✅ Clear value proposition on homepage
+- ✅ Pricing page matches Item 2 specifications
+- ✅ CTAs prominent and clear
+- ✅ SEO meta tags on all pages
+- ✅ Professional, consistent design
+- ✅ User feedback: easy to understand offering
+
+---
+
+## Related Files Reference
+
+### Frontend Pages
+- `frontend/src/pages/marketing/Home.tsx`
+- `frontend/src/pages/marketing/Features.tsx`
+- `frontend/src/pages/marketing/Pricing.tsx`
+- `frontend/src/pages/marketing/About.tsx`
+- `frontend/src/pages/marketing/Contact.tsx`
+- `frontend/src/pages/marketing/product/Planner.tsx` (NEW)
+- `frontend/src/pages/marketing/product/Writer.tsx` (NEW)
+- `frontend/src/pages/marketing/product/Automation.tsx` (NEW)
+- `frontend/src/pages/marketing/use-cases/Agencies.tsx` (NEW)
+- `frontend/src/pages/marketing/use-cases/Ecommerce.tsx` (NEW)
+- `frontend/src/pages/marketing/use-cases/ContentTeams.tsx` (NEW)
+
+### Components
+- `frontend/src/components/marketing/HeroSection.tsx`
+- `frontend/src/components/marketing/FeatureCard.tsx`
+- `frontend/src/components/marketing/PricingCard.tsx`
+- `frontend/src/components/marketing/TestimonialCard.tsx`
+- `frontend/src/components/marketing/CTASection.tsx`
+
+---
+
+## Notes
+
+- Keep messaging consistent across all pages
+- Test all CTAs and forms before launch
+- Consider A/B testing headlines and CTAs
+- Update screenshots when product UI changes
+- Consider adding live chat widget
+- Plan for ongoing content updates (blog, case studies)
+- Consider multilingual support (future phase)
diff --git a/docs/PRE-LAUNCH/ITEM-7-DOCUMENTATION.md b/docs/PRE-LAUNCH/ITEM-7-DOCUMENTATION.md
new file mode 100644
index 00000000..6d8fec3b
--- /dev/null
+++ b/docs/PRE-LAUNCH/ITEM-7-DOCUMENTATION.md
@@ -0,0 +1,832 @@
+# Item 7: Documentation Systems
+
+**Priority:** High
+**Target:** Production Launch
+**Last Updated:** December 11, 2025
+
+---
+
+## Overview
+
+Create comprehensive documentation systems including in-app help, marketing site documentation, API references, integration guides, workflow guides, and FAQs. Ensure users can self-serve for common questions and technical implementation.
+
+---
+
+## Current State Analysis
+
+### Existing Documentation
+
+**Location:** `docs/` folder in repository
+
+**Current Structure:**
+- System architecture docs
+- Backend models and services
+- Frontend components
+- API references (partial)
+- Deployment guides
+
+**Issues:**
+- Documentation scattered and incomplete
+- No user-facing help system
+- No in-app contextual help
+- API documentation not published
+- Integration guides missing
+- FAQ not comprehensive
+
+---
+
+## Required Documentation Types
+
+### A. In-App Documentation
+
+**Purpose:** Help users within the application
+
+---
+
+#### 1. Contextual Help System
+
+**Implementation:** Floating help icon + modal
+
+**Location:** Every major page
+
+**Features:**
+- Help icon in page header (question mark)
+- Click to open help modal
+- Modal contains:
+ - Page overview
+ - Key features explanation
+ - Quick tips
+ - Link to full documentation
+ - Video tutorial (if available)
+
+**Example (Keywords Page):**
+
+```
+┌────────────────────────────────────────────────┐
+│ Help: Keywords Page [×] │
+├────────────────────────────────────────────────┤
+│ Overview │
+│ ───────────────────────────────────────────── │
+│ The Keywords page is where you extract and │
+│ manage SEO keywords for your content strategy.│
+│ │
+│ Key Features │
+│ ───────────────────────────────────────────── │
+│ • Add Keywords: Manually or import from CSV │
+│ • Cluster: Group keywords semantically │
+│ • Volume & Difficulty: SEO metrics │
+│ • Status: Track mapping progress │
+│ │
+│ Quick Tips │
+│ ───────────────────────────────────────────── │
+│ 💡 Start with 20-50 keywords │
+│ 💡 Run clustering after adding keywords │
+│ 💡 Use filters to find unmapped keywords │
+│ │
+│ [Watch Tutorial Video] [View Full Docs] │
+└────────────────────────────────────────────────┘
+```
+
+**Content per Page:**
+
+| Page | Overview | Key Actions | Tips |
+|------|----------|-------------|------|
+| **Keywords** | Extract and manage keywords | Add, Import, Cluster | Start with 20-50, run clustering |
+| **Clusters** | View keyword groups | Edit, Generate Ideas | Review cluster names for clarity |
+| **Ideas** | Content ideas from clusters | Edit, Convert to Tasks | Check word count estimates |
+| **Tasks** | Content generation queue | Generate Content | Monitor credit usage |
+| **Content** | Review generated articles | Edit, Publish | Optimize before publishing |
+| **Images** | Manage article images | Generate Images | Check image relevance |
+| **Automation** | Automate workflows | Configure, Run | Start with small batches |
+
+---
+
+#### 2. Onboarding Tour
+
+**Component:** `frontend/src/components/onboarding/OnboardingTour.tsx` (NEW)
+
+**Purpose:** First-time user walkthrough
+
+**Trigger:** First login or first page visit
+
+**Steps:**
+
+**Step 1: Welcome**
+- "Welcome to IGNY8!"
+- "Let's take a quick tour to get you started"
+- [Start Tour] [Skip]
+
+**Step 2: Setup**
+- "First, connect your site and configure settings"
+- Points to Setup menu
+- [Next]
+
+**Step 3: Keywords**
+- "Add keywords to start planning content"
+- Points to Keywords page
+- [Next]
+
+**Step 4: Planner Workflow**
+- "Use the Planner to organize keywords and generate ideas"
+- Shows workflow diagram
+- [Next]
+
+**Step 5: Writer Workflow**
+- "The Writer generates content from your ideas"
+- Shows content generation process
+- [Next]
+
+**Step 6: Credits**
+- "Each AI operation uses credits. Monitor usage here."
+- Points to credits display
+- [Next]
+
+**Step 7: Done**
+- "You're all set! Start by adding keywords."
+- [Go to Keywords] [Finish Tour]
+
+**Implementation:**
+- Use library like `react-joyride` or custom tooltips
+- Store tour completion in localStorage
+- Option to restart tour from settings
+
+---
+
+#### 3. Tooltips on UI Elements
+
+**Coverage:**
+
+| Element | Tooltip Text |
+|---------|--------------|
+| Cluster button | "Group keywords by semantic similarity using AI" |
+| Generate Ideas button | "Create content ideas from selected clusters" |
+| Generate Content button | "Write articles from tasks using AI" |
+| Generate Images button | "Create images from prompts using AI" |
+| Word count field | "Target word count: 500, 1000, or 1500 words" |
+| Content structure dropdown | "Article format: guide, review, listicle, etc." |
+| Status badges | "Current processing status: pending, completed, failed" |
+| Credit balance | "Remaining credits for AI operations" |
+| Site selector | "Select site for this workflow" |
+| Sector selector | "Select industry sector for context" |
+
+**Implementation:**
+- Use Tooltip component (from Item 4)
+- Add to all icons, dropdowns, status indicators
+- Keep text brief (1-2 sentences)
+
+---
+
+#### 4. Inline Help Text
+
+**Placement:** Under form fields
+
+**Examples:**
+
+```tsx
+
+
+
+ Use lowercase, no special characters.
+ Separate multiple keywords with commas.
+
+
+
+
+
+
+ Choose article length. Affects credit usage (1 credit per 100 words).
+
+
+```
+
+---
+
+### B. Marketing Site Documentation
+
+**Purpose:** Public-facing help center
+
+**Location:** `/help` or `/docs` section of marketing site
+
+---
+
+#### 1. Help Center Structure
+
+**Homepage:** `/help`
+
+**Categories:**
+
+```
+Help Center
+├── Getting Started
+│ ├── Creating Your Account
+│ ├── Setting Up Your First Site
+│ ├── Understanding Credits
+│ └── Quick Start Guide
+├── Planner Module
+│ ├── Adding Keywords
+│ ├── Keyword Clustering
+│ ├── Generating Ideas
+│ └── Content Planning Strategy
+├── Writer Module
+│ ├── Creating Tasks
+│ ├── Generating Content
+│ ├── Generating Images
+│ ├── Editing Content
+│ └── Publishing to WordPress
+├── Automation
+│ ├── Setting Up Automation
+│ ├── Configuring Stages
+│ ├── Monitoring Progress
+│ └── Troubleshooting Automation
+├── Integrations
+│ ├── WordPress Setup
+│ ├── Google Search Console
+│ ├── API Integration
+│ └── OAuth Connections
+├── Billing & Plans
+│ ├── Understanding Plans
+│ ├── Managing Credits
+│ ├── Upgrading Your Plan
+│ └── Invoices and Payments
+├── Troubleshooting
+│ ├── Common Errors
+│ ├── API Issues
+│ ├── Publishing Problems
+│ └── Credit Deduction Issues
+└── FAQ
+ ├── General Questions
+ ├── Pricing Questions
+ ├── Technical Questions
+ └── Account Questions
+```
+
+**Each article contains:**
+- Title
+- Last updated date
+- Estimated reading time
+- Content with screenshots/gifs
+- Related articles
+- "Was this helpful?" feedback
+- Contact support link
+
+---
+
+#### 2. API Documentation
+
+**Location:** `/docs/api` or `/api-docs`
+
+**Format:** OpenAPI/Swagger or similar
+
+**Sections:**
+
+**Authentication**
+- Getting API keys
+- Authentication methods (Bearer token)
+- Rate limits
+- Error codes
+
+**Endpoints by Module:**
+
+**Planner API**
+- `GET /api/v1/planner/keywords/` - List keywords
+- `POST /api/v1/planner/keywords/` - Create keyword
+- `POST /api/v1/planner/keywords/auto_cluster/` - Trigger clustering
+- `GET /api/v1/planner/clusters/` - List clusters
+- `POST /api/v1/planner/ideas/generate/` - Generate ideas
+
+**Writer API**
+- `GET /api/v1/writer/tasks/` - List tasks
+- `POST /api/v1/writer/tasks/` - Create task
+- `POST /api/v1/writer/tasks/{id}/generate_content/` - Generate content
+- `GET /api/v1/writer/content/` - List content
+- `POST /api/v1/writer/content/{id}/generate_images/` - Generate images
+
+**Automation API**
+- `GET /api/v1/automation/runs/` - List runs
+- `POST /api/v1/automation/runs/start/` - Start automation
+- `POST /api/v1/automation/runs/{id}/pause/` - Pause automation
+- `POST /api/v1/automation/runs/{id}/resume/` - Resume automation
+
+**Billing API**
+- `GET /api/v1/billing/credits/` - Get credit balance
+- `GET /api/v1/billing/usage/` - Get usage logs
+- `GET /api/v1/billing/invoices/` - List invoices
+
+**System API**
+- `GET /api/v1/system/prompts/` - List prompts
+- `GET /api/v1/system/settings/` - Get settings
+- `POST /api/v1/system/settings/` - Update settings
+
+**For Each Endpoint Document:**
+- HTTP method and path
+- Description
+- Authentication required
+- Request parameters
+- Request body schema
+- Response schema
+- Example request
+- Example response
+- Possible error codes
+
+**Example Entry:**
+
+```markdown
+## Generate Content
+
+`POST /api/v1/writer/tasks/{id}/generate_content/`
+
+Generate AI content for a specific task.
+
+### Authentication
+Required. Bearer token.
+
+### Parameters
+- `id` (path, required): Task ID
+
+### Request Body
+```json
+{
+ "word_count": 1000,
+ "content_structure": "article"
+}
+```
+
+### Response
+```json
+{
+ "status": "success",
+ "task_id": "celery-task-uuid",
+ "message": "Content generation started"
+}
+```
+
+### Errors
+- `400 Bad Request`: Invalid parameters
+- `403 Forbidden`: Insufficient credits
+- `404 Not Found`: Task not found
+- `429 Too Many Requests`: Rate limit exceeded
+
+### Credit Cost
+1 credit per 100 words (10 credits for 1000-word article)
+```
+
+---
+
+#### 3. Integration Guides
+
+**Purpose:** Step-by-step setup instructions
+
+---
+
+**A. WordPress Integration Guide**
+
+**Location:** `/docs/integrations/wordpress`
+
+**Sections:**
+
+1. **Prerequisites**
+ - WordPress 5.0+ required
+ - Admin access
+ - REST API enabled
+
+2. **Installation Steps**
+ - Install WordPress plugin (if applicable) or use API
+ - Generate application password in WordPress
+ - Enter credentials in IGNY8
+
+3. **Configuration**
+ - Set default post type
+ - Set default category
+ - Configure SEO settings
+ - Set featured image rules
+
+4. **Publishing Workflow**
+ - How content syncs
+ - How images are uploaded
+ - How meta tags are set
+ - How to schedule posts
+
+5. **Troubleshooting**
+ - Connection errors
+ - Publishing failures
+ - Image upload issues
+ - Permission problems
+
+6. **Screenshots**
+ - Annotated screenshots for each step
+
+---
+
+**B. Google Search Console Integration**
+
+**Location:** `/docs/integrations/google-search-console`
+
+**Sections:**
+
+1. **Setup**
+ - OAuth authentication
+ - Site verification
+ - Permission requirements
+
+2. **Keyword Import**
+ - Importing search queries
+ - Volume and position data
+ - Filtering options
+
+3. **Syncing**
+ - Auto-sync frequency
+ - Manual sync
+ - Data refresh
+
+4. **Troubleshooting**
+ - OAuth errors
+ - Permission issues
+ - Data not syncing
+
+---
+
+**C. API Integration Guide**
+
+**Location:** `/docs/integrations/api`
+
+**Sections:**
+
+1. **Getting Started**
+ - Generating API keys
+ - Testing with cURL
+ - Rate limits
+
+2. **Authentication**
+ - Bearer token usage
+ - Security best practices
+
+3. **Common Workflows**
+ - Automated keyword import
+ - Bulk content generation
+ - Publishing pipelines
+
+4. **Webhooks** (if implemented)
+ - Setting up webhooks
+ - Event types
+ - Payload structure
+
+5. **Code Examples**
+ - Python example
+ - JavaScript example
+ - PHP example
+
+---
+
+#### 4. Workflow Guides
+
+**Purpose:** End-to-end workflow documentation
+
+---
+
+**A. Planner to Writer SEO Flow**
+
+**Location:** `/docs/workflows/seo-content-flow`
+
+**Content:**
+
+**Step 1: Keyword Research**
+- Add keywords manually or import from GSC
+- Aim for 50-100 keywords per topic area
+- Include variety of search volumes
+
+**Step 2: Keyword Clustering**
+- Run AI clustering on keywords
+- Review cluster names and descriptions
+- Merge or split clusters as needed
+
+**Step 3: Idea Generation**
+- Select clusters
+- Generate content ideas
+- Review cluster hub vs supporting ideas
+- Check word count estimates
+
+**Step 4: Task Creation**
+- Convert ideas to tasks
+- Set word count and structure
+- Organize by priority
+
+**Step 5: Content Generation**
+- Generate content for tasks
+- Monitor credit usage
+- Review generated content
+
+**Step 6: Image Generation**
+- Generate image prompts
+- Generate images from prompts
+- Review and approve images
+
+**Step 7: Publishing**
+- Edit content as needed
+- Publish to WordPress
+- Monitor performance
+
+**Screenshots/Videos for each step**
+
+---
+
+**B. Automation Workflow**
+
+**Location:** `/docs/workflows/automation`
+
+**Content:**
+
+**Overview**
+- What automation does
+- When to use it
+- Prerequisites
+
+**Configuration**
+- Stage batch sizes
+- Delays between stages
+- Credit budgets
+
+**Execution**
+- Starting a run
+- Monitoring progress
+- Pausing and resuming
+
+**Results**
+- Reviewing output
+- Handling failures
+- Re-running stages
+
+---
+
+#### 5. Credit System Documentation
+
+**Location:** `/docs/billing/credits`
+
+**Sections:**
+
+**How Credits Work**
+- What credits are
+- How they're used
+- How to purchase
+
+**Credit Costs**
+
+| Operation | Credits | Example |
+|-----------|---------|---------|
+| Keyword Clustering | 10 | Cluster 50 keywords = 10 credits |
+| Idea Generation | 15 per cluster | 3 clusters = 45 credits |
+| Content Generation | 1 per 100 words | 1000-word article = 10 credits |
+| Image Prompt Extraction | 3 | 1 article = 3 credits |
+| Image Generation | 6 per image | 5 images = 30 credits |
+
+**Credit Management**
+- Viewing balance
+- Monitoring usage
+- Auto top-up
+- Purchasing credits
+
+**Rollover Policy**
+- Monthly credits
+- Expiration rules
+- Unused credit handling
+
+---
+
+#### 6. Data Privacy & Security
+
+**Location:** `/docs/security`
+
+**Sections:**
+
+**Data Storage**
+- Where data is stored
+- Data encryption
+- Backup frequency
+
+**Access Control**
+- User roles and permissions
+- Account isolation
+- API security
+
+**Compliance**
+- GDPR compliance
+- Data deletion
+- Export your data
+
+**Best Practices**
+- Password requirements
+- Two-factor authentication (if available)
+- API key management
+
+---
+
+### C. FAQ System
+
+**Purpose:** Quick answers to common questions
+
+**Location:** `/help/faq` and in-app FAQ modal
+
+---
+
+#### FAQ Categories
+
+**1. General Questions**
+
+Q: What is IGNY8?
+A: IGNY8 is an AI-powered content creation platform...
+
+Q: How does the AI work?
+A: We use advanced NLP and semantic AI...
+
+Q: Is my content unique?
+A: Yes, all content is generated fresh for you...
+
+Q: Can I edit AI-generated content?
+A: Yes, you have full control to edit...
+
+---
+
+**2. Pricing Questions**
+
+Q: What happens when I run out of credits?
+A: You can purchase more credits or upgrade your plan...
+
+Q: Can I change plans mid-month?
+A: Yes, you can upgrade anytime. Prorated refunds for downgrades...
+
+Q: Do unused credits roll over?
+A: Monthly credits expire at the end of your billing cycle...
+
+Q: What's included in Enterprise?
+A: Custom credit allocations, priority support, dedicated account manager...
+
+Q: Is there a free trial?
+A: Yes, 14-day free trial on paid plans, no credit card required...
+
+Q: Can I cancel anytime?
+A: Yes, cancel anytime from your account settings...
+
+---
+
+**3. Content Generation Questions**
+
+Q: How long does content generation take?
+A: Typically 10-30 seconds per 1000-word article...
+
+Q: Can I control the writing style?
+A: Yes, choose tone, structure, and use author profiles...
+
+Q: What languages are supported?
+A: Currently English, with more languages planned...
+
+Q: Can I generate product descriptions?
+A: Yes, select "product_page" content structure...
+
+Q: How accurate is SEO optimization?
+A: Content includes primary keywords, proper structure, and meta tags...
+
+---
+
+**4. Integration Questions**
+
+Q: Which WordPress versions are supported?
+A: WordPress 5.0 and above...
+
+Q: Do I need a plugin?
+A: No, uses WordPress REST API. Plugin optional for advanced features...
+
+Q: Can I publish to multiple sites?
+A: Yes, create multiple site connections...
+
+Q: Does it work with WooCommerce?
+A: Yes, can generate product descriptions and category content...
+
+Q: Can I import from Google Docs?
+A: Not directly, but you can copy/paste or import CSV...
+
+---
+
+**5. Technical Questions**
+
+Q: Is there an API?
+A: Yes, full REST API available on Growth plan and above...
+
+Q: What are the rate limits?
+A: API: 100 requests/minute. Content generation: No limit but subject to credits...
+
+Q: Can I use webhooks?
+A: Yes, webhook support for automation events (Enterprise)...
+
+Q: How do I get API keys?
+A: Generate from Settings > Integrations > API Access...
+
+Q: Is there a mobile app?
+A: Not yet, but the web app is mobile-responsive...
+
+---
+
+**6. Account & Billing Questions**
+
+Q: How do I upgrade my plan?
+A: Go to Settings > Billing > Upgrade Plan...
+
+Q: What payment methods do you accept?
+A: Credit/debit cards via Stripe, PayPal, bank transfer (Enterprise)...
+
+Q: Can I get an invoice?
+A: Yes, invoices are automatically generated and emailed...
+
+Q: How do I add team members?
+A: Settings > Team > Invite User (available on Starter and above)...
+
+Q: Can I delete my account?
+A: Yes, Settings > Account > Delete Account. Data deleted after 14 days...
+
+---
+
+## Implementation Plan
+
+### Phase 1: In-App Help (Week 1-2)
+1. ✅ Create contextual help component
+2. ✅ Write help content for each page
+3. ✅ Add help icons to all pages
+4. ✅ Create onboarding tour component
+5. ✅ Implement tour steps
+
+### Phase 2: Help Center (Week 2)
+1. ✅ Set up help center structure
+2. ✅ Write Getting Started guides
+3. ✅ Write module-specific guides
+4. ✅ Create workflow documentation
+5. ✅ Add screenshots and videos
+
+### Phase 3: API Documentation (Week 2-3)
+1. ✅ Document all API endpoints
+2. ✅ Create code examples
+3. ✅ Set up API documentation tool (Swagger/Redoc)
+4. ✅ Test all endpoints
+5. ✅ Publish API docs
+
+### Phase 4: Integration Guides (Week 3)
+1. ✅ Write WordPress integration guide
+2. ✅ Write GSC integration guide
+3. ✅ Write API integration guide
+4. ✅ Create screenshots
+5. ✅ Test guides with fresh account
+
+### Phase 5: FAQ (Week 3)
+1. ✅ Compile common questions
+2. ✅ Write answers
+3. ✅ Categorize questions
+4. ✅ Create searchable FAQ interface
+5. ✅ Add FAQ to help center and in-app
+
+---
+
+## Success Metrics
+
+- ✅ Help content available for all major pages
+- ✅ Onboarding tour completed by 70%+ of new users
+- ✅ Help center covers 100% of core features
+- ✅ API documentation complete for all endpoints
+- ✅ Integration guides tested and validated
+- ✅ FAQ answers top 50 common questions
+- ✅ User support requests decrease by 40%
+- ✅ Documentation feedback positive (thumbs up > 80%)
+
+---
+
+## Related Files Reference
+
+### Frontend (NEW)
+- `frontend/src/components/help/HelpModal.tsx`
+- `frontend/src/components/onboarding/OnboardingTour.tsx`
+- `frontend/src/pages/Help/` - Help center pages
+- `frontend/src/pages/Docs/` - API documentation
+
+### Content (NEW)
+- `docs/help/` - Help center articles (Markdown)
+- `docs/api/` - API documentation (OpenAPI spec)
+- `docs/guides/` - Integration and workflow guides
+
+### Backend
+- API endpoint for serving documentation
+- Search functionality for help center
+
+---
+
+## Notes
+
+- Keep documentation up to date with product changes
+- Use analytics to track which docs are most viewed
+- Collect user feedback on helpfulness
+- Consider video tutorials for complex workflows
+- Plan for multilingual documentation (future)
+- Consider community forum or knowledge base (future)
+- Regular doc reviews (monthly or after major updates)
+- Use simple language, avoid jargon
+- Include lots of examples and screenshots
+- Test documentation with actual users before launch
- ,
- List item 1 +
- List item 2 +
| Column 1 | Column 2 |
|---|---|
| Data 1 | Data 2 |
+
+
+
+ Image caption (optional)
+
+
+
+
+
+
+
+
+
+```
+
+**Characteristics:**
+- 2-3 images total
+- Shorter sections (80-100 words each)
+- Minimal subsections
+- Concise lists and tables
+
+---
+
+### 1000-Word Template
+
+**Class:** `StandardTemplate(ContentTemplate)`
+
+**Structure:**
+```html
+Hook...
+Intro paragraph 1...
+Intro paragraph 2...
+ + +Section Heading 1
+Section content...
+ + +Section Heading 2
+Section content...
+ + +Conclusion...
+
+
+ ...
+
+
+ ...
+
+
+ ...
+
+
+ ...
+
+
+ ...
+
+
+
+```
+
+**Characteristics:**
+- 3-5 images
+- Standard sections (140-160 words each)
+- 2-3 subsections per section
+- Mix of content types (paragraphs, lists, tables)
+
+---
+
+### 1500-Word Template
+
+**Class:** `LongFormTemplate(ContentTemplate)`
+
+**Structure:**
+```html
+Hook...
+Intro paragraphs...
+ + +Section Heading 1
+Paragraphs...
+Subsection 1.1
+Content...
+ + +Section Heading 2
+Content...
+ + +Section Heading 3
+- ...
Section Heading 4
+Conclusion
+Summary and CTA...
+
+
+ ...
+
+
+ ...
+
+
+
+
+ ...
+
+
+
+```
+
+**Characteristics:**
+- 4-7 images
+- Longer sections (180-200 words each)
+- 3-4 subsections per section
+- Deeper content with more examples
+- Optional info boxes or callouts
+
+---
+
+## Cluster Hub Landing Page Template
+
+**Purpose:** Comprehensive resource page for topic clusters
+
+**Class:** `ClusterHubTemplate(ContentTemplate)`
+
+### Structure
+
+```html
+Hook (45 words)...
+Intro paragraph 1 (70 words)...
+Intro paragraph 2 (65 words)...
+ + +Section Heading 1
+Opening paragraph (80 words)...
+Subsection 1.1
+Content (50 words)...
+Subsection 1.2
+Content (50 words)...
+ + +Section Heading 2
+Content...
+ + +Section Heading 7
+Final content section...
+ + +Conclusion
+Summary paragraph...
+Call to action...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+```
+
+---
+
+### Cluster Hub Features
+
+| Feature | Implementation | Purpose |
+|---------|----------------|---------|
+| **Hero Image** | Full-width banner | Visual impact, brand identity |
+| **Concept Cards** | 3-6 key concepts | Quick overview, scannable |
+| **Subcluster Grid** | Links to child clusters | Hierarchy navigation |
+| **Latest Articles** | Auto-query by cluster_id | Fresh content |
+| **Popular Articles** | Sorted by view_count | Engagement driver |
+| **CTA Block** | Email signup or action | Lead generation |
+| **Footer Nav** | Related cluster links | Internal linking |
+
+---
+
+### Conditional Variants
+
+#### Category Archive (WordPress Taxonomy)
+
+**Differences from Cluster Hub:**
+- Shows WordPress category tree
+- Includes post count per category
+- Pagination for article list
+- Filter by date, popularity
+
+#### Tag Archive
+
+**Differences:**
+- Shows related tags as cloud
+- Simpler layout (no hero, no concepts)
+- Focus on article list
+- Sorted by relevance
+
+#### Attribute Archive (Product/Service)
+
+**Differences:**
+- Shows attribute filter options
+- Product/service grid instead of article list
+- Comparison table
+- Filter by attribute values
+
+---
+
+## Implementation Plan
+
+### Phase 1: Template System Foundation (Week 1)
+
+**Tasks:**
+1. ✅ Create `ContentTemplate` base class
+2. ✅ Implement image position calculator
+3. ✅ Implement image reuse logic
+4. ✅ Create image HTML formatter with figure tags
+5. ✅ Add WordPress meta integration (featured image)
+
+**File:** `backend/igny8_core/modules/publisher/templates.py` (NEW)
+
+---
+
+### Phase 2: Article Length Templates (Week 1-2)
+
+**Tasks:**
+1. ✅ Implement `ShortFormTemplate` (500 words)
+2. ✅ Implement `StandardTemplate` (1000 words)
+3. ✅ Implement `LongFormTemplate` (1500 words)
+4. ✅ Test image insertion for each template
+5. ✅ Validate HTML output
+
+**Testing:**
+- Generate 10 articles per template
+- Verify word counts
+- Check image placement
+- Validate HTML structure
+
+---
+
+### Phase 3: Cluster Hub Template (Week 2)
+
+**Tasks:**
+1. ✅ Implement `ClusterHubTemplate`
+2. ✅ Create hero section builder
+3. ✅ Create concept card generator
+4. ✅ Implement article list query
+5. ✅ Add related cluster links
+6. ✅ Test with real clusters
+
+**File:** Same as Phase 1
+
+---
+
+### Phase 4: Publishing Integration (Week 2-3)
+
+**Tasks:**
+1. ✅ Update WordPress publisher to use templates
+2. ✅ Pass content + images to template
+3. ✅ Generate final HTML
+4. ✅ Send to WordPress with featured image meta
+5. ✅ Test full publishing workflow
+
+**File:** `backend/igny8_core/modules/publisher/views.py`
+
+**Method:** `publish_to_wordpress()`
+
+**Changes:**
+
+```python
+def publish_to_wordpress(content_id):
+ content = Content.objects.get(id=content_id)
+ images = ContentImage.objects.filter(content=content).order_by('position')
+
+ # Select template based on word count
+ if content.word_count <= 600:
+ template = ShortFormTemplate()
+ elif content.word_count <= 1200:
+ template = StandardTemplate()
+ else:
+ template = LongFormTemplate()
+
+ # Prepare content with images
+ final_html = template.prepare_content(content, images)
+
+ # Get featured image
+ featured_image = images.filter(type='featured').first()
+
+ # Publish to WordPress
+ wp_client.create_post(
+ title=content.title,
+ content=final_html,
+ featured_image_url=featured_image.image_url if featured_image else None,
+ # ... other meta
+ )
+```
+
+---
+
+### Phase 5: Taxonomy Templates (Week 3)
+
+**Tasks:**
+1. ✅ Implement category archive variant
+2. ✅ Implement tag archive variant
+3. ✅ Implement attribute archive variant
+4. ✅ Add conditional rendering logic
+5. ✅ Test all taxonomy types
+
+---
+
+## HTML Quality Standards
+
+### Image Tags
+
+**Format:**
+```html
+{Cluster Name}
+{Cluster Description}
+What is {Cluster Name}?
+Comprehensive introduction to the topic...
+Why it matters and what you'll learn...
+Key Concepts
+
+
+
+
+
+ Concept 1
+Brief explanation...
+Explore Related Topics
+
+
+
+
+ Latest Articles
+
+
+
+
+
+
+
+ Most Popular
+
+
+
+ Stay Updated
+Get the latest insights on {Cluster Name}...
+ +
+
+
+```
+
+**WordPress Classes:**
+- `entry-content` - Standard WordPress content class
+- `wp-block-*` - Gutenberg block classes for proper styling
+
+---
+
+## Testing Requirements
+
+### Template Output Tests
+
+| Test Case | Expected Result |
+|-----------|-----------------|
+| 500-word article with 1 image | Image reused 3 times at strategic positions |
+| 1000-word article with 3 images | Each image used once, evenly distributed |
+| 1500-word article with 5 images | Images at intro, mid-points, and conclusion |
+| Article with 0 images | No image tags, content flows normally |
+| Cluster hub page | All sections rendered, related content populated |
+
+---
+
+### HTML Validation
+
+- ✅ All HTML valid (W3C validator)
+- ✅ All image tags have alt text
+- ✅ Heading hierarchy correct (H1 → H2 → H3)
+- ✅ No broken image links
+- ✅ Figure tags properly closed
+- ✅ WordPress classes applied correctly
+
+---
+
+### WordPress Integration Tests
+
+- ✅ Featured image set correctly
+- ✅ Images appear in correct positions
+- ✅ Content renders properly in WordPress editor
+- ✅ Mobile responsive (WordPress theme handles)
+- ✅ Image captions display correctly
+- ✅ Internal links work
+
+---
+
+## Success Metrics
+
+- ✅ 100% of articles have images placed correctly
+- ✅ Image reuse logic works for all scenarios
+- ✅ Article lengths match templates (±5% tolerance)
+- ✅ HTML validates 100%
+- ✅ Cluster hubs render all sections
+- ✅ WordPress publishing succeeds 100%
+- ✅ User feedback: content looks professional
+- ✅ No manual image placement needed
+
+---
+
+## Related Files Reference
+
+### Backend (NEW)
+- `backend/igny8_core/modules/publisher/templates.py` - Template system
+- `backend/igny8_core/modules/publisher/image_manager.py` - Image reuse logic
+
+### Backend (Update)
+- `backend/igny8_core/modules/publisher/views.py` - Publishing integration
+- `backend/igny8_core/ai/functions/generate_content.py` - Content structure
+
+### Models
+- `backend/igny8_core/business/content/models.py` - Content, ContentImage models
+
+---
+
+## Notes
+
+- Templates should be flexible enough for custom themes
+- Image captions optional (can extract from prompt or leave empty)
+- Cluster hub template can be used for category/tag pages
+- Consider adding shortcode support for advanced layouts
+- Future: Allow custom template selection per content piece
+- Future: Visual template editor for admins
diff --git a/docs/PRE-LAUNCH/ITEM-6-MARKETING-SITE.md b/docs/PRE-LAUNCH/ITEM-6-MARKETING-SITE.md
new file mode 100644
index 00000000..19c17412
--- /dev/null
+++ b/docs/PRE-LAUNCH/ITEM-6-MARKETING-SITE.md
@@ -0,0 +1,707 @@
+# Item 6: Frontend Marketing Site Updates
+
+**Priority:** High
+**Target:** Production Launch
+**Last Updated:** December 11, 2025
+
+---
+
+## Overview
+
+Update and polish the marketing website including homepage, features pages, product pages, use-case pages, pricing page, about, and contact pages. Ensure consistent branding, clear value propositions, and conversion-optimized layouts.
+
+---
+
+## Current Implementation
+
+### Marketing Site Structure
+
+**Location:** `frontend/src/pages/` (marketing section)
+
+**Current Pages:**
+- Homepage
+- Features (general)
+- Pricing
+- About
+- Contact
+- (Possibly others)
+
+**Issues:**
+- Content may be outdated or generic
+- Feature descriptions don't match current capabilities
+- Pricing page needs plan updates (from Item 2)
+- No dedicated product pages for each module
+- No use-case specific pages
+- Missing social proof and testimonials
+- CTAs not optimized
+
+---
+
+## Required Pages and Updates
+
+### A. Homepage
+
+**Location:** `frontend/src/pages/marketing/Home.tsx` or similar
+
+#### Current Issues
+- Value proposition unclear or generic
+- Feature highlights incomplete
+- Workflow demonstration missing
+- CTAs not prominent
+
+#### Required Sections
+
+**1. Hero Section**
+
+**Content:**
+- **Headline:** "AI-Powered Content Creation for SEO-Driven Websites"
+- **Subheadline:** "Transform your content strategy with semantic AI. Plan, write, and publish high-quality content that ranks."
+- **Primary CTA:** "Start Free Trial" (14-day trial, no credit card)
+- **Secondary CTA:** "See How It Works" (scroll to demo video)
+- **Hero Visual:** Animated workflow diagram or product screenshot
+
+**Design:**
+- Full-width, above fold
+- Gradient background or image
+- Logo grid: "Trusted by [companies/users]"
+
+---
+
+**2. Problem Statement**
+
+**Content:**
+- "Content creation is time-consuming and expensive"
+- "SEO is complex and constantly changing"
+- "Scaling content while maintaining quality is hard"
+- Visual: Problem illustration
+
+---
+
+**3. Solution Overview**
+
+**Content:**
+- "IGNY8 uses semantic AI to automate your entire content workflow"
+- 3 key benefits:
+ 1. **Plan:** AI clusters keywords into strategic topics
+ 2. **Write:** Generate SEO-optimized content in minutes
+ 3. **Publish:** Direct WordPress integration
+- Visual: 3-column benefit cards
+
+---
+
+**4. Feature Highlights**
+
+**Content:**
+- AI Planner: Keyword extraction → Clustering → Idea generation
+- AI Writer: Content generation → Image creation → SEO optimization
+- Automation: End-to-end workflow automation
+- Analytics: Track performance and ROI
+
+**Design:**
+- 4 feature cards with icons
+- Each card links to detailed feature page
+
+---
+
+**5. How It Works**
+
+**Content:**
+- Step-by-step workflow:
+ 1. Add keywords or import from GSC
+ 2. AI clusters keywords semantically
+ 3. Generate content ideas for each cluster
+ 4. AI writes SEO-optimized articles
+ 5. Generate images with AI
+ 6. Publish to WordPress automatically
+
+**Visual:**
+- Animated step diagram
+- Or short video demo (30-60 seconds)
+
+---
+
+**6. Social Proof**
+
+**Content:**
+- User testimonials (3-4 quotes)
+- Usage statistics:
+ - "10,000+ articles generated"
+ - "500+ active users"
+ - "95% time saved on content creation"
+- Company logos (if applicable)
+
+**Design:**
+- Testimonial cards with photos
+- Stats counter animation
+
+---
+
+**7. Pricing Preview**
+
+**Content:**
+- "Plans for every team size"
+- Show 3 plan tiers with key features
+- CTA: "View Full Pricing" → /pricing
+
+---
+
+**8. Final CTA**
+
+**Content:**
+- "Ready to transform your content strategy?"
+- Primary CTA: "Start Free Trial"
+- Secondary CTA: "Schedule Demo"
+
+---
+
+### B. Features Page
+
+**Location:** `frontend/src/pages/marketing/Features.tsx`
+
+#### Required Sections
+
+**1. Features Overview**
+
+**Content:**
+- List all major features with descriptions
+- Organized by category:
+ - **Planning & Strategy**
+ - Keyword Extraction
+ - Semantic Clustering
+ - Content Idea Generation
+ - SAG Mapping (if implemented)
+ - **Content Creation**
+ - AI Writing (multiple lengths)
+ - Content Structure Templates
+ - SEO Optimization
+ - Tone & Style Control
+ - **Visual Content**
+ - Image Prompt Generation
+ - AI Image Creation
+ - Image Optimization
+ - **Publishing & Distribution**
+ - WordPress Integration
+ - Automated Publishing
+ - Content Scheduling
+ - **Automation**
+ - End-to-end Workflow Automation
+ - Batch Processing
+ - Custom Workflows
+ - **Analytics & Insights**
+ - Content Performance Tracking
+ - SEO Metrics
+ - Credit Usage Reports
+
+**Design:**
+- Accordion or tab-based navigation
+- Feature cards with icons
+- "Learn More" links to detail pages
+
+---
+
+**2. Feature Comparison Table**
+
+**Content:**
+- Compare features across plans
+- Show which features are in which tier
+
+**Table:**
+
+| Feature | Free | Starter | Growth | Pro | Enterprise |
+|---------|------|---------|--------|-----|------------|
+| Keywords | 100 | 1,000 | 5,000 | 25,000 | Unlimited |
+| AI Clustering | ✓ | ✓ | ✓ | ✓ | ✓ |
+| Content Generation | ✓ | ✓ | ✓ | ✓ | ✓ |
+| Image Generation | ✓ | ✓ | ✓ | ✓ | ✓ |
+| WordPress Integration | ✓ | ✓ | ✓ | ✓ | ✓ |
+| Automation | ✗ | ✗ | ✓ | ✓ | ✓ |
+| API Access | ✗ | ✗ | ✓ | ✓ | ✓ |
+| Priority Support | ✗ | ✗ | ✗ | ✓ | ✓ |
+
+---
+
+### C. Product Pages (One per Module)
+
+**Create dedicated pages:**
+
+#### 1. AI Planner Page
+
+**URL:** `/product/planner`
+
+**Sections:**
+- Hero: "Plan Your Content Strategy with AI"
+- Problem: Manual keyword research is slow
+- Solution: Automated clustering and idea generation
+- Features:
+ - Keyword extraction from GSC
+ - Semantic clustering
+ - Content idea generation with outlines
+ - Visual cluster mapping
+- Use cases:
+ - Blog content planning
+ - Topic cluster strategy
+ - Content calendar creation
+- Demo video or screenshots
+- CTA: "Try Planner Free"
+
+---
+
+#### 2. AI Writer Page
+
+**URL:** `/product/writer`
+
+**Sections:**
+- Hero: "AI-Powered Content Creation"
+- Problem: Writing is time-consuming and expensive
+- Solution: Generate SEO-optimized content in minutes
+- Features:
+ - Multiple article lengths (500, 1000, 1500 words)
+ - Content structure templates
+ - SEO keyword integration
+ - Tone and style control
+- Use cases:
+ - Blog posts
+ - Product descriptions
+ - Landing pages
+ - Guides and tutorials
+- Demo video or screenshots
+- CTA: "Start Writing with AI"
+
+---
+
+#### 3. Automation Page
+
+**URL:** `/product/automation`
+
+**Sections:**
+- Hero: "Automate Your Entire Content Workflow"
+- Problem: Managing content at scale is complex
+- Solution: End-to-end automation from keywords to publication
+- Features:
+ - 7-stage automated workflow
+ - Batch processing
+ - Scheduled runs
+ - Progress monitoring
+- Use cases:
+ - Agency content production
+ - E-commerce catalog automation
+ - Multi-site management
+- Demo video or screenshots
+- CTA: "Automate Your Workflow"
+
+---
+
+### D. Use-Case Pages
+
+**Create industry/persona-specific pages:**
+
+#### 1. For Agencies
+
+**URL:** `/use-cases/agencies`
+
+**Content:**
+- Hero: "Scale Content Production for Your Clients"
+- Challenges: Managing multiple clients, tight deadlines, budget constraints
+- Solution: Automate content at scale without sacrificing quality
+- Features relevant to agencies:
+ - Multi-site management
+ - Team collaboration
+ - White-label potential (if applicable)
+ - Bulk operations
+- Case study or testimonial
+- Pricing: Focus on Growth and Pro plans
+- CTA: "Book Agency Demo"
+
+---
+
+#### 2. For E-commerce
+
+**URL:** `/use-cases/ecommerce`
+
+**Content:**
+- Hero: "Generate Product Content at Scale"
+- Challenges: Large product catalogs, SEO for products, content updates
+- Solution: Automate product descriptions, category pages, blog content
+- Features relevant to e-commerce:
+ - Product description generation
+ - Category landing pages
+ - SEO-optimized content
+ - Image generation for products
+- Case study or testimonial
+- CTA: "Start Free Trial"
+
+---
+
+#### 3. For Content Teams
+
+**URL:** `/use-cases/content-teams`
+
+**Content:**
+- Hero: "Supercharge Your Content Team"
+- Challenges: Content velocity, consistency, SEO optimization
+- Solution: AI assists writers, not replaces them
+- Features relevant to content teams:
+ - Content planning and ideation
+ - Draft generation
+ - SEO optimization
+ - Workflow automation
+- Case study or testimonial
+- CTA: "Try Team Plan"
+
+---
+
+### E. Pricing Page
+
+**Location:** `frontend/src/pages/marketing/Pricing.tsx`
+
+#### Required Updates (From Item 2)
+
+**1. Plan Tiers**
+
+Display all 5 tiers:
+- Free (hidden from public, internal only)
+- Starter ($29/mo or $299/year)
+- Growth ($99/mo or $1,019/year)
+- Pro ($299/mo or $3,077/year)
+- Enterprise (Custom pricing)
+
+**2. Monthly/Annual Toggle**
+
+- Default: Monthly
+- Show savings badge for annual ("Save 15%")
+- Update prices dynamically on toggle
+
+**3. Plan Cards**
+
+**Each card shows:**
+- Plan name
+- Price (monthly or annual)
+- "Most Popular" badge (Growth plan)
+- Key features (5-7 bullets):
+ - Monthly credits
+ - Max keywords, clusters, content, images
+ - Key features (automation, API, support)
+- CTA button:
+ - Free: "Start Free"
+ - Paid: "Start Trial" (14 days)
+ - Enterprise: "Contact Sales"
+
+**4. Detailed Comparison Table**
+
+Show full feature comparison (expandable):
+- All features listed
+- Checkmarks or values per plan
+- Tooltips explaining features
+
+**5. Credit System Explanation**
+
+**Section:**
+- "How Credits Work"
+- What credits are used for
+- How they're consumed (per operation)
+- How to buy more
+- Credit rollover rules (if applicable)
+
+**Example:**
+
+| Operation | Credits |
+|-----------|---------|
+| Keyword Clustering | 10 credits |
+| Idea Generation | 15 credits |
+| Content Generation (1000 words) | 10 credits |
+| Image Generation | 5 credits per image |
+
+**6. FAQ Section**
+
+**Questions to answer:**
+- What happens when I run out of credits?
+- Can I change plans mid-month?
+- Do unused credits roll over?
+- What's included in Enterprise?
+- Is there a free trial?
+- Can I cancel anytime?
+- What payment methods do you accept?
+- Do you offer refunds?
+
+**7. CTA Section**
+
+- "Still have questions?"
+- CTA: "Contact Sales" or "Schedule Demo"
+- Phone number, email, or chat option
+
+---
+
+### F. About Page
+
+**Location:** `frontend/src/pages/marketing/About.tsx`
+
+#### Required Sections
+
+**1. Mission Statement**
+
+- "Our mission is to democratize AI-powered content creation..."
+- Why IGNY8 exists
+- Vision for the future
+
+**2. Team** (if applicable)
+
+- Founder(s) photo and bio
+- Key team members
+- Company history/journey
+
+**3. Technology & Approach**
+
+- "Built on semantic AI and NLP"
+- Explanation of SAG architecture (simplified)
+- Why our approach is different/better
+
+**4. Values**
+
+- Quality over quantity
+- User-centric design
+- Transparency
+- Innovation
+
+**5. Contact**
+
+- How to reach us
+- Office location (if applicable)
+- Link to Contact page
+
+---
+
+### G. Contact Page
+
+**Location:** `frontend/src/pages/marketing/Contact.tsx`
+
+#### Required Elements
+
+**1. Contact Form**
+
+**Fields:**
+- Name (required)
+- Email (required)
+- Company (optional)
+- Message (required)
+- Subject dropdown:
+ - General Inquiry
+ - Sales
+ - Support
+ - Partnership
+ - Press
+
+**2. Alternative Contact Methods**
+
+- Email: support@igny8.com (or similar)
+- Phone: (if available)
+- Live chat: (if enabled)
+- Social media links
+
+**3. Support Resources**
+
+- Link to Help Center / Documentation
+- Link to FAQ
+- Link to Community (if applicable)
+
+**4. Office Location** (if applicable)
+
+- Address
+- Map embed
+
+---
+
+## Design & Branding Guidelines
+
+### Visual Design
+
+**Color Scheme:**
+- Primary: Brand blue/purple
+- Secondary: Accent colors
+- Neutral: Grays for text and backgrounds
+
+**Typography:**
+- Headings: Bold, clear hierarchy
+- Body: Readable, 16px+ base size
+- Code/monospace: For technical content
+
+**Imagery:**
+- Product screenshots
+- Workflow diagrams
+- Illustrations for concepts
+- Real user photos for testimonials
+
+**Icons:**
+- Consistent icon set throughout
+- Use for feature highlights, benefits
+
+---
+
+### Tone & Voice
+
+**Brand Voice:**
+- Professional but approachable
+- Technical but not jargon-heavy
+- Confident but not boastful
+- Helpful and supportive
+
+**Messaging Principles:**
+- Focus on benefits, not just features
+- Use clear, concise language
+- Avoid marketing fluff
+- Be specific with numbers and results
+- Address pain points directly
+
+---
+
+### Call-to-Actions
+
+**Primary CTAs:**
+- "Start Free Trial" (most common)
+- "Get Started Free"
+- "Try IGNY8 Free"
+
+**Secondary CTAs:**
+- "Schedule Demo"
+- "Contact Sales"
+- "Learn More"
+- "View Pricing"
+
+**CTA Design:**
+- Primary: Large, prominent button (brand color)
+- Secondary: Outline button or link
+- Clear contrast with background
+- Include arrow or icon for clarity
+
+---
+
+## SEO Optimization
+
+### Meta Tags
+
+**Each page needs:**
+- Title tag (50-60 chars)
+- Meta description (150-160 chars)
+- OG tags (for social sharing)
+- Schema markup (Organization, Product, FAQ)
+
+**Example (Homepage):**
+```html
+