Skip to main content
NYC Permit Pulse is a live permit overlay for the isometric pixel-art map of New York City. View active DOB permits, filter by type and location, and explore the city’s building activity in real-time. NYC Permit Pulse

​
View the Live Site

The easiest way to explore NYC Permit Pulse is to visit the live deployment:

permitpulse.nyc

View live DOB permits overlaid on the isometric NYC map

​
What You’ll See

When you open the site, you’ll immediately see:

Interactive Map

Deep-zoom isometric pixel art of NYC with permit markers

Color-Coded Permits

Visual indicators by type: New Building, Demolition, General Construction, and more

Live Ticker

Recent permits cycling through — click to fly to location

Permit Details

Address, description, contractor, owner, cost, and filing info

​
Core Features

​
1. Explore the Map

  • Pan & Zoom: Click and drag to pan, scroll to zoom in/out
  • Neighborhood Labels: Labels adapt at three zoom levels (borough → major neighborhoods → all 197 NTAs)
  • Click Markers: Click any permit marker to view full details

​
2. Filter Permits

Use the sidebar controls to filter the view:
  • Time Range: 24h / 7d / 30d (most recent permits)
  • Permit Type: Filter by GC, PL, NB, DM, SOL, and more
  • Borough: Manhattan, Brooklyn, Queens, Bronx, Staten Island
Data Freshness: DOB NOW data lags approximately 24 hours. The “24h” filter queries 48 hours back to account for this.

​
3. View Permit Details

Click any marker to open the detail drawer showing:
  • Full address and neighborhood (NTA)
  • Permit type and job description
  • Contractor and owner information
  • Estimated cost (when available)
  • Filing and issuance dates
  • Job number and permit ID

​
4. Breakdown Chart

The sidebar chart shows the distribution of permit types for your current filter set, with the top 8 types by count.

​
Run Locally (Optional)

If you want to run NYC Permit Pulse on your machine for development or testing:
1

Clone the repository

git clone https://github.com/yourusername/isometric-permits
cd isometric-permits
2

Install dependencies

npm install
3

Start the development server

npm run dev
You should see output similar to:
VITE v7.3.1  ready in 342 ms

➜  Local:   http://localhost:5177/
➜  Network: use --host to expose
➜  press h + enter to show help
4

Open in browser

Navigate to http://localhost:5177 to view the app.
The development server runs on port 5177 (not the default 5173) as configured in vite.config.ts.

​
Next Steps

Installation Guide

Full local development setup and configuration

Architecture

How the map projection and data pipeline work

Data Sources

NYC Open Data APIs and Socrata endpoints

API Reference

Core functions and TypeScript interfaces

Build docs developers (and LLMs) love

Get started for freeTalk to us