compIQ

compIQ is a real estate comps SaaS for investors, agents, and home buyers. The goal is fast property comparison, value estimates, rent context, and report-ready output without spreadsheet work.

Current State

• Live frontend: https://frontend-liard-iota-35.vercel.app
• Backend and frontend are already split cleanly and wired for auth, pricing, and deployment.
• The April 1, 2026 target is rough draft, deployment ready, and payment ready.

Stack

• Backend: FastAPI, asyncpg, Neon Postgres, Stripe
• Frontend: React 19, Vite, Tailwind, React Query, Zustand, Clerk
• Infra: Render-style backend deployment, Vercel frontend, Makefile-driven local workflows

Repo Layout

• backend/: comps engine, API, migrations, seed scripts
• frontend/: app UI
• Makefile: local dev, migrations, build helpers
• render.yaml: deploy config

Run

make dev
make migrate
cd frontend && npm run build

Environment

• Frontend expects a Clerk publishable key in frontend/.env.local
• Backend expects DATABASE_URL, RENTCAST_API_KEY, STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET, STRIPE_PRICE_ID, and SITE_URL

Product Priorities

• Tighten the buyer workflow from address entry to report
• Improve the comp database and AI evaluation layer
• Finish deployment and payment polish

Target Timing

• Rough drafted, deployment ready, and payment ready by April 1, 2026