Skip to content

SL177Y-0/Plot-spot-builder

Repository files navigation

PlotSpot

A production-ready platform that finds buildable backyard space on residential parcels using geospatial analysis. Built for property developers, assessors, and real estate professionals who need to quickly identify ADU and small home opportunities.

What it does

  • Search cities or draw areas to find parcels with buildable backyard space
  • Analyze parcels through staged filters (attributes → geometry → optional CV/LLM)
  • Calculate buildable area, check zoning rules, detect obstacles, test unit fit
  • Present results on interactive maps with exports (CSV/GeoJSON/PDF)

Tech Stack

  • Frontend: Next.js 14, Tailwind, MapLibre GL, NextAuth
  • Backend: FastAPI, PostgreSQL + PostGIS, SQLAlchemy/GeoAlchemy2
  • Infrastructure: Terraform (AWS) or low-cost (Render + Netlify + Supabase)
  • Shared: TypeScript package with types, utilities, and API client

Quick Start

# 1. Clone and setup
git clone <repo>
cd plotspot
cp apps/web/.env.local.example apps/web/.env.local
cp apps/api/.env.example apps/api/.env

# 2. Start services
docker-compose up -d

# 3. Access
# Web: http://localhost:3000
# API: http://localhost:8000/docs

Architecture

apps/
  api/   # FastAPI geoprocessing API
  web/   # Next.js frontend
packages/
  providers/  # Switchable providers (S3/SQS/KMS, Supabase/pg-boss)
  shared/     # Shared TS types, utils, API client
infra/        # Terraform for AWS
supabase/     # SQL migrations for low-cost stack
docs/         # Documentation

Key Features

  • Multi-tenant auth (SSO with Google/Azure)
  • Row-level security for data isolation
  • Staged search pipeline with background jobs
  • Zoning rule parsing (rules engine + optional LLM)
  • Geoprocessing: setbacks, backyard extraction, obstacle detection, fit testing
  • Export pipeline: CSV, GeoJSON, PDF

Deployment

  • Low-cost: Supabase (DB) + Render (API) + Netlify (web) - see docs/DEPLOYMENT.md
  • AWS: Terraform modules in infra/ - see infra/README.md
  • Provider switching: Change env vars to switch between stacks

Documentation

  • docs/ULTIMATE_GUIDE.md - Complete project reference
  • docs/ARCHITECTURE.md - System architecture
  • docs/DEPLOYMENT.md - Deployment guide

License

MIT


Built for practical, large-scale property assessment workflows.

About

A production-ready platform that finds buildable backyard space on residential parcels using geospatial analysis. Built for property developers, assessors, and real estate professionals who need to quickly identify ADU and small home opportunities.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors