Skip to content

toobutta/maptelli

Repository files navigation

Maptelli

Geospatial Intelligence Platform for Property Analysis and Territory Management

Maptelli is a geospatial intelligence platform that empowers real estate professionals, analysts, and businesses to make data-driven decisions through advanced mapping, property analytics, and territory management.

Features

  • Interactive Mapping - MapLibre GL JS with multiple layer support and Deck.gl overlays
  • Property Analytics - Comprehensive property data analysis and visualization
  • Territory Management - Draw, edit, and manage custom territories
  • Google Ads Integration - Sync audiences and territory data with Google Ads campaigns
  • Saved Searches - Save and manage complex property search criteria
  • AI Search - Natural language property search powered by LLM

Architecture

  • Frontend: Next.js 16 / React 19 / TypeScript / Tailwind CSS 4
  • Backend: Python FastAPI with async patterns
  • Database: PostgreSQL + PostGIS with SQLAlchemy ORM
  • Maps: MapLibre GL JS + Deck.gl
  • Cache: Redis with hiredis
  • Task Queue: Celery + Flower
  • Infrastructure: Docker Compose + Terraform

Quick Start

Prerequisites

  • Node.js 18+ and npm
  • Python 3.9+
  • PostgreSQL 14+ with PostGIS
  • Redis

Frontend

cd frontend
npm install
npm run dev

Backend

cd backend
pip install -r requirements.txt
uvicorn app.main:app --reload

Full Stack with Docker

docker-compose up -d

Project Structure

maptelli/
├── frontend/           # Next.js React application
├── backend/            # Python FastAPI backend
├── infrastructure/     # Terraform and Docker configs
└── docs/
    ├── roadmap/        # Product vision and Mintlify docs (future state)
    ├── planning/       # Development plans and implementation guides
    ├── integration/    # Third-party integration guides
    └── research/       # API research and platform analysis

Configuration

Environment variables:

  • DATABASE_URL - PostgreSQL connection string
  • REDIS_URL - Redis cache connection
  • GOOGLE_ADS_CLIENT_ID - Google Ads API credentials
  • SENDGRID_API_KEY - Email service credentials

Documentation

License

MIT License

Contact

andrew@maptelli.com

About

Maptelli - Advanced Geospatial Intelligence Platform for Property Analysis and Territory Management

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors