Skip to content

HectorTa1989/IdeaLens

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

💡 IdeaLens

AI-Powered Startup Idea Validation Platform

License: MIT React Vite


🚀 Overview

IdeaLens is a comprehensive AI-powered platform that helps founders validate their startup ideas through multi-dimensional analysis, competitive intelligence, and community feedback simulation. Stop building products nobody wants - validate first!

✨ Key Features

  • 🎯 Multi-Dimensional AI Analysis - Get scores across Market Validation, Problem-Solution Fit, Business Model, and Execution Difficulty
  • 🔍 Competitive Intelligence - AI-powered competitor analysis with market saturation meter
  • 🧪 Validation Experiments - Get 5 low-cost experiments to validate demand before building
  • ⚖️ Idea Comparison - Compare multiple ideas side-by-side with AI ranking
  • 👥 Community Feedback Simulator - See how developers, investors, and customers would react
  • 📊 Progressive Disclosure - Summary scores first, expand for details

🏗️ System Architecture

graph TB
    subgraph Client["🖥️ Frontend (React + Vite)"]
        UI[UI Components]
        Pages[Pages]
        State[Local Storage]
    end
    
    subgraph Services["⚙️ Services Layer"]
        Storage[Storage Service<br/>localStorage]
        AI[AI Service]
    end
    
    subgraph APIs["🌐 External APIs"]
        Gemini[Gemini API<br/>Primary]
        HF[HuggingFace API<br/>Fallback]
    end
    
    subgraph Payment["💳 Payment"]
        Polar[Polar.sh]
        Crypto[Crypto Wallets]
    end
    
    UI --> Pages
    Pages --> Services
    Storage <--> State
    AI --> Gemini
    AI --> HF
    Pages --> Polar
    Pages --> Crypto

    style Client fill:#1a1a2e,stroke:#8b5cf6
    style Services fill:#252542,stroke:#06b6d4
    style APIs fill:#2d2d4a,stroke:#22c55e
    style Payment fill:#1a1a2e,stroke:#f59e0b
Loading

🔄 Application Workflow

sequenceDiagram
    participant U as User
    participant F as Frontend
    participant S as Storage
    participant AI as AI Service
    participant G as Gemini API
    
    U->>F: Enter Idea Details
    F->>AI: Analyze Idea
    AI->>G: Multi-dimensional Analysis Prompt
    G-->>AI: Structured JSON Response
    AI-->>F: Analysis Results
    F->>F: Display Scores & Recommendations
    
    U->>F: Save Idea
    F->>S: Store to localStorage
    
    U->>F: Request Experiments
    F->>AI: Generate Experiments
    AI->>G: Experiment Generation Prompt
    G-->>AI: 5 Validation Experiments
    AI-->>F: Experiment List
    
    U->>F: Request Competitor Analysis
    F->>AI: Competitive Intelligence
    AI->>G: Market Analysis Prompt
    G-->>AI: Competitor Data
    AI-->>F: Display Competition Landscape
    
    U->>F: Request Persona Feedback
    F->>AI: Simulate Personas
    AI->>G: Developer/Investor/Customer Prompts
    G-->>AI: Persona Responses
    AI-->>F: Display Feedback
Loading

📁 Project Structure

IdeaLens/
├── 📄 index.html                    # Entry HTML
├── 📄 package.json                  # Dependencies
├── 📄 vite.config.js                # Vite config
├── 📄 README.md                     # This file
├── 📄 COMMIT_MESSAGES.md            # Commit messages
│
├── 📂 public/
│   └── 📄 favicon.svg               # App icon
│
└── 📂 src/
    ├── 📄 main.jsx                  # React entry
    ├── 📄 App.jsx                   # Main app + routing
    ├── 📄 index.css                 # Design system
    │
    ├── 📂 services/
    │   ├── 📄 storageService.js     # localStorage operations
    │   └── 📄 aiService.js          # Gemini + HuggingFace API
    │
    ├── 📂 components/
    │   ├── 📂 common/               # Reusable UI components
    │   │   ├── 📄 CircularProgress.jsx
    │   │   ├── 📄 ScoreCard.jsx
    │   │   ├── 📄 Button.jsx
    │   │   ├── 📄 Input.jsx
    │   │   ├── 📄 Modal.jsx
    │   │   └── 📄 index.js
    │   │
    │   ├── 📂 layout/               # Layout components
    │   │   ├── 📄 Header.jsx
    │   │   ├── 📄 Sidebar.jsx
    │   │   └── 📄 index.js
    │   │
    │   ├── 📂 ideas/                # Idea components
    │   │   ├── 📄 IdeaInputForm.jsx
    │   │   └── 📄 index.js
    │   │
    │   ├── 📂 analysis/             # Analysis components
    │   │   ├── 📄 AnalysisResults.jsx
    │   │   ├── 📄 CompetitiveIntelligence.jsx
    │   │   └── 📄 index.js
    │   │
    │   ├── 📂 experiments/          # Experiment components
    │   │   ├── 📄 ValidationExperiments.jsx
    │   │   └── 📄 index.js
    │   │
    │   ├── 📂 feedback/             # Feedback components
    │   │   ├── 📄 CommunityFeedback.jsx
    │   │   └── 📄 index.js
    │   │
    │   ├── 📂 comparison/           # Comparison components
    │   │   ├── 📄 IdeaComparison.jsx
    │   │   └── 📄 index.js
    │   │
    │   └── 📂 pricing/              # Pricing components
    │       ├── 📄 PricingPlans.jsx
    │       └── 📄 index.js
    │
    └── 📂 pages/                    # Page components
        ├── 📄 Dashboard.jsx
        ├── 📄 NewIdea.jsx
        ├── 📄 IdeaDetails.jsx
        ├── 📄 Compare.jsx
        ├── 📄 Experiments.jsx
        ├── 📄 Pricing.jsx
        ├── 📄 Settings.jsx
        └── 📄 index.js

🚀 Getting Started

Prerequisites

  • Node.js 18+
  • npm or yarn

Installation

# Clone the repository
git clone https://github.com/HectorTa1989/IdeaLens.git
cd IdeaLens

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

💳 Payment Integration

Polar.sh

Primary payment processing via Polar.sh.

Crypto Payments (10% Discount)

Currency Wallet Address
BTC 145U3n87FxXRC1nuDNDVXLZjyLzGhphf9Y
BSC (BNB/USDT) 0x23f0c8637de985b848b380aeba7b4cebbcfb2c47

🛠️ Technology Stack

  • Frontend: React 18, React Router v7
  • Build: Vite 6
  • Styling: Vanilla CSS with CSS Variables
  • Icons: Lucide React
  • AI: Gemini 2.0 Flash API (HuggingFace fallback)
  • Storage: localStorage
  • Payments: Polar.sh + Crypto

📄 License

MIT License - see LICENSE for details.


👤 Author

Hector Ta


Made with 💜 for founders who validate before they build

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors