Niche Market Research Strategy Platform

An AI-powered SaaS platform for developing targeted market research strategies. Built with React, FastAPI, and Google Gemini AI.

Features

1. Niche Market Analysis

• AI-powered identification of high-potential niche markets
• Market size estimates and growth potential assessments
• Competitive intensity analysis
• Customer pain point identification

2. Customer Segment Analysis

• Demographic profiling of target segments
• Psychographic analysis (values, motivations, lifestyle)
• Market size estimation per segment
• Identification of key customer needs

3. Cultural Trends Analysis

• Identification of emerging cultural and consumer trends
• Impact assessment on consumer behavior
• Opportunity evaluation for each trend
• Time relevance classification

4. Unique Selling Points (USPs) Generation

• AI-generated differentiation strategies
• Niche-specific value propositions
• Competitive defensibility assessment
• Market relevance evaluation

5. Marketing Tactics Development

• Actionable, multi-channel marketing strategies
• Channel-specific recommendations (social media, content, events, partnerships, influencers)
• Target segment alignment
• Implementation timeline and engagement level predictions

6. Success Metrics Framework

• KPI definition across 5 categories:
  • Awareness (market visibility)
  • Engagement (customer interaction)
  • Conversion (customer acquisition)
  • Retention (customer loyalty)
  • Revenue (financial performance)
• Baseline and target settings for 3-month goals
• Measurement methodologies
• Review frequency recommendations

Tech Stack

Frontend

• React 19 with TypeScript
• Vite for development and building
• TailwindCSS for styling
• shadcn/ui component library (43 pre-installed components)
• react-hook-form + zod for form management
• recharts for data visualization

Backend

• FastAPI (Python 3.12+)
• Uvicorn ASGI server
• Pydantic for data validation
• Google Gemini AI via google-genai SDK

Database

• Session-only (no persistence) - data stored in React state

Setup & Installation

Prerequisites

• Python 3.12+
• Node.js/Bun
• Google Gemini API access (via Workshop connector)

Installation

# Install Python dependencies
uv sync

# Install Node dependencies
bun install

Running Locally

bash start.sh

This will:

1. Start Vite dev server on $APP_PORT (default: 3051)
2. Start FastAPI server on $APP_PORT + 100 (default: 3151)
3. Automatically proxy /api/* requests to FastAPI

API Endpoints

All endpoints require POST requests with JSON bodies.

POST /api/analyze-niches

Identifies potential niche markets.

Request:

{
  "company_name": "string",
  "industry": "string",
  "current_offerings": "string",
  "target_market_size": "string"
}

Response:

{
  "niches": [
    {
      "name": "string",
      "marketSize": "string",
      "painPoints": "string",
      "growthPotential": "High|Medium|Low",
      "competitiveIntensity": "High|Medium|Low"
    }
  ]
}

POST /api/segment-analysis

Analyzes customer segments within a niche.

Request:

{
  "company_name": "string",
  "industry": "string",
  "niche_description": "string"
}

Response:

{
  "segments": [
    {
      "name": "string",
      "demographics": "string",
      "psychographics": "string",
      "sizeEstimate": "string",
      "keyNeeds": "string"
    }
  ]
}

POST /api/cultural-trends

Identifies relevant cultural and market trends.

Request:

{
  "niche": "string",
  "industry": "string"
}

Response:

{
  "trends": [
    {
      "name": "string",
      "description": "string",
      "impactOnBehavior": "string",
      "opportunityLevel": "High|Medium|Low",
      "timeRelevance": "string"
    }
  ]
}

POST /api/unique-selling-points

Generates unique selling points for differentiation.

Request:

{
  "company_name": "string",
  "industry": "string",
  "niche_description": "string"
}

Response:

{
  "usps": [
    {
      "name": "string",
      "description": "string",
      "relevance": "string",
      "defensibility": "string"
    }
  ]
}

POST /api/marketing-tactics

Generates actionable marketing tactics.

Request:

{
  "company_name": "string",
  "target_segments": ["string"],
  "unique_features": ["string"]
}

Response:

{
  "tactics": [
    {
      "name": "string",
      "channel": "string",
      "description": "string",
      "targetSegments": "string",
      "engagementLevel": "High|Medium|Low",
      "timeline": 2
    }
  ]
}

POST /api/success-metrics

Generates KPIs and success metrics framework.

Request:

{
  "company_name": "string",
  "target_segments": ["string"],
  "unique_features": ["string"]
}

Response:

{
  "metrics": [
    {
      "name": "string",
      "category": "string",
      "baseline": "string",
      "target": "string",
      "measurementMethod": "string",
      "reviewFrequency": "string"
    }
  ]
}

Workflow

1. Input Company Information: Enter company name, industry, current offerings, and target market details
2. Niche Analysis: AI identifies 4-5 high-potential niche markets with growth potential and competitive analysis
3. Segment Analysis: AI profiles distinct customer segments within the chosen niche
4. Trend Analysis: AI identifies cultural and market trends influencing the niche
5. USP Generation: AI generates differentiation strategies based on segments and trends
6. Marketing Tactics: AI recommends specific, actionable marketing strategies across channels
7. Success Metrics: AI defines a comprehensive KPI framework with targets and measurement methods

Key Insights

AI-Driven Analysis

• Uses Google Gemini 3 Flash for fast, cost-effective AI analysis
• Generates contextual, market-specific insights
• Produces actionable, data-backed recommendations

Session-Based Architecture

• All data stored in React component state
• No backend persistence
• Perfect for quick analysis and strategy sessions
• Easy to extend with database integration

Extensibility

• RESTful API design for easy integration
• Modular component architecture
• TypeScript for type safety
• Can be easily adapted for mobile or desktop apps

Deployment

The app is built for Workshop deployment with automatic:

• Vite build optimization
• FastAPI containerization
• Environment variable injection for API keys
• Cloudflare proxy integration for public access

Build with:

bunx --bun vite build

Environment Variables

Required for production:

• GEMINI_WORKSHOP_API_KEY - Google Gemini API key
• GEMINI_WORKSHOP_BASE_URL - Workshop API endpoint

Project Structure

src/
  ├── App.tsx                          # Main application shell
  ├── main.tsx                         # React entry point
  ├── types.ts                         # TypeScript interfaces
  ├── index.css                        # Tailwind globals
  ├── components/
  │   ├── ResearchForm.tsx             # Initial company research form
  │   ├── NicheAnalysis.tsx            # Niche market display
  │   ├── SegmentAnalysis.tsx          # Customer segment display
  │   ├── TrendAnalysis.tsx            # Cultural trends display
  │   ├── USPGenerator.tsx             # Unique selling points
  │   ├── MarketingTactics.tsx         # Marketing strategy display
  │   ├── SuccessMetrics.tsx           # KPI framework display
  │   └── ui/                          # 43 shadcn/ui components
  └── lib/
      └── utils.ts                     # Utility functions

routes.py                               # FastAPI endpoints
app.py                                  # ASGI application
pyproject.toml                          # Python dependencies
package.json                            # Node dependencies
vite.config.ts                          # Vite configuration

Future Enhancements

• Database persistence (PostgreSQL/Neon)
• Export reports as PDF
• Collaborative analysis (multi-user)
• Custom prompt templates
• Historical analysis tracking
• Competitive intelligence integration
• Real-time market data integration
• Email report distribution
• Analytics dashboard for performance tracking

License

Internal use only