Skip to content

Business idea validation tool with scoring system - Rails API + React

Notifications You must be signed in to change notification settings

timdunn22/idea-validator

Repository files navigation

Idea Validator

A startup idea validation framework that scores business ideas across 4 categories with weighted scoring and PDF report generation. Built with Rails 8 API + React 19 frontend.

Features

  • Structured Validation - Score ideas across Market, Problem, Solution, and Business viability
  • Weighted Scoring - 9 questions with category weights, normalized to 0-100 scale
  • Step-by-Step Wizard - Walk through validation questions one category at a time
  • PDF Reports - Generate downloadable validation reports with Prawn
  • Score Visualization - Category breakdown charts with Recharts
  • Multi-Idea Tracking - Validate and compare multiple ideas side by side

Validation Categories

Category Questions Example
Market 3 "How large is the TAM?"
Problem 3 "How severe is the problem?"
Solution 3 "How technically feasible?"
Business 1 "How clear is the revenue model?"

Tech Stack

Backend: Ruby on Rails 8.1, SQLite, Puma, JWT Auth, Prawn PDF

Frontend: React 19, Vite 7, Tailwind CSS 4, Recharts, React Router 6

Testing: RSpec, FactoryBot

API Endpoints

Method Endpoint Description
POST /auth/register Create account
POST /auth/login Get JWT token
GET /questions List validation questions
CRUD /ideas Idea management
GET /ideas/:id/pdf Download PDF report
POST /ideas/:id/responses Submit single response
POST /ideas/:id/responses/bulk Submit all responses

Setup

# Backend
cd /path/to/idea-validator
bundle install
rails db:create db:migrate db:seed
rails server -p 3001

# Frontend
cd frontend
npm install
npm run dev

Deploy

Backend deploys to Render (free tier), frontend to Vercel. Seeds validation questions on first deploy. See render.yaml for configuration.

License

MIT

About

Business idea validation tool with scoring system - Rails API + React

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors