Startup Validator 🚀

An AI-powered MVP web application that enables startup founders, indie hackers, and student entrepreneurs to rapidly validate startup ideas in seconds.

By analyzing an idea across multiple dimensions—Market Sizing, Competitor Analysis, Ideal Customer Profile (ICP), SWOT Analysis, and Landing Page Copywriting—Startup Validator delivers structured, actionable market research feedback with instant PDF and Markdown exports.

---

✨ Features

• 💡 Instant Idea Validation: Submit a startup title and description to receive a comprehensive validation report in under 5 seconds.
• 📊 Viability Scorecard & Verdict: Get an executive score (1-100), verdict classification (Moderate Risk / High Viability), and key strategic takeaways.
• 📈 Market Sizing & Risk Analysis: Understand industry category trends, growth drivers, and potential market pitfalls.
• ⚔️ Competitor Analysis Matrix: Compare top direct and indirect competitors with name, website, summary, strengths, weaknesses, and pricing model.
• 🎯 Ideal Customer Profile (ICP): Target buyer persona, demographics, willingness to pay, pain points, and customer acquisition channels.
• 🛡️ Interactive SWOT Matrix: Detailed breakdown of Strengths, Weaknesses, Opportunities, and Threats.
• 📝 Landing Page Copy Generator: Automated headline, subheadline, call-to-action (CTA), and raw Markdown positioning copy.
• 📄 Multi-Format Export: Single-click downloads for formatted Markdown (.md) and native PDF (.pdf) reports via ReportLab.

---

🛠️ Architecture & Tech Stack

graph TD
    User([User / Browser]) --> NextJS[Next.js 14 Frontend]
    NextJS --> FastAPI[FastAPI Backend API]
    FastAPI --> Gemini[Google Gemini AI Engine]
    FastAPI --> SQLite[(SQLite Database)]
    FastAPI --> PDFGen[ReportLab PDF Service]
    FastAPI --> NextJS

Loading

• Frontend: Next.js 14 (App Router), TypeScript, Tailwind CSS, Lucide Icons
• Backend: FastAPI (Python 3.11), Pydantic v2, SQLModel
• Database: SQLite (startup_validator.db)
• AI Service: Google Gemini API (google-genai package) with structured fallback engine
• PDF Engine: ReportLab 5.0

---

🚀 Quick Start Guide

Prerequisites

• Node.js: v18.0 or higher
• Python: v3.10 or higher
• Git

1. Clone Repository

git clone https://github.com/Jayesh01323/StartupValidator.git
cd StartupValidator

2. Backend Setup

cd backend
python -m venv venv

# On Windows:
venv\Scripts\activate
# On Linux/macOS:
source venv/bin/activate

pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000

Backend API running at http://localhost:8000 (Interactive API docs at http://localhost:8000/docs)

3. Frontend Setup

In a new terminal window:

cd frontend
npm install
npm run dev

Open http://localhost:3000 in your browser.

---

📚 API Reference

Method	Endpoint	Description
GET	/	Health check endpoint
POST	/validate	Generate validation report for startup idea
GET	/report/{id}	Retrieve generated report by ID
GET	/reports	List all historical validation reports
GET	/report/{id}/export/markdown	Download report as .md file
GET	/report/{id}/export/pdf	Download report as .pdf file

Detailed API guides can be found in docs/API_DOCUMENTATION.md.

---

📂 Documentation

• 📖 Installation Guide
• 🔌 API Documentation
• ☁️ Deployment Guide (Vercel & Render setup)

---

📜 License

Distributed under the MIT License. See LICENSE for more information.