.

frontend/app/browse/angles/page.tsx

@@ -7,6 +7,7 @@ import { Select } from "@/components/ui/Select";
 import { LoadingSpinner } from "@/components/ui/LoadingSpinner";
 import { getAllAngles } from "@/lib/api/endpoints";
 import type { AnglesResponse } from "@/types/api";
+import { InfoButton } from "@/components/ui/InfoButton";
 
 export default function AnglesPage() {
   const [angles, setAngles] = useState<AnglesResponse | null>(null);
@@ -79,9 +80,20 @@ export default function AnglesPage() {
         <div className="absolute inset-0 bg-grid-pattern opacity-5"></div>
         <div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 relative z-10">
           <div className="text-center animate-fade-in">
-            <h1 className="text-4xl md:text-5xl font-extrabold mb-4">
-              <span className="gradient-text">Angles</span>
-            </h1>
+            <div className="flex items-center justify-center gap-3 mb-4">
+              <h1 className="text-4xl md:text-5xl font-extrabold">
+                <span className="gradient-text">Angles</span>
+              </h1>
+              <InfoButton
+                title="What are Angles?"
+                content="Angles are the reason someone should care right now. They're the specific hooks or approaches that make your ad relevant and compelling to your target audience.
+
+Each angle targets a specific emotional trigger or pain point. The same product can have multiple angles - for example, insurance could use 'Save money' or 'Protect your family' as different angles.
+
+Browse through all available angles to find ones that resonate with your target audience. You can use these in the Matrix flow to create targeted ads."
+                position="bottom"
+              />
+            </div>
             <p className="text-lg text-gray-600">
               Browse all {angles.total_angles} available angles
             </p>

frontend/app/browse/concepts/page.tsx

@@ -7,6 +7,7 @@ import { Select } from "@/components/ui/Select";
 import { LoadingSpinner } from "@/components/ui/LoadingSpinner";
 import { getAllConcepts } from "@/lib/api/endpoints";
 import type { ConceptsResponse } from "@/types/api";
+import { InfoButton } from "@/components/ui/InfoButton";
 
 export default function ConceptsPage() {
   const [concepts, setConcepts] = useState<ConceptsResponse | null>(null);
@@ -79,9 +80,26 @@ export default function ConceptsPage() {
         <div className="absolute inset-0 bg-grid-pattern opacity-5"></div>
         <div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 relative z-10">
           <div className="text-center animate-fade-in">
-            <h1 className="text-4xl md:text-5xl font-extrabold mb-4">
-              <span className="gradient-text">Concepts</span>
-            </h1>
+            <div className="flex items-center justify-center gap-3 mb-4">
+              <h1 className="text-4xl md:text-5xl font-extrabold">
+                <span className="gradient-text">Concepts</span>
+              </h1>
+              <InfoButton
+                title="What are Concepts?"
+                content="Concepts are the creative execution styles or storylines you use to deliver your angle. They define how your ad will look and feel visually.
+
+Examples include:
+- Before/After comparisons
+- Testimonials and reviews
+- Problem/Solution narratives
+- Visual metaphors
+- Lifestyle imagery
+- UGC (User Generated Content) style
+
+Each concept has a specific structure and visual direction. When combined with an angle in the Matrix flow, they create powerful ads that both hook attention and drive action. Browse through all available concepts to find ones that match your creative vision."
+                position="bottom"
+              />
+            </div>
             <p className="text-lg text-gray-600">
               Browse all {concepts.total_concepts} available concepts
             </p>

frontend/app/creative/modify/page.tsx

@@ -18,6 +18,7 @@ import type {
   ModifiedImageResult,
   ImageCorrectResponse,
 } from "@/types/api";
+import { InfoButton } from "@/components/ui/InfoButton";
 
 type WorkflowStep = "upload" | "analysis" | "modify" | "result";
 
@@ -213,9 +214,33 @@ export default function CreativeModifyPage() {
       <div className="container mx-auto px-4 py-8">
         {/* Header */}
         <div className="text-center mb-8">
-          <h1 className="text-3xl font-bold text-gray-900 mb-2">
-            Creative Modifier
-          </h1>
+          <div className="flex items-center justify-center gap-3 mb-2">
+            <h1 className="text-3xl font-bold text-gray-900">
+              Creative Modifier
+            </h1>
+            <InfoButton
+              title="Creative Modification Flow"
+              content="This flow allows you to modify existing ad creatives:
+
+1. UPLOAD: Upload an existing ad image (from URL or file)
+
+2. ANALYSIS: AI analyzes your creative to understand:
+   - Current angle and concept
+   - Visual elements and composition
+   - Copy elements and messaging
+   - Overall strategy
+
+3. MODIFY: Apply new angles or concepts to create variations:
+   - Modify: Change angle/concept while keeping similar structure
+   - Regenerate: Create completely new version
+   - Custom: Use your own prompt for specific changes
+
+4. RESULT: Get your modified creative with new image and updated copy
+
+Perfect for iterating on winning ads or testing new angles with proven visuals."
+              position="bottom"
+            />
+          </div>
           <p className="text-gray-600 max-w-2xl mx-auto">
             Upload your existing creative, let AI analyze it, then apply new
             angles or concepts to generate variations

frontend/app/generate/page.tsx

@@ -727,6 +727,7 @@ export default function GeneratePage() {
             </p>
             
             {/* Mode Toggle */}
+            <div className="flex flex-col items-center gap-3">
             <div className="flex items-center justify-center gap-3 flex-wrap">
               <button
                 onClick={() => setMode("standard")}
@@ -773,6 +774,7 @@ export default function GeneratePage() {
                 Batch
               </button>
             </div>
+            </div>
           </div>
         </div>
       </div>

frontend/app/globals.css

@@ -135,6 +135,21 @@ body {
   animation: scaleIn 0.3s ease-out;
 }
 
+@keyframes infoTooltipEnter {
+  from {
+    opacity: 0;
+    transform: scale(0.96);
+  }
+  to {
+    opacity: 1;
+    transform: scale(1);
+  }
+}
+
+.info-tooltip-enter {
+  animation: infoTooltipEnter 0.15s ease-out;
+}
+
 .animate-pulse-glow {
   animation: pulse-glow 2s ease-in-out infinite;
 }

frontend/app/matrix/page.tsx

@@ -5,6 +5,7 @@ import Link from "next/link";
 import { Card, CardContent, CardHeader, CardTitle, CardDescription } from "@/components/ui/Card";
 import { Button } from "@/components/ui/Button";
 import { Search, TestTube } from "lucide-react";
+import { InfoButton } from "@/components/ui/InfoButton";
 
 export default function MatrixPage() {
   return (
@@ -14,10 +15,29 @@ export default function MatrixPage() {
         <div className="absolute inset-0 bg-grid-pattern opacity-5"></div>
         <div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 relative z-10">
           <div className="text-center animate-fade-in">
-            <h1 className="text-4xl md:text-5xl font-extrabold mb-4">
-              <span className="gradient-text">Matrix</span>
-              <span className="text-gray-900"> System</span>
-            </h1>
+            <div className="flex items-center justify-center gap-3 mb-4">
+              <h1 className="text-4xl md:text-5xl font-extrabold">
+                <span className="gradient-text">Matrix</span>
+                <span className="text-gray-900"> System</span>
+              </h1>
+              <InfoButton
+                title="Matrix System Explained"
+                content="The Matrix System is a systematic approach to ad generation that combines Angles and Concepts.
+
+ANGLES: The reason someone should care right now. They target specific emotional triggers or pain points.
+
+CONCEPTS: The creative execution style - how your ad looks and feels visually.
+
+By combining different angles with different concepts, you create a matrix of possibilities. This systematic approach helps you:
+- Test multiple combinations efficiently
+- Find winning angle/concept pairs
+- Scale successful patterns
+- Avoid creative fatigue
+
+Use the Matrix flow in Generate to select specific combinations, or use the Testing Matrix Builder to create systematic test plans."
+                position="bottom"
+              />
+            </div>
             <p className="text-lg text-gray-600 max-w-2xl mx-auto">
               Explore the Angle × Concept matrix for systematic ad generation
             </p>

frontend/components/generation/BatchForm.tsx

@@ -10,6 +10,7 @@ import { Button } from "@/components/ui/Button";
 import { Card, CardContent, CardHeader, CardTitle, CardDescription } from "@/components/ui/Card";
 import { IMAGE_MODELS, getModelCost, formatCost } from "@/lib/constants/models";
 import type { Niche } from "@/types/api";
+import { InfoButton } from "@/components/ui/InfoButton";
 
 interface BatchFormProps {
   onSubmit: (data: { niche: Niche; count: number; images_per_ad: number; image_model?: string | null; target_audience?: string | null; offer?: string | null }) => Promise<void>;
@@ -44,7 +45,14 @@ export const BatchForm: React.FC<BatchFormProps> = ({
   return (
     <Card variant="glass">
       <CardHeader>
-        <CardTitle>Batch Generation</CardTitle>
+        <div className="flex items-center gap-2">
+          <CardTitle>Batch Generation</CardTitle>
+          <InfoButton
+            title="Batch Generation Flow"
+            content="Generate multiple ads simultaneously for A/B testing and variety. Each ad is created with randomized strategies, giving you diverse options to test. You can generate up to 100 ads with 1-3 variations per ad. Perfect for finding winning combinations through volume testing."
+            position="bottom"
+          />
+        </div>
         <CardDescription>
           Generate multiple ads at once for testing and variety
         </CardDescription>

frontend/components/generation/ExtensiveForm.tsx

@@ -8,6 +8,7 @@ import { Card, CardContent, CardHeader, CardTitle, CardDescription } from "@/com
 import { Select } from "@/components/ui/Select";
 import { IMAGE_MODELS, getModelCost, formatCost } from "@/lib/constants/models";
 import type { Niche } from "@/types/api";
+import { InfoButton } from "@/components/ui/InfoButton";
 
 const extensiveSchema = z.object({
   niche: z.enum(["home_insurance", "glp1", "auto_insurance", "others"]),
@@ -57,7 +58,7 @@ export const ExtensiveForm: React.FC<ExtensiveFormProps> = ({
   } = useForm<ExtensiveFormData>({
     resolver: zodResolver(extensiveSchema),
     defaultValues: {
-      niche: "home_insurance" as const,
+      niche: "home_insurance" as const, // first option; flow works for any niche
       custom_niche: "",
       target_audience: "",
       offer: "",
@@ -75,7 +76,24 @@ export const ExtensiveForm: React.FC<ExtensiveFormProps> = ({
   return (
     <Card variant="glass">
       <CardHeader>
-        <CardTitle>Extensive Generation</CardTitle>
+        <div className="flex items-center gap-2">
+          <CardTitle>Extensive Generation</CardTitle>
+          <InfoButton
+            title="Extensive Generation Flow"
+            content="This flow works for any niche (insurance, GLP-1, auto, or custom). It uses a 4-stage process:
+
+1. RESEARCHER: Analyzes your inputs and researches psychology triggers, angles, and concepts that work best for your niche and audience.
+
+2. CREATIVE DIRECTOR: Uses marketing knowledge and successful ad patterns to create multiple creative strategies. Each strategy includes visual direction, text placement, CTA, and copy ideas.
+
+3. DESIGNER: Converts each creative strategy into detailed image generation prompts optimized for affiliate marketing (authentic, low-production style).
+
+4. COPYWRITER: Writes compelling ad copy (title, body, description) that matches each strategy's emotional tone and psychology trigger.
+
+You can generate multiple strategies (1-10) and multiple variations per strategy (1-3) for comprehensive testing."
+            position="bottom"
+          />
+        </div>
         <CardDescription>
           Researcher → Creative Director → Designer → Copywriter flow
         </CardDescription>
@@ -133,7 +151,7 @@ export const ExtensiveForm: React.FC<ExtensiveFormProps> = ({
             <input
               type="text"
               className="w-full px-4 py-3 rounded-xl border-2 border-gray-300 bg-white/80 backdrop-blur-sm focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-blue-500 transition-all duration-250"
-              placeholder="e.g., Don't overpay your insurance"
+              placeholder="e.g., Free quote, Save $500/year, Limited-time offer"
               {...register("offer")}
             />
             {errors.offer && (

frontend/components/generation/GenerationForm.tsx

@@ -12,6 +12,7 @@ import { IMAGE_MODELS, getModelCost, formatCost } from "@/lib/constants/models";
 import type { Niche } from "@/types/api";
 import { Loader2, TrendingUp, Check } from "lucide-react";
 import apiClient from "@/lib/api/client";
+import { InfoButton } from "@/components/ui/InfoButton";
 
 interface GenerationFormProps {
   onSubmit: (data: { 
@@ -110,7 +111,14 @@ export const GenerationForm: React.FC<GenerationFormProps> = ({
   return (
     <Card variant="glass">
       <CardHeader>
-        <CardTitle>Generate Ad</CardTitle>
+        <div className="flex items-center gap-2">
+          <CardTitle>Generate Ad</CardTitle>
+          <InfoButton
+            title="Standard Generation Flow"
+            content="This flow generates ads using randomized strategies from predefined angles and concepts. It's the fastest way to create ads with minimal configuration. The system automatically selects the best combinations based on your niche, target audience, and offer."
+            position="bottom"
+          />
+        </div>
         <CardDescription>
           Create a new ad creative using randomized strategies
         </CardDescription>

frontend/components/matrix/AngleSelector.tsx

@@ -8,6 +8,7 @@ import { LoadingSpinner } from "@/components/ui/LoadingSpinner";
 import { getAllAngles } from "@/lib/api/endpoints";
 import { useMatrixStore } from "@/store/matrixStore";
 import type { AngleInfo, AnglesResponse } from "@/types/api";
+import { InfoButton } from "@/components/ui/InfoButton";
 
 interface AngleSelectorProps {
   onSelect?: (angle: AngleInfo) => void;
@@ -86,9 +87,20 @@ export const AngleSelector: React.FC<AngleSelectorProps> = ({
   return (
     <Card variant="glass" className="border-2 border-transparent hover:border-blue-200/50 transition-all duration-300">
       <CardHeader>
-        <CardTitle className="bg-gradient-to-r from-blue-600 to-cyan-600 bg-clip-text text-transparent">
-          Select Angle
-        </CardTitle>
+        <div className="flex items-center gap-2">
+          <CardTitle className="bg-gradient-to-r from-blue-600 to-cyan-600 bg-clip-text text-transparent">
+            Select Angle
+          </CardTitle>
+          <InfoButton
+            title="What is an Angle?"
+            content="An angle is the reason someone should care right now. It's the specific hook or approach that makes your ad relevant and compelling to your target audience. 
+
+The same product can have multiple angles - each targeting different emotional triggers or pain points. For example, 'Save money' vs 'Protect your family' are different angles for insurance.
+
+Selecting the right angle helps ensure your ad resonates with your audience and drives action."
+            position="bottom"
+          />
+        </div>
       </CardHeader>
       <CardContent className="space-y-4">
         <div className="grid grid-cols-1 md:grid-cols-2 gap-4">

frontend/components/matrix/ConceptSelector.tsx

@@ -8,6 +8,7 @@ import { LoadingSpinner } from "@/components/ui/LoadingSpinner";
 import { getAllConcepts, getCompatibleConcepts } from "@/lib/api/endpoints";
 import { useMatrixStore } from "@/store/matrixStore";
 import type { ConceptInfo, ConceptsResponse } from "@/types/api";
+import { InfoButton } from "@/components/ui/InfoButton";
 
 interface ConceptSelectorProps {
   onSelect?: (concept: ConceptInfo) => void;
@@ -148,9 +149,25 @@ export const ConceptSelector: React.FC<ConceptSelectorProps> = ({
   return (
     <Card variant="glass" className="border-2 border-transparent hover:border-cyan-200/50 transition-all duration-300">
       <CardHeader>
-        <CardTitle className="bg-gradient-to-r from-cyan-600 to-pink-600 bg-clip-text text-transparent">
-          Select Concept
-        </CardTitle>
+        <div className="flex items-center gap-2">
+          <CardTitle className="bg-gradient-to-r from-cyan-600 to-pink-600 bg-clip-text text-transparent">
+            Select Concept
+          </CardTitle>
+          <InfoButton
+            title="What is a Concept?"
+            content="A concept is the creative execution style or storyline you use to deliver your angle. It defines how your ad will look and feel visually.
+
+Concepts include things like:
+- Before/After comparisons
+- Testimonials
+- Problem/Solution narratives
+- Visual metaphors
+- Lifestyle imagery
+
+Each concept has a specific structure and visual direction. When combined with an angle, they create a powerful ad that both hooks attention and drives action. Some concepts work better with certain angles - use the 'Show compatible concepts only' option to see recommended pairings."
+            position="bottom"
+          />
+        </div>
         {angleKey && (
           <div className="mt-2">
             <label className="flex items-center space-x-2">

frontend/components/ui/InfoButton.tsx

@@ -0,0 +1,122 @@
+"use client";
+
+import React, { useState, useRef, useEffect } from "react";
+import { Info } from "lucide-react";
+import { cn } from "@/lib/utils/cn";
+
+interface InfoButtonProps {
+  content: string | React.ReactNode;
+  title?: string;
+  position?: "top" | "bottom" | "left" | "right";
+  className?: string;
+  /** Smaller, more subtle variant for inline use next to labels */
+  variant?: "default" | "subtle";
+}
+
+export const InfoButton: React.FC<InfoButtonProps> = ({
+  content,
+  title,
+  position = "top",
+  className = "",
+  variant = "subtle",
+}) => {
+  const [isOpen, setIsOpen] = useState(false);
+  const buttonRef = useRef<HTMLButtonElement>(null);
+  const tooltipRef = useRef<HTMLDivElement>(null);
+
+  useEffect(() => {
+    const handleClickOutside = (event: MouseEvent) => {
+      if (
+        tooltipRef.current &&
+        buttonRef.current &&
+        !tooltipRef.current.contains(event.target as Node) &&
+        !buttonRef.current.contains(event.target as Node)
+      ) {
+        setIsOpen(false);
+      }
+    };
+
+    if (isOpen) {
+      document.addEventListener("mousedown", handleClickOutside);
+    }
+
+    return () => {
+      document.removeEventListener("mousedown", handleClickOutside);
+    };
+  }, [isOpen]);
+
+  const positionClasses = {
+    top: "bottom-full left-1/2 -translate-x-1/2 mb-2",
+    bottom: "top-full left-1/2 -translate-x-1/2 mt-2",
+    left: "right-full top-1/2 -translate-y-1/2 mr-2",
+    right: "left-full top-1/2 -translate-y-1/2 ml-2",
+  };
+
+  const isBottom = position === "bottom";
+  const isTop = position === "top";
+
+  return (
+    <span className={cn("relative inline-flex", className)}>
+      <button
+        ref={buttonRef}
+        type="button"
+        onClick={(e) => {
+          e.preventDefault();
+          e.stopPropagation();
+          setIsOpen(!isOpen);
+        }}
+        className={cn(
+          "inline-flex items-center justify-center rounded-full transition-all duration-200 focus:outline-none focus:ring-2 focus:ring-blue-400/50 focus:ring-offset-1",
+          variant === "subtle"
+            ? "w-4 h-4 text-gray-400 hover:text-gray-600 hover:bg-gray-100"
+            : "w-5 h-5 bg-gray-100 text-gray-500 hover:bg-gray-200 hover:text-gray-700"
+        )}
+        aria-label="Show information"
+      >
+        <Info className="w-3 h-3" strokeWidth={2.25} />
+      </button>
+
+      {isOpen && (
+        <div
+          ref={tooltipRef}
+          className={cn(
+            "absolute z-[100] w-72 sm:w-80 max-w-[calc(100vw-2rem)]",
+            positionClasses[position]
+          )}
+        >
+          <div
+            className={cn(
+              "relative rounded-xl border border-gray-200/90 bg-white/95 shadow-lg backdrop-blur-sm",
+              "info-tooltip-enter"
+            )}
+          >
+            <div className="max-h-[70vh] overflow-y-auto rounded-xl p-4">
+              {title && (
+                <h3 className="text-sm font-semibold text-gray-900 mb-2 pr-6">
+                  {title}
+                </h3>
+              )}
+              <div className="text-sm leading-relaxed text-gray-600">
+                {typeof content === "string" ? (
+                  <p className="whitespace-pre-line">{content}</p>
+                ) : (
+                  content
+                )}
+              </div>
+            </div>
+            {/* Arrow */}
+            <div
+              className={cn(
+                "absolute w-2 h-2 rotate-45 border border-gray-200/90 bg-white/95",
+                isBottom && "top-0 left-1/2 -translate-x-1/2 -translate-y-px border-t-transparent border-l-transparent",
+                isTop && "bottom-0 left-1/2 -translate-x-1/2 translate-y-px border-b-transparent border-r-transparent",
+                position === "left" && "right-0 top-1/2 -translate-y-1/2 translate-x-px border-r-transparent border-b-transparent",
+                position === "right" && "left-0 top-1/2 -translate-y-1/2 -translate-x-px border-l-transparent border-t-transparent"
+              )}
+            />
+          </div>
+        </div>
+      )}
+    </span>
+  );
+}

main.py

@@ -1816,7 +1816,7 @@ async def motivator_generate_endpoint(
 class ExtensiveGenerateRequest(BaseModel):
     """Request for extensive generation."""
     niche: str = Field(
-        description="Target niche: home_insurance, glp1, or others"
+        description="Target niche: home_insurance, glp1, auto_insurance, or others (use custom_niche when others)"
     )
     custom_niche: Optional[str] = Field(
         default=None,

services/generator.py

@@ -2087,9 +2087,10 @@ CONCEPT: {concept.get('name', 'Custom Concept')}
     ) -> Dict[str, Any]:
         """
         Generate ad using extensive: researcher → creative director → designer → copywriter.
+        Works for any niche: home_insurance, glp1, auto_insurance, or custom (e.g. from 'others').
         
         Args:
-            niche: Target niche (home_insurance or glp1)
+            niche: Target niche (home_insurance, glp1, auto_insurance, or custom display name when 'others')
             target_audience: Optional target audience description
             offer: Optional offer to run
             num_images: Number of images to generate per strategy
@@ -2102,12 +2103,13 @@ CONCEPT: {concept.get('name', 'Custom Concept')}
         if not third_flow_available:
             raise ValueError("Extensive service not available")
         
-        # Map niche names
+        # Map known niche keys to display names; custom niches (e.g. from 'others') pass through as-is
         niche_map = {
             "home_insurance": "Home Insurance",
             "glp1": "GLP-1",
+            "auto_insurance": "Auto Insurance",
         }
-        niche_display = niche_map.get(niche, niche.title())
+        niche_display = niche_map.get(niche, niche.replace("_", " ").title())
         
         # Provide defaults if target_audience or offer are not provided
         if not target_audience:

services/third_flow.py

@@ -13,6 +13,7 @@ from pydantic import BaseModel
 # Add parent directory to path for imports
 sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
 
+from services.motivator import generate_motivators
 from openai import OpenAI
 from config import settings
 
@@ -44,6 +45,7 @@ class CreativeStrategies(BaseModel):
     titleIdeas: str
     captionIdeas: str
     bodyIdeas: str
+    motivators: list[str] | None = None
 
 
 class CreativeStrategiesOutput(BaseModel):
@@ -78,12 +80,12 @@ class ThirdFlowService:
     ) -> List[ImageAdEssentials]:
         """
         Research psychology triggers, angles, and concepts.
-        
+
         Args:
             target_audience: Target audience description
             offer: Offer to run
             niche: Niche category
-            
+
         Returns:
             List of ImageAdEssentials with psychology triggers, angles, and concepts
         """
@@ -94,14 +96,14 @@ class ThirdFlowService:
                     {
                         "type": "text",
                         "text": """You are the researcher for the affiliate marketing company which does research on trending angles, concepts and psychology triggers based on the user input.
-                        Affiliate marketing is a performance-based model where you promote someone else's product or service and earn a commission for each qualified action (click, lead, or sale).
-                        A psychology trigger is an emotional or cognitive stimulus that pushes someone toward action—clicking, signing up, or buying—before logic kicks in.
-                        An ad angle is the reason someone should care right now. Same product → different reasons to click → different angles.
-                        An ad concept is the creative execution style or storyline you use to deliver an angle.
-                        In affiliate marketing 'Low-production, realistic often outperform studio creatives' runs most.
-                        
-                        Keeping in mind all this, make sure you provide different angles and concepts we can try based on the psychology triggers for the image ads for the given input based on affiliate marketing.
-                        User will provide you the category on which he needs to run the ads, what is the offer he is providing and what is target audience."""
+                                Affiliate marketing is a performance-based model where you promote someone else's product or service and earn a commission for each qualified action (click, lead, or sale).
+                                A psychology trigger is an emotional or cognitive stimulus that pushes someone toward action—clicking, signing up, or buying—before logic kicks in.
+                                An ad angle is the reason someone should care right now. Same product → different reasons to click → different angles.
+                                An ad concept is the creative execution style or storyline you use to deliver an angle.
+                                In affiliate marketing 'Low-production, realistic often outperform studio creatives' runs most.
+
+                                Keeping in mind all this, make sure you provide different angles and concepts we can try based on the psychology triggers for the image ads for the given input based on affiliate marketing.
+                                User will provide you the category on which he needs to run the ads, what is the offer he is providing and what is target audience."""
                     }
                 ]
             },
@@ -111,23 +113,23 @@ class ThirdFlowService:
                     {
                         "type": "text",
                         "text": f"""Following are the inputs:
-                        Niche: {niche}
-                        Offer to run: {offer}
-                        Target Audience: {target_audience}
-                        
-                        Provide the different psychology triggers, angles and concept based on the given input."""
+                                Niche: {niche}
+                                Offer to run: {offer}
+                                Target Audience: {target_audience}
+
+                                Provide the different psychology triggers, angles and concept based on the given input."""
                     }
                 ]
             }
         ]
-        
+
         try:
             completion = self.client.beta.chat.completions.parse(
                 model=self.gpt_model,
                 messages=messages,
                 response_format=ImageAdEssentialsOutput,
             )
-            
+
             response = completion.choices[0].message
             if response.parsed:
                 return response.parsed.output
@@ -138,7 +140,41 @@ class ThirdFlowService:
         except Exception as e:
             print(f"Error in researcher: {e}")
             return []
-    
+
+    async def generate_motivators_for_strategy(
+        self,
+        strategy: CreativeStrategies,
+        niche: str,
+        target_audience: str | None,
+        offer: str | None,
+        count: int = 6,
+    ) -> list[str]:
+        angle_ctx = {
+            "name": strategy.angle,
+            "trigger": strategy.phsychologyTrigger,
+            "example": strategy.titleIdeas,
+        }
+        print(f"Generating angle {angle_ctx}")
+
+        concept_ctx = {
+            "name": strategy.concept,
+            "structure": strategy.visualDirection,
+            "visual": strategy.visualDirection,
+        }
+        print(f"Generating concept {concept_ctx}")
+
+        motivators = await generate_motivators(
+            niche=niche.lower().replace(" ", "_"),
+            angle=angle_ctx,
+            concept=concept_ctx,
+            target_audience=target_audience,
+            offer=offer,
+            count=count,
+        )
+        print(f"Generated motivators: {motivators}")
+
+        return motivators
+
     def retrieve_search(
         self,
         target_audience: str,
@@ -446,8 +482,8 @@ class ThirdFlowService:
         except Exception as e:
             print(f"Error in creative_director: {e}")
             return []
-    
-    def creative_designer(self, creative_strategy: CreativeStrategies, niche: str = "Home Insurance") -> str:
+
+    def creative_designer(self, creative_strategy: CreativeStrategies, niche: str = "Home Insurance",selected_motivator: str | None = None) -> str:
         """
         Generate image prompt from creative strategy.
         
@@ -474,37 +510,26 @@ PROPS TO INCLUDE: {', '.join(niche_guidance_data.get('props', []))}
 AVOID: {', '.join(niche_guidance_data.get('avoid', []))}
 COLOR PREFERENCE: {niche_guidance_data.get('color_preference', 'balanced')}
 
-CRITICAL: The image MUST be appropriate for {niche} niche. Ensure all visual elements match this niche category."""
-        elif niche_lower == "home_insurance":
-            niche_guidance = """
-NICHE-SPECIFIC REQUIREMENTS (Home Insurance):
-SUBJECTS TO INCLUDE: family in front of home, house exterior, homeowner looking confident, couple reviewing papers
-PROPS TO INCLUDE: insurance documents, house keys, tablet showing coverage, family photos
-AVOID: disasters, fire or floods, stressed expressions, dark settings
-COLOR PREFERENCE: trust
-
-CRITICAL: The image MUST show home insurance-related content. Show REAL American suburban homes, homeowners, and insurance-related elements."""
-        elif niche_lower == "glp1":
-            niche_guidance = """
-NICHE-SPECIFIC REQUIREMENTS (GLP-1):
-SUBJECTS TO INCLUDE: confident person smiling (age 30-50), active lifestyle scenes with adults, healthy meal preparation, doctor consultation
-PROPS TO INCLUDE: fitness equipment, healthy food, comfortable clothing
-AVOID: before/after weight comparisons, measuring tapes, scales prominently, needle close-ups, elderly people over 65, senior citizens, very old looking people, gray-haired elderly groups
-AGE GUIDANCE: Show people aged 30-50 primarily. DO NOT default to elderly/senior citizens. The target audience is middle-aged adults in their 30s-40s, NOT seniors or elderly people.
-COLOR PREFERENCE: health
-
-CRITICAL: The image MUST be appropriate for GLP-1/weight loss niche. Show lifestyle, health, and confidence-related content. People in images should look 30-50 years old, NOT elderly."""
+        CRITICAL: The image MUST be appropriate for {niche} niche.
+        """
         else:
             niche_guidance = f"""
-NICHE-SPECIFIC REQUIREMENTS ({niche}):
-CRITICAL: The image MUST be appropriate for {niche} niche."""
-        
+        NICHE-SPECIFIC REQUIREMENTS ({niche}):
+        CRITICAL: The image MUST be appropriate for {niche} niche.
+        """
+
+        motivator_block = (
+            f"\nCORE MOTIVATOR (emotional driver): {selected_motivator}\n"
+            if selected_motivator
+            else ""
+        )
+
         strategy_str = f"""Psychology Trigger: {creative_strategy.phsychologyTrigger}
         Angle: {creative_strategy.angle}
         Concept: {creative_strategy.concept}
-        Text: {creative_strategy.text.textToBeWrittern if creative_strategy.text.textToBeWrittern not in [None, 'None', 'NA'] else 'No text overlay'}
         CTA: {creative_strategy.cta}
         Visual Direction: {creative_strategy.visualDirection}
+        {motivator_block}
         """
         
         messages = [
@@ -614,8 +639,8 @@ CRITICAL: The image MUST be appropriate for {niche} niche."""
             prompt += " Authentic, relatable style - not overly polished or commercial."
         
         return prompt.strip()
-    
-    def copy_writer(self, creative_strategy: CreativeStrategies) -> CopyWriterOutput:
+
+    def copy_writer(self, creative_strategy: CreativeStrategies,selected_motivator: str | None = None) -> CopyWriterOutput:
         """
         Generate ad copy from creative strategy.
         
@@ -625,13 +650,18 @@ CRITICAL: The image MUST be appropriate for {niche} niche."""
         Returns:
             CopyWriterOutput with title, body, and description
         """
+
+        motivator_block = (
+            f"\nCORE MOTIVATOR (customer’s internal voice): {selected_motivator}\n"
+            if selected_motivator
+            else ""
+        )
+
         strategy_str = f"""Psychology Trigger: {creative_strategy.phsychologyTrigger}
         Angle: {creative_strategy.angle}
         Concept: {creative_strategy.concept}
         CTA: {creative_strategy.cta}
-        Title Ideas: {creative_strategy.titleIdeas}
-        Caption Ideas: {creative_strategy.captionIdeas}
-        Body Ideas: {creative_strategy.bodyIdeas}
+        {motivator_block}
         """
         
         messages = [
@@ -710,7 +740,8 @@ CRITICAL: The image MUST be appropriate for {niche} niche."""
     def process_strategy(
         self,
         creative_strategy: CreativeStrategies,
-        niche: str = "Home Insurance"
+        niche: str = "Home Insurance",
+        selected_motivator: str | None = None,
     ) -> tuple[str, str, str, str]:
         """
         Process a single creative strategy to generate prompt and copy.
@@ -722,8 +753,9 @@ CRITICAL: The image MUST be appropriate for {niche} niche."""
         Returns:
             Tuple of (prompt, title, body, description)
         """
-        prompt = self.creative_designer(creative_strategy, niche=niche)
-        ad_copy = self.copy_writer(creative_strategy)
+        prompt = self.creative_designer(creative_strategy,niche=niche,selected_motivator=selected_motivator)
+        ad_copy = self.copy_writer(creative_strategy,selected_motivator=selected_motivator)
+
         return (
             prompt,
             ad_copy.title,
@@ -734,3 +766,58 @@ CRITICAL: The image MUST be appropriate for {niche} niche."""
 
 # Global service instance
 third_flow_service = ThirdFlowService()
+
+if __name__ == "__main__":
+    import asyncio
+
+    # ---- MOCK STRATEGY FOR TESTING ----
+    test_strategy = CreativeStrategies(
+        phsychologyTrigger="Fear of unexpected financial loss",
+        angle="Your home could cost you thousands tomorrow",
+        concept="Before vs After comparison",
+        text=Text(
+            textToBeWrittern="One small issue can turn into a massive repair bill.",
+            color="white",
+            placement="top"
+        ),
+        cta="Check your coverage now",
+        visualDirection="Split image: damaged home vs peaceful protected home",
+        titleIdeas="This mistake costs homeowners $12,000",
+        captionIdeas="Most homeowners don’t realize this until it’s too late",
+        bodyIdeas="A real homeowner story about unexpected damage",
+    )
+
+    async def run_test():
+        print("\n========== TEST: GENERATE MOTIVATORS ==========\n")
+        motivators = await third_flow_service.generate_motivators_for_strategy(
+            strategy=test_strategy,
+            niche="home_insurance",
+            target_audience="US homeowners 35–65",
+            offer="Free home insurance quote",
+        )
+
+        print(motivators)
+
+        selected_motivator = motivators[0] if motivators else None
+
+        print("\n========== TEST: PROCESS STRATEGY ==========\n")
+        prompt, title, body, description = third_flow_service.process_strategy(
+            creative_strategy=test_strategy,
+            niche="Home Insurance",
+            selected_motivator=selected_motivator,
+        )
+
+        print("\n--- IMAGE PROMPT ---\n")
+        print(prompt)
+
+        print("\n--- TITLE ---\n")
+        print(title)
+
+        print("\n--- BODY  ---\n")
+        print(body)
+
+        print("\n--- DESCRIPTION ---\n")
+        print(description)
+
+    asyncio.run(run_test())
+