IdeaRank

The Professional AI-Powered Startup Analysis Engine

Founded by Tanay Mishra in 2026

🌐 Visit • 📦 GitHub

IdeaRank is a lightning-fast web application designed to help founders, product managers, and advisors evaluate startup ideas and problems using structured, deep AI analysis. It turns simple 1-sentence ideas into comprehensive business reports. The Platform is Not yet monetized, and is currently COMPLETELY FREE & UNLIMITED to use.

---

Features

Deep Idea Ranking Enter an idea and get a comprehensive scorecard (1-10) evaluating TAM/SAM/SOM, Competition, and Execution complexity.	Idea Improver (Pivots) Have a weak idea? The Idea Improver engine suggests realistic strategic pivots, complete with a 3-Phase Execution Roadmap.
Critical SWOT Analysis No fluff. Honest assessments of Strengths, Weaknesses, Opportunities, and Threats for any given concept.	Verified Sources The AI suggests real-world sources (like TechCrunch, Statista) to back up its market claims, promoting transparency.
Shareable Scorecards Download your analysis as a beautifully formatted image scorecard to share with co-founders or investors.	Mobile Optimized A responsive glassmorphism UI with bottom navigation, ensuring deep analysis is accessible on the go.

---

Tech Stack

IdeaRank is built to be lightweight, fast, and highly customizable.

• Frontend: HTML5, Vanilla JavaScript, CSS3 (Custom Design System with CSS variables and flex/grid).
• Backend: Node.js, Express.js.
• AI Engine: Groq SDK utilizing the llama-3.3-70b-versatile model for instant inferences.
• Utilities: html2canvas for scorecard generation.

---

Getting Started

Prerequisites

• Node.js (v16 or higher)
• A free API key from Groq Console

Installation

1. Clone the repository:

   git clone https://github.com/Byte-ne/IdeaRank.git
   cd IdeaRank

2. Install dependencies:

   npm install

3. Configure Environment Variables: Create a .env file in the root directory (you can use .env.example as a template):

   # Your primary Groq API Key
   GROQ_API_KEY=gsk_your_primary_key_here
   
   # Fallback API Key for rate limits (Optional but Recommended)
   GROQ_API_KEY_BACKUP=gsk_your_backup_key_here
   
   # Server Port
   PORT=3000

4. Run the application:

   npm start

   The server will start on http://localhost:3000.

---

Project Structure

IdeaRank/
├── public/                 # Static frontend files
│   ├── index.html          # Landing page
│   ├── dashboard.html      # Main analysis interface
│   ├── style.css           # Global custom UI styles
│   ├── script.js           # Frontend logic & API calls
│   └── logo.png            # Application branding
├── routes/                 # Express API routes
│   ├── ideaRank.js         # Endpoint for primary analysis
│   └── ideaImprove.js      # Endpoint for strategic pivot generation
├── services/               # Core business logic
│   └── aiService.js        # Groq API integration and prompt engineering
├── .env                    # Environment variables (gitignored)
├── server.js               # Node.js Express server setup
└── package.json            # Project dependencies & scripts

---

<<<<<<< HEAD

Deployment

=======

Current architecture

07754c324e54ccbd456eda2f51b299063a8466cf

IdeaRank is a simple, stateless web app: the browser sends your idea to a Node/Express API, which calls Groq (Llama 3.3) and returns the analysis. No database, no sign‑in, no data stored between requests.

• Client (Web UI)

  • Static HTML/CSS/JS served to the browser.
  • When you click “Analyze”, it sends an HTTP request (e.g. POST /analyze) with your idea text.

• Server (Node.js / Express)

  • API routes (like /analyze) receive the request, read and validate the idea text.
  • The route calls an internal AI service that:
    • Builds the prompt and payload.
    • Calls the Groq API with your idea.
    • Parses the response into a structured result (JSON/text sections).
  • The API then sends this result back to the browser as JSON or rendered HTML.

• AI (Groq / Llama 3.3)

  • The actual model runs on Groq’s cloud.
  • IdeaRank never stores your ideas; it just forwards them to Groq and returns the model’s reply.

• Infra & config

  • Hosted on a static+Node platform (e.g. Netlify or similar) that serves the UI and runs the Express server.
  • Secrets like GROQ_API_KEY are provided via environment variables (.env), not hard‑coded.

Mermaid diagram of the flow:

flowchart LR
  subgraph Client
    UI["Web UI (static HTML/CSS/JS)"]
  end

  subgraph Server["Node.js / Express"]
    API["HTTP Routes (e.g. /analyze)"]
    SVC["AI Service (calls Groq API)"]
  end

  subgraph AI["Groq Cloud"]
    LLM["Llama 3.3 70B Versatile"]
  end

  subgraph Infra["Deployment & Config"]
    HOST["Netlify / Hosting (static + Node)"]
    ENV["Environment (.env with GROQ_API_KEY, etc.)"]
  end

  UI -->|"User submits idea text"| API
  API -->|"Forward prompt & params"| SVC
  SVC -->|"Request with idea text"| LLM
  LLM -->|"Analysis response"| SVC
  SVC -->|"Formatted result (JSON/HTML)"| API
  API -->|"Send analysis back"| UI

  HOST -->|"Serves UI + runs server"| Server
  ENV -->|"Provides secrets at runtime"| Server

Loading

---

<<<<<<< HEAD

Marketing & Growth

=======

Use cases

07754c324e54ccbd456eda2f51b299063a8466cf

• Quickly validate hackathon or weekend‑project ideas.
• Give founders a “reality check” on market, competition, and execution risk.
• Use inside a startup studio or accelerator to triage many ideas.
• Integrate as an internal tool for product teams exploring new bets.

---

Support

If IdeaRank helps you evaluate ideas or you find the code useful, please consider starring this repo.
Stars help others discover the project and motivate future improvements.

---

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

License

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