diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml
deleted file mode 100644
index 7f40bbb9..00000000
--- a/.github/FUNDING.yml
+++ /dev/null
@@ -1,12 +0,0 @@
-# These are supported funding model platforms
-
-github: [AJaySi]
-patreon: # Replace with a single Patreon username
-open_collective: # Replace with a single Open Collective name
-ko_fi: # Replace with a single Ko-fi username
-tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
-community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
-liberapay: # Replace with a single Liberapay username
-issuehunt: # Replace with a single IssueHunt username
-otechie: # Replace with a single Otechie username
-custom: ['https://www.alwrity.com/donate', 'https://www.buymeacoffee.com/alwrity']
diff --git a/.github/README.md b/.github/README.md
index 8a547d93..02b5f43e 100644
--- a/.github/README.md
+++ b/.github/README.md
@@ -1,559 +1,163 @@
-# π ALwrity - AI-Powered Digital Marketing Platform
-
-
+# π ALwrity β AI-Powered Digital Marketing Platform
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/)
[](https://fastapi.tiangolo.com/)
-[](https://reactjs.org/)
-[](https://github.com/AJaySi/AI-Writer/stargazers)
-[](https://github.com/AJaySi/AI-Writer/network/members)
+[](https://react.dev/)
+[](https://github.com/AJaySi/AI-Writer/stargazers)
-**π The Ultimate AI-Powered Digital Marketing Platform for Solopreneurs & Content Creators**
+**Create, optimize, and publish highβquality content across platforms β in minutes, not months.**
-[π Live Demo](https://www.alwrity.com) β’ [π Documentation](https://github.com/AJaySi/AI-Writer/wiki) β’ [π¬ Community](https://github.com/AJaySi/AI-Writer/discussions) β’ [π Report Issues](https://github.com/AJaySi/AI-Writer/issues)
+[π Live Demo](https://www.alwrity.com) β’ [π Docs Site](https://ajaysi.github.io/ALwrity/) β’ [π Wiki](https://github.com/AJaySi/AI-Writer/wiki) β’ [π¬ Discussions](https://github.com/AJaySi/AI-Writer/discussions) β’ [π Issues](https://github.com/AJaySi/AI-Writer/issues)
----
-
-## π― What is ALwrity?
-
-ALwrity is a **comprehensive AI-powered digital marketing platform** that revolutionizes how solopreneurs and small businesses create, optimize, and manage their entire digital presence. From **content strategy** and **SEO optimization** to **social media automation** and **performance analytics**, ALwrity democratizes enterprise-level marketing capabilities through cutting-edge AI technology.
-
-### π₯ Why Choose ALwrity?
-
-- **π§ AI-First Strategy Generation**: Professional content strategies with minimal user input
-- **π Multi-Modal Content Creation**: Text, images, audio, and video content generation
-- **π Data-Driven Insights**: Web research, competitor analysis, and predictive analytics
-- **π€ AI Agent Teams**: Specialized AI agents for different marketing tasks
-- **π Platform Integration**: Direct publishing to WordPress, Wix, Google Search Console, and more
-- **π Performance Optimization**: Continuous learning and strategy refinement
-- **π― Solopreneur-Focused**: Designed specifically for independent entrepreneurs
-- **π‘οΈ Enterprise Security**: JWT authentication, rate limiting, and comprehensive monitoring
-- **β¨ Intelligent Onboarding**: AI-powered setup process that analyzes your business and generates personalized strategies
-
-### π **NEW: Complete Onboarding & Integration System**
-
-**Transform Your Digital Presence in 5 Simple Steps:**
-
-1. **π§ Email Setup & Business Analysis** - AI analyzes your business domain and industry
-2. **π AI Persona Generation** - Creates detailed buyer personas and audience insights
-3. **π’ Business Information Collection** - Gathers comprehensive business data for personalized strategies
-4. **π Competitor Analysis** - Real-time competitor research and market positioning
-5. **π Platform Integrations** - Connect WordPress, Wix, Google Search Console with OAuth security
-
-**π― User Impact**: Go from zero to fully optimized digital presence in under 15 minutes!
+
+
+
+
+
---
-## π Getting Started (Live Now!)
+### Why ALwrity
+- **AI-first outcomes**: Strategy-to-publishing in one flow β strategy, research, creation, QA, and distribution.
+- **Grounded & reliable**: Google grounding, Exa/Tavily research, citation management.
+- **Secure & scalable**: JWT auth, OAuth2, rate limiting, monitoring, subscription/usage tracking.
+- **Built for solopreneurs**: Enterprise-grade capabilities with a fast, friendly UI.
-### **β‘ Quick Start - 3 Steps to Success**
+---
+
+### Why it matters for creators & marketers
+- **Reduce complexity of AI tools**: Guided flows (research β outline β write β optimize β publish) remove prompt engineering and tool-juggling.
+- **Save time, ship consistently**: Phase navigation and checklists keep you moving, ensuring on-time publishing across platforms.
+- **Trust the content**: Google grounding, retrieval (web/semantic/neural), and citations mean fewer rewrites and safer publishing.
+- **Stay on-brand and compliant**: Personas, tone controls, and rate limits help maintain voice and prevent platform penalties.
+- **Catch issues early**: Scheduler βtasks needing intervention,β alerts, and logs highlight problems before your audience sees them.
+
+---
+
+### Whatβs functional now
+- **AI Blog Writer (Phases)**: Research β Outline β Content β SEO β Publish, with guarded navigation and local persistence (`frontend/src/hooks/usePhaseNavigation.ts`).
+- **SEO Dashboard**: Analysis, metadata, and Google Search Console insights (see docs under `docs-site/docs/features/seo-dashboard`).
+- **Story Writer**: Setup (premise) β Outline β Writing β Export with phase navigation and reset (`frontend/src/hooks/useStoryWriterPhaseNavigation.ts`).
+- **LinkedIn (Factual, GoogleβGrounded)**: Real Google grounding + citations + quality metrics for posts/articles/carousels/scripts (see `frontend/docs/linkedin_factual_google_grounded_url_content.md`).
+- **Persona System**: Core personas and platform adaptations via APIs (`backend/api/persona.py`).
+- **Facebook Persona Service**: Gemini structured JSON for Facebookβspecific persona optimization (`backend/services/persona/facebook/facebook_persona_service.py`).
+- **Personalization & Brand Voice**: Validation and configuration of writing style, tone, structure (`backend/services/component_logic/personalization_logic.py`).
+
+See details in the Wiki: [Docs Home](https://github.com/AJaySi/AI-Writer/wiki)
+
+---
+
+### Quick Start
+1) Clone & install
-**1. Clone & Setup (2 minutes)**
```bash
git clone https://github.com/AJaySi/AI-Writer.git
cd AI-Writer/backend && pip install -r requirements.txt
cd ../frontend && npm install
```
-**2. Launch Platform (1 minute)**
-```bash
-# Terminal 1: Backend
-cd backend && python start_alwrity_backend.py
+2) Run locally
-# Terminal 2: Frontend
+```bash
+# Backend
+cd backend && python start_alwrity_backend.py
+# Frontend
cd frontend && npm start
```
-**3. Access & Create (Instant)**
-- **Frontend**: http://localhost:3000
-- **API Docs**: http://localhost:8000/api/docs
-- **Complete onboarding** β **Generate content** β **Publish everywhere**
-
-### **π― What You'll Get Immediately:**
-- β **AI-powered business analysis** and strategy generation
-- β **LinkedIn content creation** with fact-checking and Google grounding
-- β **Blog writing** with research, SEO optimization, and metadata
-- β **Facebook content generation** with platform-specific optimization
-- β **WordPress & Wix integration** with OAuth security
-- β **Google Search Console** analytics and insights
-- β **Competitor analysis** and market intelligence
+3) Open and create
+- Frontend: http://localhost:3000
+- API docs (local): http://localhost:8000/api/docs
+- Complete onboarding β generate content β publish
---
-## π Current Status & Implementation Progress
-
-### **β Backend Architecture - COMPLETE**
-- **FastAPI Backend**: Fully implemented with modular service architecture
-- **Database Integration**: SQLite with SQLAlchemy ORM (PostgreSQL ready)
-- **Authentication System**: JWT-based multi-tenant system with Clerk integration
-- **API Documentation**: Auto-generated OpenAPI/Swagger docs
-- **Rate Limiting**: Intelligent rate limiting with streaming endpoint exemptions
-- **Monitoring**: Comprehensive logging and performance monitoring
-- **Subscription System**: Complete billing and usage tracking infrastructure
-
-### **β Core AI Services - COMPLETE**
-- **Content Strategy Generation**: 12-step automated strategy creation
-- **LinkedIn Content Generation**: Posts, articles, carousels, video scripts, fact-checking
-- **Facebook Content Generation**: Platform-specific content optimization
-- **Blog Writer**: Complete AI-powered blog creation with research, outline, and content generation
-- **SEO Analysis Tools**: Comprehensive website analysis and optimization
-- **SEO Metadata Generation**: Automated title, description, and structured data creation
-- **Image Generation**: AI-powered image creation with Gemini/Imagen APIs
-- **Content Planning**: Advanced calendar generation and content scheduling
-
-### **β Advanced Features - COMPLETE**
-- **Multi-Provider AI Integration**: OpenAI, Anthropic Claude, Google Gemini, Mistral
-- **Web Research Engine**: Real-time competitor and market analysis
-- **Quality Assurance**: AI-powered content quality analysis and scoring
-- **Citation Management**: Automated source tracking and verification
-- **Content Gap Analysis**: Strategic content opportunity identification
-- **Performance Analytics**: Real-time content performance tracking
-- **Google Search Console Integration**: OAuth2 authentication and real-time analytics
-- **Hallucination Detection**: AI-powered fact-checking and content verification
-- **Persona System**: Advanced writing persona generation and management
-- **Google Grounding**: Real-time fact verification using Google Search API
-- **Exa AI Integration**: Advanced semantic search and content discovery
-- **Assistive Writing**: Real-time writing suggestions and optimization
-
-### **β Frontend Development - COMPLETE**
-- **React Application**: Modern TypeScript-based frontend with Material-UI
-- **CopilotKit Integration**: AI-powered chat interface with contextual suggestions
-- **Responsive Design**: Mobile-optimized user experience
-- **Real-time Updates**: Live progress tracking and notifications
-- **Blog Writer Interface**: Complete WYSIWYG editor with research integration
-- **SEO Dashboard**: Comprehensive SEO analysis and metadata generation tools
-- **Complete Onboarding System**: 5-step AI-powered setup with business analysis
-- **Platform Integrations**: WordPress, Wix, Google Search Console with OAuth
-- **Coming Soon Section**: Interactive preview of upcoming features
-
-### **π Launch Timeline**
-- **Current**: Full platform operational with all core features
-- **Q1 2025**: Advanced integrations and mobile application
-- **Q2 2025**: Enterprise features and white-label solutions
+### Integrations & Security
+- **Integrations**: Google Search Console (SEO Dashboard), LinkedIn (factual/grounded content).
+- **AI Models**: OpenAI, Google Gemini/Imagen, Hugging Face, Anthropic, Mistral.
+- **Security**: JWT auth, OAuth2, rate limiting, monitoring/logging.
+- **Reliability**: Grounding + retrieval and citation tracking for factual generation.
---
-## β¨ Core Features (Currently Available)
+### Tech Stack
-### π― **AI-Powered Content Strategy Generation**
-
-| **Strategy Component** | **AI Capabilities** | **Status** |
-|----------------------|-------------------|------------|
-| **Goal Setting & KPIs** | SMART goal generation, measurable KPIs | β Complete |
-| **Audience Personas** | Detailed buyer personas, journey mapping | β Complete |
-| **Competitive Intelligence** | Real-time competitor analysis, gap identification | β Complete |
-| **Keyword Strategy** | Topic clusters, long-tail keywords, intent analysis | β Complete |
-| **Content Calendar** | AI-suggested content types, optimal timing | β Complete |
-
-### ποΈ **Multi-Platform Content Creation**
-
-| **Platform** | **Content Types** | **Status** |
-|--------------|------------------|------------|
-| **LinkedIn** | Posts, Articles, Carousels, Video Scripts, Comments, Fact-Checking, Google Grounding | β Complete |
-| **Facebook** | Posts, Stories, Ads, Community Content | β Complete |
-| **Blog Writer** | Research, Outline, Content Generation, SEO Analysis, Metadata, Exa AI Integration | β Complete |
-| **SEO Content** | Blog posts, landing pages, technical content | β Complete |
-| **General Content** | Long-form articles, social media posts | β Complete |
-| **Assistive Writing** | Real-time suggestions, grammar checking, tone optimization | β Complete |
-
-### π **Advanced Research & Fact-Checking**
-
-| **Feature** | **AI Capabilities** | **Status** |
-|-------------|-------------------|------------|
-| **Google Grounding** | Real-time fact verification using Google Search | β Complete |
-| **Exa AI Integration** | Semantic search and content discovery | β Complete |
-| **Fact-Checking Engine** | AI-powered content verification and source validation | β Complete |
-| **Web Research** | Automated competitor analysis and market intelligence | β Complete |
-| **Citation Management** | Automatic source tracking and verification | β Complete |
-
-### π **Complete Onboarding System**
-
-| **Step** | **AI Capabilities** | **User Impact** |
-|----------|-------------------|-----------------|
-| **π§ Email & Business Analysis** | AI analyzes your domain, industry, and business model | **Instant business insights** and personalized recommendations |
-| **π AI Persona Generation** | Creates detailed buyer personas with demographic and psychographic data | **Target the right audience** with precision marketing strategies |
-| **π’ Business Information** | Collects comprehensive business data for strategy personalization | **Customized content strategies** that align with your business goals |
-| **π Competitor Analysis** | Real-time competitor research using Exa AI and web scraping | **Stay ahead of competition** with data-driven market positioning |
-| **π Platform Integrations** | OAuth-secured connections to WordPress, Wix, Google Search Console | **Publish everywhere** with one-click integration and real-time analytics |
-
-**π― User Benefits:**
-- **15-minute setup** from zero to fully optimized digital presence
-- **Professional marketing strategy** without hiring agencies
-- **Automated competitor intelligence** for strategic advantage
-- **One-click publishing** across all major platforms
-- **Real-time performance tracking** with actionable insights
-
-### π **Advanced SEO & Technical Optimization**
-
-| **SEO Category** | **AI Capabilities** | **Status** |
-|------------------|-------------------|------------|
-| **Technical SEO** | Automated audits, schema generation, site optimization | β Complete |
-| **Content SEO** | Intent optimization, semantic analysis, featured snippet targeting | β Complete |
-| **Local SEO** | Local business optimization, GMB content generation | β Complete |
-| **AI Search Optimization** | Optimization for AI tools and voice search | β Complete |
-| **SEO Metadata** | Automated title, description, Open Graph, Twitter Cards | β Complete |
-| **Google Search Console** | OAuth2 integration, real-time analytics, sitemap analysis | β Complete |
-
-### π **Platform Integrations & Publishing**
-
-| **Integration** | **Features** | **User Impact** |
-|-----------------|-------------|-----------------|
-| **WordPress OAuth** | Direct publishing, media management, category/tag sync | **One-click publishing** to WordPress sites with full content optimization |
-| **Wix Integration** | Blog post creation, media upload, SEO optimization | **Seamless Wix publishing** with automatic SEO metadata generation |
-| **Google Search Console** | Real-time analytics, search performance, keyword tracking | **Data-driven optimization** with actual search performance insights |
-| **LinkedIn Publishing** | Direct post creation, article publishing, engagement tracking | **Professional content** published directly to LinkedIn with analytics |
-| **Facebook Integration** | Post scheduling, media upload, audience targeting | **Social media automation** with platform-specific optimization |
-
-**π― Integration Benefits:**
-- **OAuth security** - No password sharing, enterprise-grade authentication
-- **Real-time analytics** - Performance tracking across all platforms
-- **Automated SEO** - Every published piece optimized for search engines
-- **Content synchronization** - Consistent branding and messaging across platforms
-- **Performance insights** - Data-driven content optimization recommendations
-
-### πΌοΈ **AI Image Generation**
-
-| **Feature** | **Capabilities** | **Status** |
-|-------------|------------------|------------|
-| **Text-to-Image** | Gemini API integration with Imagen fallback | β Complete |
-| **Content-Aware Generation** | AI-powered prompt generation based on content | β Complete |
-| **Platform Optimization** | LinkedIn-specific image generation | β Complete |
-| **Quality Control** | AI-powered image quality assessment | β Complete |
-
-### π **Performance Analytics & Optimization**
-
-| **Analytics Feature** | **AI Capabilities** | **Status** |
-|---------------------|-------------------|------------|
-| **Real-time Analytics** | Content performance tracking and insights | β Complete |
-| **Quality Scoring** | AI-powered content quality assessment | β Complete |
-| **Performance Prediction** | Content success forecasting | β Complete |
-| **Automated Optimization** | Continuous strategy refinement | β Complete |
-| **Usage Tracking** | Comprehensive API usage and billing analytics | β Complete |
-
-### π **Coming Soon Features**
-
-| **Feature** | **Status** | **Expected Impact** |
-|-------------|------------|-------------------|
-| **Social Media OAuth** | π Awaiting Platform Approval | **Automated LinkedIn & Facebook posting** with advanced scheduling |
-| **Instagram Integration** | π Planned | **Story creation, hashtag optimization, and visual content** |
-| **Advanced WordPress Features** | π In Development | **Media library management, advanced SEO tools, auto-publishing** |
-| **Mobile Application** | π Q2 2025 | **Content creation and management on-the-go** |
-| **AI Agent Marketplace** | π Q3 2025 | **Specialized AI agents for specific marketing tasks** |
-| **Enterprise White-Label** | π Q3 2025 | **Customizable platform for agencies and enterprises** |
-
-**π― Future Benefits:**
-- **Complete social media automation** across all major platforms
-- **Mobile-first content creation** for busy entrepreneurs
-- **AI agent ecosystem** for specialized marketing tasks
-- **Enterprise-grade customization** for agencies and large teams
-
-### π‘οΈ **Enterprise Features**
-
-| **Feature** | **Capabilities** | **Status** |
-|-------------|------------------|------------|
-| **Authentication** | JWT-based multi-tenant system with Clerk integration | β Complete |
-| **Rate Limiting** | Intelligent rate limiting with streaming exemptions | β Complete |
-| **Monitoring** | Comprehensive logging and performance monitoring | β Complete |
-| **Subscription System** | Complete billing and usage tracking | β Complete |
-| **Hallucination Detection** | AI-powered fact-checking and verification | β Complete |
-| **Persona Management** | Advanced writing persona generation | β Complete |
+| Area | Technologies |
+| --- | --- |
+| Backend | FastAPI, Python 3.10+, SQLAlchemy |
+| Frontend | React 18+, TypeScript, MaterialβUI, CopilotKit |
+| AI/Research | OpenAI, Gemini/Imagen, Hugging Face, Anthropic, Mistral; Exa, Tavily, Serper (auto provider selection: Gemini default, HF fallback) |
+| Data | SQLite (PostgreSQLβready) |
+| Integrations | Google Search Console, LinkedIn |
+| Ops | Loguru monitoring, rate limiting, JWT/OAuth2 |
---
-## π οΈ Technology Stack (Current Implementation)
+### LLM Providers: Gemini & Hugging Face
+- **Autoβselection**: The backend autoβselects the provider based on `GPT_PROVIDER` and available keys.
+ - Default: Gemini (if `GEMINI_API_KEY` present)
+ - Fallback: Hugging Face (if `HF_TOKEN` present)
+- **Configure**:
+ - `GEMINI_API_KEY=...` (text + structured JSON; image via Imagen)
+ - `HF_TOKEN=...` (text via Inference API; image via supported HF models)
+ - Optional: `GPT_PROVIDER=gemini` or `GPT_PROVIDER=hf_response_api`
+- **Text generation**:
+ - Gemini: optimized for structured outputs and fast general generation
+ - HF: broad model access via the Inference Providers
+- **Image generation**:
+ - Gemini/Imagen and Hugging Face providers are supported with a unified interface
+
+For module details, see `backend/services/llm_providers/README.md`.
+
+---
+
+### Documentation
+- Docs Site (MkDocs): https://ajaysi.github.io/ALwrity/
+- Blog Writer (phases and UI): `docs-site/docs/features/blog-writer/overview.md`
+- SEO Dashboard overview: `docs-site/docs/features/seo-dashboard/overview.md`
+- SEO Dashboard GSC integration: `docs-site/docs/features/seo-dashboard/gsc-integration.md`
+- LinkedIn factual, Google-grounded content: `frontend/docs/linkedin_factual_google_grounded_url_content.md`
+- Persona Development (docs-site): `docs-site/docs/features/content-strategy/personas.md`
+
+For additional pages, browse the `docs-site/docs/` folder.
+
+---
+
+### Personas (Brief)
+ALwrity generates a core writing persona from onboarding data, then adapts it per platform (e.g., Facebook, LinkedIn). Personas guide tone, structure, and content preferences across tools.
+
+- Core Persona & API: `backend/api/persona.py`
+- Facebook Persona Service (Gemini structured JSON): `backend/services/persona/facebook/facebook_persona_service.py`
+- Personalization/Brand Voice logic: `backend/services/component_logic/personalization_logic.py`
+- Docs (GitHub paths):
+ - Personas (docs-site): https://github.com/AJaySi/AI-Writer/blob/main/docs-site/docs/features/content-strategy/personas.md
+ - LinkedIn Grounded Content plan: https://github.com/AJaySi/AI-Writer/blob/main/frontend/docs/linkedin_factual_google_grounded_url_content.md
+
+At a glance:
+- Data β Persona: Onboarding + website analysis β core persona
+- Platform adaptations: Platform-specific JSON with validations/optimizations
+- Usage: Informs tone, content length, structure, and platform best practices
+
+---
+
+### Community
+- **Docs & Wiki**: https://github.com/AJaySi/AI-Writer/wiki
+- **Discussions**: https://github.com/AJaySi/AI-Writer/discussions
+- **Issues**: https://github.com/AJaySi/AI-Writer/issues
+- **Website**: https://www.alwrity.com
+
+---
+
+### License
+MIT β see [LICENSE](../LICENSE).
-
----
-
-## π― Target Audience & Use Cases
-
-### π’ **For Solopreneurs & Small Businesses**
-- **Content Strategy**: Professional marketing strategies without hiring agencies
-- **Time Savings**: Automate repetitive tasks and focus on core business
-- **Cost Efficiency**: Access enterprise-level tools at affordable prices
-- **Scalability**: Grow your digital presence as your business expands
-- **Blog Creation**: Complete AI-powered blog writing from research to publication
-
-### π **For Digital Marketers**
-- **Client Management**: Manage multiple client strategies efficiently
-- **Data-Driven Decisions**: AI-powered insights for better campaign performance
-- **Content Creation**: Generate high-quality content at scale
-- **Performance Optimization**: Continuous improvement through AI analytics
-- **SEO Optimization**: Comprehensive SEO analysis and metadata generation
-
-### π¨ **For Content Creators**
-- **Multi-Platform Content**: Create content optimized for different platforms
-- **Audience Growth**: AI-driven strategies for building engaged audiences
-- **Monetization**: Optimize content for maximum revenue potential
-- **Trend Analysis**: Stay ahead with AI-powered trend prediction
-- **Fact-Checking**: AI-powered content verification and quality assurance
-
----
-
-## π― **Start Creating Content Now**
-
-### **Complete Onboarding Process**
-1. **π§ Email Setup** - Enter your business email for AI analysis
-2. **π Persona Generation** - AI creates detailed buyer personas
-3. **π’ Business Info** - Provide comprehensive business details
-4. **π Competitor Analysis** - AI researches your competition
-5. **π Platform Integration** - Connect WordPress, Wix, GSC
-
-### **Immediate Content Creation**
-- β **LinkedIn Posts** with fact-checking and Google grounding
-- β **Blog Writing** with research and SEO optimization
-- β **Facebook Content** with platform-specific optimization
-- β **SEO Analysis** with metadata generation
-- β **Image Generation** with AI-powered visuals
-
-### **Publishing & Analytics**
-- **One-click publishing** to WordPress and Wix
-- **Real-time analytics** from Google Search Console
-- **Performance tracking** across all platforms
-- **Data-driven optimization** recommendations
-
----
-
-## π What Makes ALwrity Special?
-
-### π§ **AI-First Design**
-Unlike traditional tools, ALwrity uses AI to generate complete marketing strategies, not just individual pieces of content. This ensures every piece of content serves your overall business goals.
-
-### π― **Solopreneur-Focused**
-Built specifically for independent entrepreneurs who need enterprise-level marketing capabilities without the enterprise price tag or complexity.
-
-### π **Data-Driven Intelligence**
-Combines web research, competitor analysis, and predictive analytics to create strategies that actually work in the real world.
-
-### π **Continuous Optimization**
-ALwrity learns from your performance and continuously optimizes your strategy, ensuring long-term success and growth.
-
-### π **Multi-Modal Capabilities**
-Create text, images, audio, and video content from a single platform, maximizing your content's reach and impact.
-
-### π‘οΈ **Enterprise-Grade Security**
-Built with enterprise-level security, monitoring, and scalability in mind, ensuring your data and content are always protected.
-
----
-
-## πΊοΈ Development Roadmap 2025
-
-### **Q1 2025 (Current)**
-- β FastAPI backend architecture - COMPLETE
-- β AI content strategy generation - COMPLETE
-- β Multi-tenant authentication system - COMPLETE
-- β LinkedIn & Facebook content generation - COMPLETE
-- β Blog Writer with research and SEO - COMPLETE
-- β SEO analysis tools and metadata generation - COMPLETE
-- β AI image generation - COMPLETE
-- β Google Search Console integration - COMPLETE
-- β Hallucination detection and fact-checking - COMPLETE
-- β Subscription and billing system - COMPLETE
-- β React frontend development - COMPLETE
-- β End-to-end integration testing - COMPLETE
-
-### **Q2 2025 (Launch)**
-- π Advanced integrations and API ecosystem
-- π Performance optimization and scaling
-- π User experience enhancements
-- π Mobile application development
-- π Advanced analytics and reporting
-
-### **Q3 2025 (Expansion)**
-- π AI agent marketplace
-- π Advanced integrations ecosystem
-- π Enterprise features and white-label solutions
-- π Multi-language support
-- π Advanced workflow automation
-
----
-
-## π€ Contributing
-
-We welcome contributions from the community! Here's how you can help:
-
-### π **Report Issues**
-Found a bug? [Create an issue](https://github.com/AJaySi/AI-Writer/issues) with detailed information.
-
-### π‘ **Suggest Features**
-Have an idea? [Start a discussion](https://github.com/AJaySi/AI-Writer/discussions) to share your thoughts.
-
-### π§ **Contribute Code**
-1. Fork the repository
-2. Create a feature branch
-3. Make your changes
-4. Submit a pull request
-
-### π **Improve Documentation**
-Help us improve our documentation, tutorials, and guides.
-
-**π Contributing Guide**: [CONTRIBUTING.md](CONTRIBUTING.md)
-
----
-
-## π Community & Support
-
-
-
-## π Ready to Transform Your Digital Marketing?
-
-**β Star this repository to show your support!**
-
-**π― Current Status: Full Platform Operational with All Core Features**
-
-**[π Visit Website](https://www.alwrity.com)** β’ **[π Read Documentation](https://github.com/AJaySi/AI-Writer/wiki)** β’ **[π¬ Join Community](https://github.com/AJaySi/AI-Writer/discussions)**
-
----
-
-**Made with β€οΈ by the ALwrity Team**
-
-[Website](https://www.alwrity.com) β’ [Blog](https://www.alwrity.com/blog) β’ [Twitter](https://twitter.com/alwrity) β’ [LinkedIn](https://linkedin.com/company/alwrity)
-
-
-
----
-
-# ALwrity Community Health Files
-
-This directory contains community health files that help maintain a welcoming and productive environment for contributors to ALwrity.
-
-## π Files Overview
-
-### Core Community Files
-- **`CONTRIBUTING.md`** - Guidelines for contributing to ALwrity
-- **`CODE_OF_CONDUCT.md`** - Community standards and behavior expectations
-- **`SECURITY.md`** - Security policy and vulnerability reporting
-- **`SUPPORT.md`** - Help resources and troubleshooting guides
-- **`FUNDING.yml`** - Funding and sponsorship information
-
-### Issue Templates (`ISSUE_TEMPLATE/`)
-- **`bug_report.md`** - Template for reporting bugs
-- **`feature_request.md`** - Template for requesting new features
-- **`question.yml`** - Form for asking questions
-- **`config.yml`** - Issue template configuration
-
-### Pull Request Template
-- **`pull_request_template.md`** - Template for pull requests
-
-## π― Purpose
-
-These files help:
-- **Improve Project Visibility** - Better GitHub community profile score
-- **Enhance Contributor Experience** - Clear guidelines and expectations
-- **Streamline Issue Management** - Structured templates for better organization
-- **Maintain Quality** - Consistent PR reviews and code standards
-- **Build Community** - Welcoming environment for all contributors
-
-## π Community Profile Status
-
-With these files, ALwrity should achieve:
-- β **README** - Comprehensive project documentation
-- β **Contributing** - Clear contribution guidelines
-- β **Code of Conduct** - Community standards
-- β **License** - MIT License (in root directory)
-- β **Issue Templates** - Structured issue reporting
-- β **Pull Request Template** - Consistent PR format
-- β **Security Policy** - Vulnerability reporting process
-- β **Support** - Help resources and documentation
-
-## π Maintenance
-
-These files should be updated as the project evolves:
-- Review and update contribution guidelines quarterly
-- Update security policy when new features are added
-- Refresh issue templates based on common questions
-- Update support resources as new features are released
-
-## π Questions?
-
-If you have questions about these community health files:
-- Open an [issue](https://github.com/AJaySi/ALwrity/issues)
-- Start a [discussion](https://github.com/AJaySi/ALwrity/discussions)
-- Check the [main README](../README.md) for project overview
-
----
-
-**Thank you for contributing to ALwrity!** π
diff --git a/backend/api/story_writer/router.py b/backend/api/story_writer/router.py
index cabcc9f4..6fcf1b8e 100644
--- a/backend/api/story_writer/router.py
+++ b/backend/api/story_writer/router.py
@@ -696,15 +696,15 @@ async def generate_scene_audio(
audio_filename = result.get("audio_filename") or ""
audio_models.append(
- StoryAudioResult(
- scene_number=result.get("scene_number", 0),
- scene_title=result.get("scene_title", "Untitled"),
+ StoryAudioResult(
+ scene_number=result.get("scene_number", 0),
+ scene_title=result.get("scene_title", "Untitled"),
audio_filename=audio_filename,
audio_url=audio_url,
- provider=result.get("provider", "unknown"),
- file_size=result.get("file_size", 0),
- error=result.get("error")
- )
+ provider=result.get("provider", "unknown"),
+ file_size=result.get("file_size", 0),
+ error=result.get("error")
+ )
)
return StoryAudioGenerationResponse(
diff --git a/backend/services/llm_providers/main_text_generation.py b/backend/services/llm_providers/main_text_generation.py
index 01333265..2d7b76ae 100644
--- a/backend/services/llm_providers/main_text_generation.py
+++ b/backend/services/llm_providers/main_text_generation.py
@@ -438,6 +438,45 @@ def llm_text_gen(prompt: str, system_prompt: Optional[str] = None, json_struct:
current_tokens_before = 0
new_tokens = 0
+ # Determine tracked tokens (after any safety capping)
+ tracked_tokens_input = min(tokens_input, tokens_total)
+ tracked_tokens_output = max(tokens_total - tracked_tokens_input, 0)
+
+ # Calculate and persist cost for this call
+ try:
+ cost_info = pricing.calculate_api_cost(
+ provider=provider_enum,
+ model_name=model,
+ tokens_input=tracked_tokens_input,
+ tokens_output=tracked_tokens_output,
+ request_count=1
+ )
+ cost_total = cost_info.get('cost_total', 0.0) or 0.0
+ except Exception as cost_error:
+ cost_total = 0.0
+ logger.error(f"[llm_text_gen] β Failed to calculate API cost: {cost_error}", exc_info=True)
+
+ if cost_total > 0:
+ logger.debug(f"[llm_text_gen] π° Calculated cost for {provider_name}: ${cost_total:.6f}")
+ update_costs_query = text(f"""
+ UPDATE usage_summaries
+ SET {provider_name}_cost = COALESCE({provider_name}_cost, 0) + :cost,
+ total_cost = COALESCE(total_cost, 0) + :cost
+ WHERE user_id = :user_id AND billing_period = :period
+ """)
+ db_track.execute(update_costs_query, {
+ 'cost': cost_total,
+ 'user_id': user_id,
+ 'period': current_period
+ })
+
+ # Keep ORM object in sync for logging/debugging
+ current_provider_cost = getattr(summary, f"{provider_name}_cost", 0.0) or 0.0
+ setattr(summary, f"{provider_name}_cost", current_provider_cost + cost_total)
+ summary.total_cost = (summary.total_cost or 0.0) + cost_total
+ else:
+ logger.debug(f"[llm_text_gen] π° Cost calculation returned $0 for {provider_name} (tokens_input={tracked_tokens_input}, tokens_output={tracked_tokens_output})")
+
# Update totals using SQL UPDATE
old_total_calls = summary.total_calls or 0
old_total_tokens = summary.total_tokens or 0
@@ -717,6 +756,39 @@ def llm_text_gen(prompt: str, system_prompt: Optional[str] = None, json_struct:
current_tokens_before = 0
new_tokens = 0
+ # Determine tracked tokens after any safety capping
+ tracked_tokens_input = min(tokens_input, tokens_total)
+ tracked_tokens_output = max(tokens_total - tracked_tokens_input, 0)
+
+ # Calculate and persist cost for this fallback call
+ cost_total = 0.0
+ try:
+ cost_info = pricing.calculate_api_cost(
+ provider=provider_enum,
+ model_name=fallback_model,
+ tokens_input=tracked_tokens_input,
+ tokens_output=tracked_tokens_output,
+ request_count=1
+ )
+ cost_total = cost_info.get('cost_total', 0.0) or 0.0
+ except Exception as cost_error:
+ logger.error(f"[llm_text_gen] β Failed to calculate fallback cost: {cost_error}", exc_info=True)
+
+ if cost_total > 0:
+ update_costs_query = text(f"""
+ UPDATE usage_summaries
+ SET {provider_name}_cost = COALESCE({provider_name}_cost, 0) + :cost,
+ total_cost = COALESCE(total_cost, 0) + :cost
+ WHERE user_id = :user_id AND billing_period = :period
+ """)
+ db_track.execute(update_costs_query, {
+ 'cost': cost_total,
+ 'user_id': user_id,
+ 'period': current_period
+ })
+ setattr(summary, f"{provider_name}_cost", (getattr(summary, f"{provider_name}_cost", 0.0) or 0.0) + cost_total)
+ summary.total_cost = (summary.total_cost or 0.0) + cost_total
+
# Update totals (using potentially capped tokens_total from safety check)
summary.total_calls = (summary.total_calls or 0) + 1
summary.total_tokens = (summary.total_tokens or 0) + tokens_total
diff --git a/backend/services/story_writer/audio_generation_service.py b/backend/services/story_writer/audio_generation_service.py
index e75ec296..a627b8b2 100644
--- a/backend/services/story_writer/audio_generation_service.py
+++ b/backend/services/story_writer/audio_generation_service.py
@@ -72,11 +72,11 @@ class StoryAudioGenerationService:
logger.info(f"[StoryAudioGeneration] Generated audio using gTTS: {output_path}")
return True
- except ImportError:
- logger.error("[StoryAudioGeneration] gTTS not installed. Install with: pip install gtts")
+ except ImportError as e:
+ logger.error(f"[StoryAudioGeneration] gTTS not installed. ImportError: {e}. Install with: pip install gtts")
return False
except Exception as e:
- logger.error(f"[StoryAudioGeneration] Error generating audio with gTTS: {e}")
+ logger.error(f"[StoryAudioGeneration] Error generating audio with gTTS: {type(e).__name__}: {e}")
return False
def _generate_audio_pyttsx3(
diff --git a/backend/services/story_writer/video_generation_service.py b/backend/services/story_writer/video_generation_service.py
index 87c7883c..09f6b599 100644
--- a/backend/services/story_writer/video_generation_service.py
+++ b/backend/services/story_writer/video_generation_service.py
@@ -72,8 +72,40 @@ class StoryVideoGenerationService:
# Import MoviePy
try:
- from moviepy.editor import ImageClip, AudioFileClip, concatenate_videoclips, CompositeVideoClip
- except ImportError:
+ # MoviePy v2.x exposes classes at top-level (moviepy.ImageClip, etc)
+ from moviepy import ImageClip, AudioFileClip, concatenate_videoclips
+ except Exception as _imp_err:
+ # Detailed diagnostics to help users fix environment issues
+ try:
+ import sys as _sys
+ import platform as _platform
+ import importlib
+ mv = None
+ imv = None
+ ff_path = "unresolved"
+ try:
+ mv = importlib.import_module("moviepy")
+ except Exception:
+ pass
+ try:
+ imv = importlib.import_module("imageio")
+ except Exception:
+ pass
+ try:
+ import imageio_ffmpeg as _iff
+ ff_path = _iff.get_ffmpeg_exe()
+ except Exception:
+ pass
+ logger.error(
+ "[StoryVideoGeneration] MoviePy import failed. "
+ f"py={_sys.executable} plat={_platform.platform()} "
+ f"moviepy_ver={getattr(mv,'__version__', 'NA')} "
+ f"imageio_ver={getattr(imv,'__version__', 'NA')} "
+ f"ffmpeg_path={ff_path} err={_imp_err}"
+ )
+ except Exception:
+ # best-effort diagnostics
+ pass
logger.error("[StoryVideoGeneration] MoviePy not installed. Install with: pip install moviepy imageio imageio-ffmpeg")
raise RuntimeError("MoviePy is not installed. Please install it to generate videos.")
@@ -182,8 +214,38 @@ class StoryVideoGenerationService:
# Import MoviePy
try:
- from moviepy.editor import ImageClip, AudioFileClip, concatenate_videoclips, CompositeVideoClip
- except ImportError:
+ from moviepy import ImageClip, AudioFileClip, concatenate_videoclips
+ except Exception as _imp_err:
+ # Detailed diagnostics to help users fix environment issues
+ try:
+ import sys as _sys
+ import platform as _platform
+ import importlib
+ mv = None
+ imv = None
+ ff_path = "unresolved"
+ try:
+ mv = importlib.import_module("moviepy")
+ except Exception:
+ pass
+ try:
+ imv = importlib.import_module("imageio")
+ except Exception:
+ pass
+ try:
+ import imageio_ffmpeg as _iff
+ ff_path = _iff.get_ffmpeg_exe()
+ except Exception:
+ pass
+ logger.error(
+ "[StoryVideoGeneration] MoviePy import failed. "
+ f"py={_sys.executable} plat={_platform.platform()} "
+ f"moviepy_ver={getattr(mv,'__version__', 'NA')} "
+ f"imageio_ver={getattr(imv,'__version__', 'NA')} "
+ f"ffmpeg_path={ff_path} err={_imp_err}"
+ )
+ except Exception:
+ pass
logger.error("[StoryVideoGeneration] MoviePy not installed. Install with: pip install moviepy imageio imageio-ffmpeg")
raise RuntimeError("MoviePy is not installed. Please install it to generate videos.")
diff --git a/backend/story_audio/scene_1_Welcome_to_the_Fluffy_Cloud_Ki_13319994.mp3 b/backend/story_audio/scene_1_Welcome_to_the_Fluffy_Cloud_Ki_13319994.mp3
new file mode 100644
index 00000000..ebf162d3
Binary files /dev/null and b/backend/story_audio/scene_1_Welcome_to_the_Fluffy_Cloud_Ki_13319994.mp3 differ
diff --git a/backend/story_audio/scene_1_Welcome_to_the_Fluffy_Cloud_Ki_55129ff0.mp3 b/backend/story_audio/scene_1_Welcome_to_the_Fluffy_Cloud_Ki_55129ff0.mp3
new file mode 100644
index 00000000..e29fd563
Binary files /dev/null and b/backend/story_audio/scene_1_Welcome_to_the_Fluffy_Cloud_Ki_55129ff0.mp3 differ
diff --git a/backend/story_audio/scene_1_Welcome_to_the_Fluffy_Cloud_Ki_d3b0b210.mp3 b/backend/story_audio/scene_1_Welcome_to_the_Fluffy_Cloud_Ki_d3b0b210.mp3
new file mode 100644
index 00000000..ef2a0e44
Binary files /dev/null and b/backend/story_audio/scene_1_Welcome_to_the_Fluffy_Cloud_Ki_d3b0b210.mp3 differ
diff --git a/backend/story_audio/scene_2_Meeting_Spark_the_Silver_Spoon_0c28f687.mp3 b/backend/story_audio/scene_2_Meeting_Spark_the_Silver_Spoon_0c28f687.mp3
new file mode 100644
index 00000000..1008f5b9
Binary files /dev/null and b/backend/story_audio/scene_2_Meeting_Spark_the_Silver_Spoon_0c28f687.mp3 differ
diff --git a/backend/story_audio/scene_2_Meeting_Spark_the_Silver_Spoon_1799fd46.mp3 b/backend/story_audio/scene_2_Meeting_Spark_the_Silver_Spoon_1799fd46.mp3
new file mode 100644
index 00000000..94e16ea0
Binary files /dev/null and b/backend/story_audio/scene_2_Meeting_Spark_the_Silver_Spoon_1799fd46.mp3 differ
diff --git a/backend/story_audio/scene_2_Meeting_Spark_the_Silver_Spoon_fabc3240.mp3 b/backend/story_audio/scene_2_Meeting_Spark_the_Silver_Spoon_fabc3240.mp3
new file mode 100644
index 00000000..23cf51f9
Binary files /dev/null and b/backend/story_audio/scene_2_Meeting_Spark_the_Silver_Spoon_fabc3240.mp3 differ
diff --git a/backend/story_audio/scene_3_Gathering_Space_Dust_and_Wishe_09969868.mp3 b/backend/story_audio/scene_3_Gathering_Space_Dust_and_Wishe_09969868.mp3
new file mode 100644
index 00000000..bba1f913
Binary files /dev/null and b/backend/story_audio/scene_3_Gathering_Space_Dust_and_Wishe_09969868.mp3 differ
diff --git a/backend/story_audio/scene_3_Gathering_Space_Dust_and_Wishe_5cd380d8.mp3 b/backend/story_audio/scene_3_Gathering_Space_Dust_and_Wishe_5cd380d8.mp3
new file mode 100644
index 00000000..70250e3d
Binary files /dev/null and b/backend/story_audio/scene_3_Gathering_Space_Dust_and_Wishe_5cd380d8.mp3 differ
diff --git a/backend/story_audio/scene_3_Gathering_Space_Dust_and_Wishe_b8b724b5.mp3 b/backend/story_audio/scene_3_Gathering_Space_Dust_and_Wishe_b8b724b5.mp3
new file mode 100644
index 00000000..b16fdb30
Binary files /dev/null and b/backend/story_audio/scene_3_Gathering_Space_Dust_and_Wishe_b8b724b5.mp3 differ
diff --git a/backend/story_audio/scene_4_Gravity_s_Gentle_Pull_496a7494.mp3 b/backend/story_audio/scene_4_Gravity_s_Gentle_Pull_496a7494.mp3
new file mode 100644
index 00000000..160452ab
Binary files /dev/null and b/backend/story_audio/scene_4_Gravity_s_Gentle_Pull_496a7494.mp3 differ
diff --git a/backend/story_audio/scene_4_Gravity_s_Gentle_Pull_a1f7e80d.mp3 b/backend/story_audio/scene_4_Gravity_s_Gentle_Pull_a1f7e80d.mp3
new file mode 100644
index 00000000..d2717bca
Binary files /dev/null and b/backend/story_audio/scene_4_Gravity_s_Gentle_Pull_a1f7e80d.mp3 differ
diff --git a/backend/story_audio/scene_4_Gravity_s_Gentle_Pull_fdd8a3cb.mp3 b/backend/story_audio/scene_4_Gravity_s_Gentle_Pull_fdd8a3cb.mp3
new file mode 100644
index 00000000..7a5b3cfb
Binary files /dev/null and b/backend/story_audio/scene_4_Gravity_s_Gentle_Pull_fdd8a3cb.mp3 differ
diff --git a/backend/story_audio/scene_5_The_Mixture_Starts_to_Glow_2b8af534.mp3 b/backend/story_audio/scene_5_The_Mixture_Starts_to_Glow_2b8af534.mp3
new file mode 100644
index 00000000..c8ec9973
Binary files /dev/null and b/backend/story_audio/scene_5_The_Mixture_Starts_to_Glow_2b8af534.mp3 differ
diff --git a/backend/story_audio/scene_5_The_Mixture_Starts_to_Glow_9f01caba.mp3 b/backend/story_audio/scene_5_The_Mixture_Starts_to_Glow_9f01caba.mp3
new file mode 100644
index 00000000..a2e85c11
Binary files /dev/null and b/backend/story_audio/scene_5_The_Mixture_Starts_to_Glow_9f01caba.mp3 differ
diff --git a/backend/story_audio/scene_5_The_Mixture_Starts_to_Glow_d2df24ea.mp3 b/backend/story_audio/scene_5_The_Mixture_Starts_to_Glow_d2df24ea.mp3
new file mode 100644
index 00000000..f5fa5bfc
Binary files /dev/null and b/backend/story_audio/scene_5_The_Mixture_Starts_to_Glow_d2df24ea.mp3 differ
diff --git a/backend/story_audio/scene_6_The_Birth_of_a_New_Star_0ac0e570.mp3 b/backend/story_audio/scene_6_The_Birth_of_a_New_Star_0ac0e570.mp3
new file mode 100644
index 00000000..e49ec3f6
Binary files /dev/null and b/backend/story_audio/scene_6_The_Birth_of_a_New_Star_0ac0e570.mp3 differ
diff --git a/backend/story_audio/scene_6_The_Birth_of_a_New_Star_245475df.mp3 b/backend/story_audio/scene_6_The_Birth_of_a_New_Star_245475df.mp3
new file mode 100644
index 00000000..cd4f72db
Binary files /dev/null and b/backend/story_audio/scene_6_The_Birth_of_a_New_Star_245475df.mp3 differ
diff --git a/backend/story_audio/scene_6_The_Birth_of_a_New_Star_80b3f63a.mp3 b/backend/story_audio/scene_6_The_Birth_of_a_New_Star_80b3f63a.mp3
new file mode 100644
index 00000000..66429c91
Binary files /dev/null and b/backend/story_audio/scene_6_The_Birth_of_a_New_Star_80b3f63a.mp3 differ
diff --git a/backend/story_audio/scene_7_Celebration_and_Sweet_Goodbyes_570f4137.mp3 b/backend/story_audio/scene_7_Celebration_and_Sweet_Goodbyes_570f4137.mp3
new file mode 100644
index 00000000..21b60605
Binary files /dev/null and b/backend/story_audio/scene_7_Celebration_and_Sweet_Goodbyes_570f4137.mp3 differ
diff --git a/backend/story_audio/scene_7_Celebration_and_Sweet_Goodbyes_7638f4bd.mp3 b/backend/story_audio/scene_7_Celebration_and_Sweet_Goodbyes_7638f4bd.mp3
new file mode 100644
index 00000000..4b6eaee8
Binary files /dev/null and b/backend/story_audio/scene_7_Celebration_and_Sweet_Goodbyes_7638f4bd.mp3 differ
diff --git a/backend/story_audio/scene_7_Celebration_and_Sweet_Goodbyes_7740f62e.mp3 b/backend/story_audio/scene_7_Celebration_and_Sweet_Goodbyes_7740f62e.mp3
new file mode 100644
index 00000000..33e4f0d4
Binary files /dev/null and b/backend/story_audio/scene_7_Celebration_and_Sweet_Goodbyes_7740f62e.mp3 differ
diff --git a/docs-site/docs/assests/assistive-1.png b/docs-site/docs/assests/assistive-1.png
new file mode 100644
index 00000000..e7485d5b
Binary files /dev/null and b/docs-site/docs/assests/assistive-1.png differ
diff --git a/docs-site/docs/assests/assistive-2.png b/docs-site/docs/assests/assistive-2.png
new file mode 100644
index 00000000..11b9a9e0
Binary files /dev/null and b/docs-site/docs/assests/assistive-2.png differ
diff --git a/docs-site/docs/assests/hero-1.jpg b/docs-site/docs/assests/hero-1.jpg
new file mode 100644
index 00000000..91ec3957
Binary files /dev/null and b/docs-site/docs/assests/hero-1.jpg differ
diff --git a/docs-site/docs/assests/hero-2.png b/docs-site/docs/assests/hero-2.png
new file mode 100644
index 00000000..2f624568
Binary files /dev/null and b/docs-site/docs/assests/hero-2.png differ
diff --git a/docs-site/docs/assests/hero-3.png b/docs-site/docs/assests/hero-3.png
new file mode 100644
index 00000000..1054761b
Binary files /dev/null and b/docs-site/docs/assests/hero-3.png differ
diff --git a/docs-site/docs/features/ai/assistive-writing.md b/docs-site/docs/features/ai/assistive-writing.md
index 5d14a8e8..24505635 100644
--- a/docs-site/docs/features/ai/assistive-writing.md
+++ b/docs-site/docs/features/ai/assistive-writing.md
@@ -2,6 +2,13 @@
ALwrity's Assistive Writing feature revolutionizes content creation by providing AI-powered writing assistance that helps you create high-quality, engaging content with minimal effort. This intelligent writing companion understands context, maintains consistency, and adapts to your unique writing style.
+## Visuals
+
+
+
+
+
+
## What is Assistive Writing?
Assistive Writing is an AI-powered feature that provides real-time writing assistance, suggestions, and enhancements to help you create compelling content. It combines advanced natural language processing with contextual understanding to offer intelligent recommendations that improve your writing quality and efficiency.
diff --git a/docs-site/docs/features/ai/grounding-ui.md b/docs-site/docs/features/ai/grounding-ui.md
index 8324a35d..19e0747c 100644
--- a/docs-site/docs/features/ai/grounding-ui.md
+++ b/docs-site/docs/features/ai/grounding-ui.md
@@ -2,6 +2,12 @@
ALwrity's Grounding UI feature provides AI-powered content verification and fact-checking capabilities, ensuring your content is accurate, reliable, and trustworthy. This advanced feature helps maintain content credibility by grounding AI-generated content in verified information sources.
+## Visuals
+
+