Skip to content

Repository files navigation

CondoScore — Deal Analyzer

A 9-dimension scoring tool that helps buyers find the best condo deals. Search any U.S. market and get instant deal scores based on HOA burden, value gap, school quality, flood risk, and more.

Live App: condoscore.vercel.app

Screenshots

Light Mode

CondoScore Light Mode

Dark Mode

CondoScore Dark Mode

Features

  • 9-Dimension Scoring — Every listing scored 0–100 across HOA burden, price/sqft, total cost, value gap, school quality, building age, days on market, flood risk, and assessment risk
  • Market Overview — Median price, HOA, price/sqft, and days listed for your search area
  • Price Reduction History — See every price cut with dates, amounts, and total reduction percentage
  • Score Breakdowns — Expand any listing to see exactly how each dimension contributed to the score
  • School Ratings — GreatSchools ratings with individual school details
  • Flood Risk — FEMA zone and flood factor scores
  • Export to CSV — One-click download of all listing data
  • Dark Mode — Full light/dark theme support
  • Responsive Design — Works on desktop, tablet, and mobile

Score Labels

Score Label
80+ Great Deal
65–79 Good Deal
45–64 Fair
30–44 Overpriced
< 30 Avoid

One-Click Deploy

Deploy to Vercel (Recommended)

Deploy with Vercel

Deploy to Railway

Deploy on Railway

Deploy to Render

Deploy to Render

Quick Start

Prerequisites

  • Node.js 20.19+ (or 22.12+) — required by Vite 7
  • npm (comes with Node.js)

Install & Run

# Clone the repo
git clone https://github.com/bbuxton0823/condoscore.git
cd condoscore

# Install dependencies
npm install

# Start the development server
npm run dev

The app will be running at http://localhost:5000.

Production Build

# Build for production
npm run build

# Run the production server
NODE_ENV=production node dist/index.cjs

Typecheck & Tests

npm run check   # TypeScript typecheck
npm test        # Scoring engine tests

API Key Setup (Optional)

By default, CondoScore runs with demo data so you can explore the interface immediately.

To search real listings, add a RapidAPI key for the Realty in US API:

  1. Click the ⚙ Settings icon in the top-right corner
  2. Enter your RapidAPI key
  3. Click Save

Tech Stack

  • Frontend — React, Tailwind CSS, shadcn/ui
  • Backend — Express.js
  • Build — Vite
  • Language — TypeScript

Project Structure

condoscore/
├── client/src/
│   ├── pages/home.tsx      # Main app page with search, results, scoring
│   ├── components/ui/      # shadcn/ui components
│   └── lib/                # Query client, utilities
├── server/
│   ├── routes.ts           # API endpoints, scoring engine, demo data
│   ├── scoring.test.ts     # Scoring engine tests
│   └── storage.ts          # In-memory search cache
├── shared/
│   └── schema.ts           # TypeScript types and Zod schemas
├── api/
│   └── index.js            # Vercel serverless wrapper
└── screenshots/            # App screenshots

License

MIT

About

9-dimension condo deal scoring tool — HOA burden, value gap, flood risk, school quality & more. Export to CSV/Google Sheets.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages