From b2b5769ad90264dff7a73a8712d78e777317e0cc Mon Sep 17 00:00:00 2001
From: ajaysi <ajay.calsoft@gmail.com>
Date: Wed, 24 Sep 2025 18:09:58 +0530
Subject: [PATCH] feat: Add comprehensive documentation structure

- Created ALwrity introduction page with vision summary
- Added detailed installation guide with step-by-step instructions
- Created comprehensive configuration guide for API keys and settings
- Added first steps guide with complete user onboarding flow
- Updated navigation structure to include all new pages
- Preserved existing documentation while organizing it logically
- Optimized for SEO with proper structure and metadata
---
 docs-site/docs/about.md                       | 199 ++++++++
 .../docs/getting-started/configuration.md     | 472 ++++++++++++++++++
 docs-site/docs/getting-started/first-steps.md | 330 ++++++++++++
 .../docs/getting-started/installation.md      | 348 +++++++++++++
 docs-site/mkdocs.yml                          |   4 +
 5 files changed, 1353 insertions(+)
 create mode 100644 docs-site/docs/about.md
 create mode 100644 docs-site/docs/getting-started/configuration.md
 create mode 100644 docs-site/docs/getting-started/first-steps.md
 create mode 100644 docs-site/docs/getting-started/installation.md

diff --git a/docs-site/docs/about.md b/docs-site/docs/about.md
new file mode 100644
index 00000000..bdf64ede
--- /dev/null
+++ b/docs-site/docs/about.md
@@ -0,0 +1,199 @@
+# About ALwrity
+
+<div class="grid cards" markdown>
+
+-   :material-rocket-launch:{ .lg .middle } **AI-Powered Platform**
+
+    ---
+
+    Transform your content strategy with advanced AI technology
+
+    [:octicons-arrow-right-24: Learn More](#ai-powered-platform)
+
+-   :material-account-group:{ .lg .middle } **For Solopreneurs**
+
+    ---
+
+    Designed specifically for independent entrepreneurs
+
+    [:octicons-arrow-right-24: Learn More](#built-for-solopreneurs)
+
+-   :material-chart-line:{ .lg .middle } **Measurable Results**
+
+    ---
+
+    Track performance and optimize your content strategy
+
+    [:octicons-arrow-right-24: Learn More](#measurable-results)
+
+-   :material-cog:{ .lg .middle } **Automated Strategy**
+
+    ---
+
+    From research to publishing - all automated
+
+    [:octicons-arrow-right-24: Learn More](#automated-strategy)
+
+</div>
+
+## What is ALwrity?
+
+**ALwrity** is an AI-powered digital marketing platform that revolutionizes content creation and SEO optimization for solopreneurs and independent entrepreneurs. Our platform combines advanced artificial intelligence with comprehensive marketing tools to help businesses create high-quality, SEO-optimized content at scale.
+
+### The Problem We Solve
+
+Solopreneurs face unique and significant challenges in developing and executing effective content strategies:
+
+- **⏰ Time Constraints**: Limited time for content creation and strategy development
+- **🎯 Lack of Expertise**: Not trained as content strategists, SEO experts, or data analysts
+- **💰 Resource Limitations**: Cannot afford full marketing teams or expensive tools
+- **📊 Poor ROI Tracking**: Only 21% of marketers successfully track content ROI
+- **🔄 Manual Processes**: Overwhelmed by repetitive content creation tasks
+
+### Our Solution
+
+ALwrity transforms solopreneurs from manual implementers to strategic directors by automating the entire content strategy process.
+
+## AI-Powered Platform
+
+### Intelligent Data Ingestion & Analysis
+
+Our platform leverages three core data sources to deliver personalized insights:
+
+#### 1. User Onboarding Data
+- **Business Type & Goals**: Understanding your specific objectives
+- **Target Audience**: Demographics and psychographics analysis
+- **Brand Voice**: Consistent tone and messaging preferences
+- **Content Challenges**: Current pain points and requirements
+
+#### 2. Dynamic Web Research
+- **Competitor Analysis**: Real-time competitor content strategies
+- **Keyword Research**: Advanced keyword analysis across platforms
+- **Market Trends**: Emerging industry opportunities
+- **Search Intent**: Understanding what users truly seek
+
+#### 3. Performance Analytics
+- **Benchmarking Data**: Anonymized performance metrics
+- **Success Patterns**: Machine learning from successful strategies
+- **Predictive Analytics**: Forecasting content performance
+- **Continuous Optimization**: Self-improving recommendations
+
+### AI-Driven Content Strategy Generation
+
+#### Automated Goal Setting & KPI Definition
+- **SMART Goals**: Specific, measurable, achievable, relevant, time-bound objectives
+- **KPI Tracking**: Website views, clicks, conversion rates, search visibility
+- **Success Metrics**: Individual content performance measurement
+- **ROI Analysis**: Clear return on investment tracking
+
+#### AI-Powered Audience Persona Development
+- **Detailed Buyer Personas**: Composite characters representing your target audience
+- **Customer Journey Mapping**: Awareness, consideration, and conversion stages
+- **Pain Point Analysis**: Understanding audience challenges and needs
+- **Behavioral Insights**: Data-driven persona refinement
+
+#### Brand Voice & Story Alignment
+- **Consistent Brand Identity**: Unified messaging across all content
+- **Emotional Connection**: Crafting stories that resonate with your audience
+- **Style Guide Generation**: Maintaining brand consistency
+- **Voice Optimization**: AI-powered tone and style recommendations
+
+## Built for Solopreneurs
+
+### Democratizing Advanced Marketing
+
+ALwrity makes enterprise-level marketing capabilities accessible to individual entrepreneurs:
+
+- **🎯 No Technical Expertise Required**: User-friendly interface for non-technical users
+- **💰 Affordable Solution**: Cost-effective alternative to hiring marketing teams
+- **⚡ Rapid Implementation**: Get started in minutes, not months
+- **📈 Scalable Growth**: Grows with your business needs
+
+### Virtual Marketing Department
+
+Our platform serves as your comprehensive marketing team:
+
+- **Content Strategist**: AI-powered strategy development
+- **SEO Expert**: Advanced optimization and analysis
+- **Data Analyst**: Performance tracking and insights
+- **Content Writer**: High-quality content generation
+- **Social Media Manager**: Multi-platform content distribution
+
+## Measurable Results
+
+### Performance Tracking
+
+- **Real-time Analytics**: Live performance monitoring
+- **Conversion Tracking**: Goal completion analysis
+- **ROI Measurement**: Clear return on investment metrics
+- **Competitive Benchmarking**: Industry performance comparison
+
+### Continuous Optimization
+
+- **Machine Learning**: Self-improving recommendations
+- **A/B Testing**: Data-driven content optimization
+- **Performance Forecasting**: Predictive success analysis
+- **Strategy Refinement**: Continuous improvement based on results
+
+## Automated Strategy
+
+### End-to-End Automation
+
+From initial research to final publishing:
+
+1. **🔍 Research Phase**: Automated market and competitor analysis
+2. **📋 Planning Phase**: AI-generated content strategies and calendars
+3. **✍️ Creation Phase**: High-quality content generation
+4. **🎯 Optimization Phase**: SEO and performance optimization
+5. **📤 Publishing Phase**: Multi-platform content distribution
+6. **📊 Analysis Phase**: Performance tracking and insights
+
+### Key Features
+
+- **Content Strategy Generation**: Professional strategies with minimal input
+- **SEO Optimization**: Built-in SEO analysis and recommendations
+- **Multi-Platform Publishing**: Blog, LinkedIn, Facebook, and more
+- **Performance Analytics**: Comprehensive tracking and reporting
+- **Competitor Intelligence**: Real-time market analysis
+- **Trend Detection**: Emerging opportunity identification
+
+## The ALwrity Advantage
+
+### Why Choose ALwrity?
+
+- **🤖 AI-First Approach**: Built from the ground up with AI at its core
+- **📊 Data-Driven Insights**: Decisions based on real performance data
+- **🎯 Personalized Strategies**: Tailored to your specific business needs
+- **⚡ Rapid Results**: See improvements in days, not months
+- **💰 Cost-Effective**: Fraction of the cost of traditional marketing teams
+- **🔄 Continuous Learning**: Platform improves with every use
+
+### Success Metrics
+
+- **65% of B2B marketers** lack documented content strategies - ALwrity provides this
+- **71% of consumers** expect personalized interactions - We deliver this
+- **76% become frustrated** without personalization - We prevent this
+- **Only 21% track ROI** - We make this easy and automatic
+
+## Getting Started
+
+Ready to transform your content strategy? Here's how to begin:
+
+1. **[Quick Start Guide](getting-started/quick-start.md)** - Get up and running in 5 minutes
+2. **[Installation Guide](getting-started/installation.md)** - Technical setup instructions
+3. **[Configuration Guide](getting-started/configuration.md)** - API keys and settings
+4. **[First Steps](getting-started/first-steps.md)** - Create your first content strategy
+
+## Vision & Mission
+
+### Our Vision
+
+To democratize advanced marketing capabilities and make professional content strategy accessible to every solopreneur and independent entrepreneur.
+
+### Our Mission
+
+Empower solopreneurs to focus on their core business while ALwrity handles the complex strategic planning, content creation, and performance optimization that drives measurable business growth.
+
+---
+
+*Ready to revolutionize your content strategy? [Start your journey with ALwrity today](getting-started/quick-start.md).*
diff --git a/docs-site/docs/getting-started/configuration.md b/docs-site/docs/getting-started/configuration.md
new file mode 100644
index 00000000..cd64aa08
--- /dev/null
+++ b/docs-site/docs/getting-started/configuration.md
@@ -0,0 +1,472 @@
+# Configuration Guide
+
+This guide will help you configure ALwrity with your API keys, settings, and preferences to get the most out of your AI-powered content creation platform.
+
+## Overview
+
+ALwrity requires configuration of several components to function optimally:
+
+- **AI Service API Keys**: Core AI capabilities
+- **Research & SEO Services**: Enhanced content research
+- **Authentication**: User management and security
+- **Database**: Data storage and management
+- **Frontend Settings**: User interface configuration
+
+## Backend Configuration
+
+### Environment Variables
+
+The backend configuration is managed through environment variables in the `.env` file located in the `backend/` directory.
+
+#### Core AI Services (Required)
+
+```env
+# Google Gemini API - Primary AI service
+GEMINI_API_KEY=your_gemini_api_key_here
+
+# OpenAI API - Alternative AI service
+OPENAI_API_KEY=your_openai_api_key_here
+
+# Anthropic API - Claude AI service
+ANTHROPIC_API_KEY=your_anthropic_api_key_here
+```
+
+#### Database Configuration
+
+```env
+# Database URL - SQLite for development, PostgreSQL for production
+DATABASE_URL=sqlite:///./alwrity.db
+
+# For PostgreSQL production setup:
+# DATABASE_URL=postgresql://username:password@localhost:5432/alwrity
+```
+
+#### Security Settings
+
+```env
+# Secret key for JWT tokens and encryption
+SECRET_KEY=your_very_secure_secret_key_here
+
+# Generate a secure key:
+# python -c "import secrets; print(secrets.token_urlsafe(32))"
+```
+
+### Research & SEO Services (Optional but Recommended)
+
+#### Web Search & Research
+
+```env
+# Tavily API - Advanced web search and research
+TAVILY_API_KEY=your_tavily_api_key_here
+
+# Serper API - Google search results
+SERPER_API_KEY=your_serper_api_key_here
+
+# Metaphor API - Content discovery
+METAPHOR_API_KEY=your_metaphor_api_key_here
+
+# Firecrawl API - Web scraping and content extraction
+FIRECRAWL_API_KEY=your_firecrawl_api_key_here
+```
+
+#### SEO & Analytics
+
+```env
+# Google Search Console integration
+GSC_CLIENT_ID=your_gsc_client_id_here
+GSC_CLIENT_SECRET=your_gsc_client_secret_here
+
+# Google Analytics (if needed)
+GA_TRACKING_ID=your_ga_tracking_id_here
+```
+
+#### Content Generation
+
+```env
+# Stability AI - Image generation
+STABILITY_API_KEY=your_stability_api_key_here
+
+# Additional AI services
+MISTRAL_API_KEY=your_mistral_api_key_here
+```
+
+### Authentication & Integration
+
+```env
+# Clerk Authentication
+CLERK_SECRET_KEY=your_clerk_secret_key_here
+
+# CopilotKit Integration
+COPILOT_API_KEY=your_copilot_api_key_here
+
+# Webhook URLs (for production)
+WEBHOOK_URL=your_webhook_url_here
+```
+
+## Frontend Configuration
+
+### Environment Variables
+
+The frontend configuration is managed through environment variables in the `.env` file located in the `frontend/` directory.
+
+#### Core Settings
+
+```env
+# Backend API URL
+REACT_APP_API_URL=http://localhost:8000
+
+# For production:
+# REACT_APP_API_URL=https://your-domain.com
+
+# Environment
+NODE_ENV=development
+```
+
+#### Authentication
+
+```env
+# Clerk Authentication
+REACT_APP_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key_here
+
+# Google OAuth (if using)
+REACT_APP_GOOGLE_CLIENT_ID=your_google_client_id_here
+```
+
+#### AI Integration
+
+```env
+# CopilotKit
+REACT_APP_COPILOT_API_KEY=your_copilot_api_key_here
+
+# Additional AI services
+REACT_APP_OPENAI_API_KEY=your_openai_api_key_here
+```
+
+#### SEO & Analytics
+
+```env
+# Google Search Console
+REACT_APP_GSC_CLIENT_ID=your_gsc_client_id_here
+
+# Google Analytics
+REACT_APP_GA_TRACKING_ID=your_ga_tracking_id_here
+```
+
+## API Keys Setup
+
+### 1. Google Gemini API
+
+**Purpose**: Primary AI service for content generation and analysis
+
+**Setup Steps**:
+1. Visit [Google AI Studio](https://makersuite.google.com/app/apikey)
+2. Sign in with your Google account
+3. Click "Create API Key"
+4. Copy the generated key
+5. Add to `GEMINI_API_KEY` in backend `.env`
+
+**Usage Limits**:
+- Free tier: 15 requests per minute
+- Paid tier: Higher limits available
+
+### 2. OpenAI API
+
+**Purpose**: Alternative AI service for content generation
+
+**Setup Steps**:
+1. Visit [OpenAI Platform](https://platform.openai.com/api-keys)
+2. Sign in to your account
+3. Click "Create new secret key"
+4. Copy the generated key
+5. Add to `OPENAI_API_KEY` in backend `.env`
+
+**Usage Limits**:
+- Pay-per-use model
+- Rate limits based on your plan
+
+### 3. Anthropic API
+
+**Purpose**: Claude AI for advanced reasoning and analysis
+
+**Setup Steps**:
+1. Visit [Anthropic Console](https://console.anthropic.com/)
+2. Sign in to your account
+3. Navigate to API Keys
+4. Create a new API key
+5. Add to `ANTHROPIC_API_KEY` in backend `.env`
+
+### 4. Tavily API
+
+**Purpose**: Advanced web search and research capabilities
+
+**Setup Steps**:
+1. Visit [Tavily](https://tavily.com/)
+2. Sign up for an account
+3. Navigate to API section
+4. Generate API key
+5. Add to `TAVILY_API_KEY` in backend `.env`
+
+**Benefits**:
+- Real-time web search
+- Content summarization
+- Source verification
+
+### 5. Serper API
+
+**Purpose**: Google search results and SEO data
+
+**Setup Steps**:
+1. Visit [Serper](https://serper.dev/)
+2. Sign up for an account
+3. Get your API key
+4. Add to `SERPER_API_KEY` in backend `.env`
+
+**Benefits**:
+- Google search results
+- SEO data and insights
+- Keyword research
+
+### 6. Google Search Console
+
+**Purpose**: SEO analysis and performance tracking
+
+**Setup Steps**:
+1. Visit [Google Search Console](https://search.google.com/search-console/)
+2. Add your website property
+3. Go to Settings → Users and permissions
+4. Create OAuth credentials
+5. Add client ID and secret to `.env`
+
+**Benefits**:
+- Real search performance data
+- Keyword insights
+- Technical SEO analysis
+
+### 7. Clerk Authentication
+
+**Purpose**: User authentication and management
+
+**Setup Steps**:
+1. Visit [Clerk Dashboard](https://dashboard.clerk.com/)
+2. Create a new application
+3. Get your publishable and secret keys
+4. Add to frontend and backend `.env` files
+
+**Benefits**:
+- Secure user authentication
+- Social login options
+- User management
+
+### 8. CopilotKit
+
+**Purpose**: AI chat interface and interactions
+
+**Setup Steps**:
+1. Visit [CopilotKit](https://copilotkit.ai/)
+2. Sign up for an account
+3. Get your API key
+4. Add to `COPILOT_API_KEY` in both `.env` files
+
+**Benefits**:
+- Interactive AI chat
+- Context-aware responses
+- Seamless user experience
+
+## Database Configuration
+
+### SQLite (Development)
+
+**Default Configuration**:
+```env
+DATABASE_URL=sqlite:///./alwrity.db
+```
+
+**Benefits**:
+- No additional setup required
+- Perfect for development
+- File-based storage
+
+### PostgreSQL (Production)
+
+**Setup Steps**:
+1. Install PostgreSQL
+2. Create database and user
+3. Update environment variable:
+
+```env
+DATABASE_URL=postgresql://username:password@localhost:5432/alwrity
+```
+
+**Benefits**:
+- Better performance
+- Concurrent access
+- Advanced features
+
+### Database Initialization
+
+```bash
+# Initialize database with default data
+python scripts/init_alpha_subscription_tiers.py
+
+# Or manually initialize
+python -c "from services.database import initialize_database; initialize_database()"
+```
+
+## Security Configuration
+
+### Secret Key Generation
+
+```bash
+# Generate a secure secret key
+python -c "import secrets; print(secrets.token_urlsafe(32))"
+```
+
+### Environment Security
+
+**Best Practices**:
+- Never commit `.env` files to version control
+- Use different keys for development and production
+- Rotate API keys regularly
+- Monitor API usage and costs
+
+### CORS Configuration
+
+The backend automatically configures CORS for development. For production, update the CORS settings in `backend/app.py`:
+
+```python
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["https://your-domain.com"],  # Production domain
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+```
+
+## Performance Configuration
+
+### Backend Optimization
+
+```env
+# Worker processes (for production)
+WORKERS=4
+
+# Request timeout
+REQUEST_TIMEOUT=30
+
+# Database connection pool
+DB_POOL_SIZE=10
+```
+
+### Frontend Optimization
+
+```env
+# Enable production optimizations
+NODE_ENV=production
+
+# Bundle analyzer
+ANALYZE_BUNDLE=true
+
+# Source maps (disable for production)
+GENERATE_SOURCEMAP=false
+```
+
+## Monitoring & Logging
+
+### Logging Configuration
+
+```env
+# Log level
+LOG_LEVEL=INFO
+
+# Log file
+LOG_FILE=logs/alwrity.log
+
+# Enable request logging
+ENABLE_REQUEST_LOGGING=true
+```
+
+### Health Checks
+
+```bash
+# Backend health check
+curl http://localhost:8000/health
+
+# Database health check
+curl http://localhost:8000/health/db
+
+# API health check
+curl http://localhost:8000/health/api
+```
+
+## Configuration Validation
+
+### Test Configuration
+
+```bash
+# Test backend configuration
+python -c "from services.api_key_manager import validate_api_keys; validate_api_keys()"
+
+# Test database connection
+python -c "from services.database import test_connection; test_connection()"
+
+# Test API endpoints
+curl http://localhost:8000/api/health
+```
+
+### Configuration Checklist
+
+- [ ] All required API keys are set
+- [ ] Database is initialized
+- [ ] Backend server starts without errors
+- [ ] Frontend connects to backend
+- [ ] Authentication is working (if configured)
+- [ ] API endpoints are accessible
+- [ ] Health checks pass
+
+## Troubleshooting Configuration
+
+### Common Issues
+
+**API Key Errors**:
+- Verify keys are correctly copied
+- Check for extra spaces or characters
+- Ensure keys have proper permissions
+
+**Database Connection Issues**:
+- Verify database URL format
+- Check database server is running
+- Ensure proper permissions
+
+**CORS Errors**:
+- Check frontend URL in CORS settings
+- Verify backend is running on correct port
+- Check for HTTPS/HTTP mismatch
+
+**Authentication Issues**:
+- Verify Clerk keys are correct
+- Check domain configuration in Clerk
+- Ensure proper redirect URLs
+
+### Getting Help
+
+If you encounter configuration issues:
+
+1. **Check Logs**: Review console output for error messages
+2. **Validate Keys**: Test API keys individually
+3. **Verify URLs**: Ensure all URLs are correct
+4. **Check Permissions**: Verify API key permissions
+5. **Review Documentation**: Check service-specific documentation
+
+## Next Steps
+
+After successful configuration:
+
+1. **[First Steps](first-steps.md)** - Create your first content strategy
+2. **[Quick Start](quick-start.md)** - Get up and running quickly
+3. **[Troubleshooting Guide](../guides/troubleshooting.md)** - Common issues and solutions
+4. **[API Reference](../api/overview.md)** - Complete API documentation
+
+---
+
+*Configuration complete? [Start creating content](first-steps.md) with your newly configured ALwrity platform!*
diff --git a/docs-site/docs/getting-started/first-steps.md b/docs-site/docs/getting-started/first-steps.md
new file mode 100644
index 00000000..737147ae
--- /dev/null
+++ b/docs-site/docs/getting-started/first-steps.md
@@ -0,0 +1,330 @@
+# First Steps with ALwrity
+
+Welcome to ALwrity! This guide will walk you through your first content creation journey, from initial setup to publishing your first AI-generated content. Follow these steps to get the most out of your AI-powered content creation platform.
+
+## Prerequisites
+
+Before you begin, ensure you have:
+
+- ✅ **ALwrity Installed**: Follow the [Installation Guide](installation.md)
+- ✅ **Configuration Complete**: Set up your [API keys and settings](configuration.md)
+- ✅ **Backend Running**: Server available at `http://localhost:8000`
+- ✅ **Frontend Running**: Application available at `http://localhost:3000`
+
+## Step 1: Access the Dashboard
+
+### 1.1 Open ALwrity
+
+1. **Navigate to**: `http://localhost:3000`
+2. **Sign In**: Use your authentication method (if configured)
+3. **Dashboard**: You'll see the main ALwrity dashboard
+
+### 1.2 Dashboard Overview
+
+The dashboard provides access to:
+
+- **📝 Blog Writer**: AI-powered blog content creation
+- **📊 SEO Dashboard**: Content optimization and analytics
+- **💼 LinkedIn Writer**: Professional social media content
+- **📱 Facebook Writer**: Social media content creation
+- **🎯 Content Strategy**: Strategic planning and personas
+- **📈 Analytics**: Performance tracking and insights
+
+## Step 2: Complete Onboarding
+
+### 2.1 Business Information
+
+1. **Click "Get Started"** or navigate to onboarding
+2. **Enter Business Details**:
+   - Business name and type
+   - Industry or niche
+   - Target audience description
+   - Business goals and objectives
+
+### 2.2 Content Preferences
+
+1. **Content Types**: Select the types of content you want to create
+   - Blog posts
+   - Social media content
+   - Email newsletters
+   - Marketing materials
+
+2. **Brand Voice**: Define your brand personality
+   - Professional and formal
+   - Casual and friendly
+   - Technical and detailed
+   - Creative and engaging
+
+3. **Content Goals**: Specify your objectives
+   - Brand awareness
+   - Lead generation
+   - Customer education
+   - Sales conversion
+
+### 2.3 AI Persona Generation
+
+1. **Persona Creation**: ALwrity will generate detailed buyer personas
+2. **Review Personas**: Examine the AI-generated audience profiles
+3. **Customize**: Adjust personas based on your knowledge
+4. **Save**: Confirm your persona configuration
+
+## Step 3: Create Your First Blog Post
+
+### 3.1 Access Blog Writer
+
+1. **Navigate to**: Blog Writer from the dashboard
+2. **Click**: "Create New Blog Post"
+3. **Select**: Content creation mode
+
+### 3.2 Topic Selection
+
+1. **Enter Topic**: Provide a topic or keyword
+   - Example: "AI in Digital Marketing"
+   - Example: "Content Strategy for Small Businesses"
+   - Example: "SEO Best Practices 2024"
+
+2. **AI Research**: ALwrity will automatically:
+   - Research your topic
+   - Analyze competitor content
+   - Identify key points to cover
+   - Find relevant statistics and data
+
+### 3.3 Content Planning
+
+1. **Review Research**: Examine the AI-generated research
+2. **Outline Generation**: AI creates a structured outline
+3. **Customize Outline**: Adjust sections and points
+4. **Add Requirements**: Specify any special requirements
+
+### 3.4 Content Generation
+
+1. **Generate Content**: AI creates the full blog post
+2. **Review Sections**: Examine each section of the content
+3. **Edit and Refine**: Make adjustments as needed
+4. **Add Personal Touch**: Include your unique insights
+
+### 3.5 SEO Optimization
+
+1. **SEO Analysis**: AI analyzes content for SEO
+2. **Keyword Optimization**: Optimize for target keywords
+3. **Meta Tags**: Generate title and description
+4. **Readability**: Ensure content is easy to read
+
+## Step 4: Optimize with SEO Dashboard
+
+### 4.1 SEO Analysis
+
+1. **Navigate to**: SEO Dashboard
+2. **Upload Content**: Import your blog post
+3. **Run Analysis**: AI performs comprehensive SEO analysis
+
+### 4.2 SEO Recommendations
+
+1. **Keyword Density**: Optimize keyword usage
+2. **Content Structure**: Improve headings and organization
+3. **Meta Optimization**: Enhance title and description
+4. **Internal Linking**: Add relevant internal links
+
+### 4.3 Performance Insights
+
+1. **Competitor Analysis**: Compare with top-performing content
+2. **Gap Analysis**: Identify missing elements
+3. **Improvement Suggestions**: Get specific recommendations
+4. **Performance Prediction**: Forecast content success
+
+## Step 5: Create Social Media Content
+
+### 5.1 LinkedIn Content
+
+1. **Navigate to**: LinkedIn Writer
+2. **Select Content Type**:
+   - Professional posts
+   - Articles
+   - Carousel posts
+   - Video scripts
+
+3. **Generate Content**: AI creates LinkedIn-optimized content
+4. **Review and Edit**: Customize for your brand voice
+5. **Add Hashtags**: Include relevant hashtags
+
+### 5.2 Facebook Content
+
+1. **Navigate to**: Facebook Writer
+2. **Choose Format**:
+   - Text posts
+   - Image captions
+   - Video descriptions
+   - Event promotions
+
+3. **Generate Content**: AI creates Facebook-optimized content
+4. **Review Engagement**: Optimize for Facebook algorithms
+5. **Schedule Posts**: Plan your content calendar
+
+## Step 6: Develop Content Strategy
+
+### 6.1 Strategic Planning
+
+1. **Navigate to**: Content Strategy
+2. **Review AI-Generated Strategy**: Examine the comprehensive plan
+3. **Content Calendar**: View your suggested publishing schedule
+4. **Topic Clusters**: Understand content themes and relationships
+
+### 6.2 Persona Refinement
+
+1. **Access Personas**: Review your buyer personas
+2. **Update Information**: Add new insights about your audience
+3. **Content Alignment**: Ensure content matches persona needs
+4. **Journey Mapping**: Understand customer touchpoints
+
+### 6.3 Performance Tracking
+
+1. **Set Goals**: Define measurable objectives
+2. **Track Metrics**: Monitor key performance indicators
+3. **Analyze Results**: Review content performance
+4. **Optimize Strategy**: Adjust based on data insights
+
+## Step 7: Publish and Monitor
+
+### 7.1 Content Publishing
+
+1. **Export Content**: Download your optimized content
+2. **Publish**: Upload to your website or platform
+3. **Share**: Distribute across social media channels
+4. **Track**: Monitor publication status
+
+### 7.2 Performance Monitoring
+
+1. **Analytics Dashboard**: View performance metrics
+2. **Engagement Tracking**: Monitor likes, shares, comments
+3. **Traffic Analysis**: Track website visits and conversions
+4. **ROI Measurement**: Calculate return on investment
+
+## Step 8: Iterate and Improve
+
+### 8.1 Content Optimization
+
+1. **Review Performance**: Analyze what's working
+2. **Identify Patterns**: Find successful content types
+3. **Adjust Strategy**: Modify approach based on results
+4. **Scale Success**: Replicate winning formulas
+
+### 8.2 Continuous Learning
+
+1. **AI Feedback**: Let ALwrity learn from your preferences
+2. **Strategy Refinement**: Continuously improve your approach
+3. **New Features**: Explore additional ALwrity capabilities
+4. **Best Practices**: Implement proven strategies
+
+## Best Practices for Success
+
+### Content Creation
+
+- **Be Specific**: Provide detailed topic descriptions
+- **Review AI Output**: Always review and customize generated content
+- **Maintain Brand Voice**: Ensure consistency across all content
+- **Add Personal Insights**: Include your unique perspective
+
+### SEO Optimization
+
+- **Target Keywords**: Focus on relevant, high-value keywords
+- **Optimize Structure**: Use proper headings and formatting
+- **Internal Linking**: Connect related content pieces
+- **Monitor Performance**: Track SEO improvements over time
+
+### Social Media
+
+- **Platform Optimization**: Tailor content for each platform
+- **Engagement Focus**: Create content that encourages interaction
+- **Consistent Posting**: Maintain regular publishing schedule
+- **Community Building**: Foster relationships with your audience
+
+### Strategy Development
+
+- **Data-Driven Decisions**: Base strategy on performance data
+- **Regular Reviews**: Assess and adjust strategy monthly
+- **Goal Alignment**: Ensure content supports business objectives
+- **Competitive Analysis**: Stay aware of competitor activities
+
+## Common First-Time User Tips
+
+### Getting Started
+
+1. **Start Small**: Begin with one content type and expand
+2. **Learn the Interface**: Familiarize yourself with all features
+3. **Test Different Topics**: Experiment with various content themes
+4. **Save Templates**: Create reusable content templates
+
+### Content Quality
+
+1. **Review Everything**: Always review AI-generated content
+2. **Add Personal Touch**: Include your unique insights
+3. **Fact-Check**: Verify important information and statistics
+4. **Maintain Consistency**: Keep brand voice consistent
+
+### Performance Optimization
+
+1. **Track Metrics**: Monitor key performance indicators
+2. **A/B Test**: Experiment with different approaches
+3. **Learn from Data**: Use analytics to guide decisions
+4. **Iterate Quickly**: Make adjustments based on results
+
+## Troubleshooting Common Issues
+
+### Content Generation
+
+**Issue**: AI generates generic content
+**Solution**: Provide more specific topic descriptions and requirements
+
+**Issue**: Content doesn't match brand voice
+**Solution**: Update persona settings and brand voice preferences
+
+**Issue**: SEO scores are low
+**Solution**: Use SEO Dashboard recommendations and optimize content
+
+### Technical Issues
+
+**Issue**: Content doesn't save
+**Solution**: Check browser console for errors and refresh page
+
+**Issue**: Slow content generation
+**Solution**: Verify API keys and check internet connection
+
+**Issue**: Research data is outdated
+**Solution**: Ensure research services are properly configured
+
+## Next Steps
+
+After completing your first content creation cycle:
+
+1. **[Explore Advanced Features](../features/blog-writer/overview.md)** - Learn about advanced content creation
+2. **[SEO Optimization Guide](../features/seo-dashboard/overview.md)** - Master SEO techniques
+3. **[Content Strategy Development](../features/content-strategy/overview.md)** - Build comprehensive strategies
+4. **[Performance Analytics](../guides/performance.md)** - Track and optimize results
+5. **[Troubleshooting Guide](../guides/troubleshooting.md)** - Resolve common issues
+
+## Success Metrics to Track
+
+### Content Performance
+
+- **Engagement Rate**: Likes, shares, comments per post
+- **Click-Through Rate**: Clicks on links and CTAs
+- **Time on Page**: How long readers engage with content
+- **Conversion Rate**: Actions taken after reading content
+
+### SEO Performance
+
+- **Search Rankings**: Position in search results
+- **Organic Traffic**: Visitors from search engines
+- **Keyword Rankings**: Performance for target keywords
+- **Backlinks**: Links from other websites
+
+### Business Impact
+
+- **Lead Generation**: New prospects from content
+- **Sales Conversion**: Revenue attributed to content
+- **Brand Awareness**: Mentions and recognition
+- **Customer Engagement**: Interaction and feedback
+
+---
+
+*Ready to create amazing content? [Explore our advanced features](../features/blog-writer/overview.md) and take your content strategy to the next level!*
diff --git a/docs-site/docs/getting-started/installation.md b/docs-site/docs/getting-started/installation.md
new file mode 100644
index 00000000..393b83ef
--- /dev/null
+++ b/docs-site/docs/getting-started/installation.md
@@ -0,0 +1,348 @@
+# Installation Guide
+
+This comprehensive guide will walk you through installing and setting up ALwrity on your system. Follow these steps to get your AI-powered content creation platform running.
+
+## Prerequisites
+
+Before you begin, ensure you have the following installed on your system:
+
+### System Requirements
+
+- **Operating System**: Windows 10/11, macOS 10.15+, or Linux (Ubuntu 18.04+)
+- **Python**: Version 3.10 or higher
+- **Node.js**: Version 18 or higher
+- **Git**: Latest version for version control
+- **Memory**: Minimum 4GB RAM (8GB recommended)
+- **Storage**: At least 2GB free disk space
+
+### Required Software
+
+#### 1. Python 3.10+
+```bash
+# Check if Python is installed
+python --version
+
+# If not installed, download from: https://www.python.org/downloads/
+# Or use package manager:
+# Windows: choco install python
+# macOS: brew install python
+# Ubuntu: sudo apt install python3.10
+```
+
+#### 2. Node.js 18+
+```bash
+# Check if Node.js is installed
+node --version
+npm --version
+
+# If not installed, download from: https://nodejs.org/
+# Or use package manager:
+# Windows: choco install nodejs
+# macOS: brew install node
+# Ubuntu: curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
+```
+
+#### 3. Git
+```bash
+# Check if Git is installed
+git --version
+
+# If not installed, download from: https://git-scm.com/
+# Or use package manager:
+# Windows: choco install git
+# macOS: brew install git
+# Ubuntu: sudo apt install git
+```
+
+## Installation Steps
+
+### Step 1: Clone the Repository
+
+```bash
+# Clone the ALwrity repository
+git clone https://github.com/AJaySi/ALwrity.git
+
+# Navigate to the project directory
+cd ALwrity
+```
+
+### Step 2: Backend Setup
+
+#### 2.1 Install Python Dependencies
+
+```bash
+# Navigate to backend directory
+cd backend
+
+# Create virtual environment (recommended)
+python -m venv venv
+
+# Activate virtual environment
+# Windows:
+venv\Scripts\activate
+# macOS/Linux:
+source venv/bin/activate
+
+# Install dependencies
+pip install -r requirements.txt
+```
+
+#### 2.2 Environment Configuration
+
+Create a `.env` file in the backend directory:
+
+```bash
+# Create environment file
+touch .env  # Linux/macOS
+# or
+type nul > .env  # Windows
+```
+
+Add the following configuration to your `.env` file:
+
+```env
+# AI Service API Keys (Required)
+GEMINI_API_KEY=your_gemini_api_key_here
+OPENAI_API_KEY=your_openai_api_key_here
+ANTHROPIC_API_KEY=your_anthropic_api_key_here
+
+# Database Configuration
+DATABASE_URL=sqlite:///./alwrity.db
+
+# Security
+SECRET_KEY=your_secret_key_here
+
+# Optional: Additional AI Services
+TAVILY_API_KEY=your_tavily_api_key_here
+SERPER_API_KEY=your_serper_api_key_here
+METAPHOR_API_KEY=your_metaphor_api_key_here
+FIRECRAWL_API_KEY=your_firecrawl_api_key_here
+STABILITY_API_KEY=your_stability_api_key_here
+
+# Optional: Google Search Console
+GSC_CLIENT_ID=your_gsc_client_id_here
+GSC_CLIENT_SECRET=your_gsc_client_secret_here
+
+# Optional: Clerk Authentication
+CLERK_SECRET_KEY=your_clerk_secret_key_here
+
+# Optional: CopilotKit
+COPILOT_API_KEY=your_copilot_api_key_here
+```
+
+#### 2.3 Initialize Database
+
+```bash
+# Initialize the database
+python -c "from services.database import initialize_database; initialize_database()"
+
+# Or run the initialization script
+python scripts/init_alpha_subscription_tiers.py
+```
+
+#### 2.4 Start Backend Server
+
+```bash
+# Start the backend server
+python start_alwrity_backend.py
+
+# The server will be available at: http://localhost:8000
+# API documentation: http://localhost:8000/api/docs
+# Health check: http://localhost:8000/health
+```
+
+### Step 3: Frontend Setup
+
+#### 3.1 Install Node.js Dependencies
+
+```bash
+# Navigate to frontend directory (in a new terminal)
+cd frontend
+
+# Install dependencies
+npm install
+```
+
+#### 3.2 Frontend Environment Configuration
+
+Create a `.env` file in the frontend directory:
+
+```bash
+# Create environment file
+touch .env  # Linux/macOS
+# or
+type nul > .env  # Windows
+```
+
+Add the following configuration:
+
+```env
+# Backend API URL
+REACT_APP_API_URL=http://localhost:8000
+
+# Clerk Authentication (Optional)
+REACT_APP_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key_here
+
+# CopilotKit (Optional)
+REACT_APP_COPILOT_API_KEY=your_copilot_api_key_here
+
+# Google Search Console (Optional)
+REACT_APP_GSC_CLIENT_ID=your_gsc_client_id_here
+
+# Environment
+NODE_ENV=development
+```
+
+#### 3.3 Start Frontend Development Server
+
+```bash
+# Start the frontend development server
+npm start
+
+# The application will be available at: http://localhost:3000
+```
+
+## Verification
+
+### Backend Verification
+
+1. **Health Check**: Visit `http://localhost:8000/health`
+   - Should return: `{"status": "healthy"}`
+
+2. **API Documentation**: Visit `http://localhost:8000/api/docs`
+   - Should display interactive API documentation
+
+3. **Database Check**: Verify database file exists
+   ```bash
+   ls -la backend/alwrity.db  # Linux/macOS
+   dir backend\alwrity.db     # Windows
+   ```
+
+### Frontend Verification
+
+1. **Application Load**: Visit `http://localhost:3000`
+   - Should display the ALwrity dashboard
+
+2. **API Connection**: Check browser console for connection errors
+   - Should show successful API connections
+
+3. **Authentication**: Test login functionality (if configured)
+
+## API Keys Setup
+
+### Required API Keys
+
+#### 1. Google Gemini API
+- Visit: [Google AI Studio](https://makersuite.google.com/app/apikey)
+- Create a new API key
+- Add to `GEMINI_API_KEY` in backend `.env`
+
+#### 2. OpenAI API (Optional)
+- Visit: [OpenAI Platform](https://platform.openai.com/api-keys)
+- Create a new API key
+- Add to `OPENAI_API_KEY` in backend `.env`
+
+#### 3. Anthropic API (Optional)
+- Visit: [Anthropic Console](https://console.anthropic.com/)
+- Create a new API key
+- Add to `ANTHROPIC_API_KEY` in backend `.env`
+
+### Optional API Keys
+
+#### Research & SEO Services
+- **Tavily**: [Tavily API](https://tavily.com/) - Web search and research
+- **Serper**: [Serper API](https://serper.dev/) - Google search results
+- **Metaphor**: [Metaphor API](https://metaphor.systems/) - Content discovery
+- **Firecrawl**: [Firecrawl API](https://firecrawl.dev/) - Web scraping
+
+#### Content Generation
+- **Stability AI**: [Stability Platform](https://platform.stability.ai/) - Image generation
+
+#### Authentication & Integration
+- **Clerk**: [Clerk Dashboard](https://dashboard.clerk.com/) - User authentication
+- **CopilotKit**: [CopilotKit](https://copilotkit.ai/) - AI chat interface
+
+## Troubleshooting
+
+### Common Issues
+
+#### Backend Issues
+
+**Port Already in Use**
+```bash
+# Find process using port 8000
+netstat -ano | findstr :8000  # Windows
+lsof -i :8000                 # macOS/Linux
+
+# Kill the process or use different port
+python start_alwrity_backend.py --port 8001
+```
+
+**Database Connection Error**
+```bash
+# Reset database
+rm backend/alwrity.db  # Linux/macOS
+del backend\alwrity.db  # Windows
+
+# Reinitialize
+python -c "from services.database import initialize_database; initialize_database()"
+```
+
+**Missing Dependencies**
+```bash
+# Reinstall requirements
+pip install -r requirements.txt --force-reinstall
+```
+
+#### Frontend Issues
+
+**Port Already in Use**
+```bash
+# Use different port
+npm start -- --port 3001
+```
+
+**Build Errors**
+```bash
+# Clear cache and reinstall
+rm -rf node_modules package-lock.json
+npm install
+```
+
+**API Connection Issues**
+- Verify backend is running on `http://localhost:8000`
+- Check `REACT_APP_API_URL` in frontend `.env`
+- Ensure CORS is properly configured
+
+### Getting Help
+
+If you encounter issues:
+
+1. **Check Logs**: Review console output for error messages
+2. **Verify Configuration**: Ensure all environment variables are set
+3. **Test API Keys**: Verify API keys are valid and have sufficient credits
+4. **Check Dependencies**: Ensure all required software is installed
+5. **Review Documentation**: Check our [troubleshooting guide](../guides/troubleshooting.md)
+
+## Next Steps
+
+After successful installation:
+
+1. **[Configuration Guide](configuration.md)** - Configure your API keys and settings
+2. **[First Steps](first-steps.md)** - Create your first content strategy
+3. **[Quick Start](quick-start.md)** - Get up and running quickly
+4. **[Troubleshooting Guide](../guides/troubleshooting.md)** - Common issues and solutions
+
+## Production Deployment
+
+For production deployment, consider:
+
+- **Environment Variables**: Use secure environment variable management
+- **Database**: Consider PostgreSQL or MySQL for production
+- **SSL/TLS**: Enable HTTPS for secure connections
+- **Monitoring**: Set up logging and monitoring
+- **Backup**: Implement regular database backups
+
+---
+
+*Installation complete? [Configure your settings](configuration.md) to start creating amazing content with ALwrity!*
diff --git a/docs-site/mkdocs.yml b/docs-site/mkdocs.yml
index 214156df..57261238 100644
--- a/docs-site/mkdocs.yml
+++ b/docs-site/mkdocs.yml
@@ -97,8 +97,12 @@ extra:
 # Navigation structure
 nav:
   - Home: index.md
+  - About: about.md
   - Getting Started:
     - Quick Start: getting-started/quick-start.md
+    - Installation: getting-started/installation.md
+    - Configuration: getting-started/configuration.md
+    - First Steps: getting-started/first-steps.md
   - Features:
     - Blog Writer:
       - Overview: features/blog-writer/overview.md