sh4dcnv2 · atlas
← libraries

@terrae

A shadcn/ui companion library of composable, animated map components for React built on Mapbox GL JS and MapLibre GL, TypeScript, and Tailwind CSS. Components cover basic-map, markers, animated markers, circles, circle clusters, polygons, lines, animated lines, radial lines, heatmaps, popups, radar, choropleth, compare/comparison, minimap, compass, controls, camera-follow, raster video, and dramatic particle effects (fire, lightning, rain, explosion, cyclone, meteor). Offers hooks and an API reference. Free and open source (MIT). Use for: any React/Next.js app that needs declarative, shadcn-integrated interactive maps with rich visual effects and animated data layers.

40 components react shadcn-cli MIT

Install this registry

shadcn (npm) npx shadcn@latest add https://www.terrae.dev/registry.json
pnpm pnpm dlx shadcn@latest add https://www.terrae.dev/registry.json
bun bunx shadcn@latest add https://www.terrae.dev/registry.json
fetch registry curl -s https://www.terrae.dev/registry.json

Components

40 total
Map ui

Core map component with Mapbox GL and MapLibre GL support.

npx shadcn@latest add https://www.terrae.dev/map.json
Map Marker ui

Customizable map markers with popup support.

npx shadcn@latest add https://www.terrae.dev/marker.json
Map Popup ui

Info popups and tooltips for map locations.

npx shadcn@latest add https://www.terrae.dev/popup.json
Map Controls ui

Interactive map controls (zoom, fullscreen, etc).

npx shadcn@latest add https://www.terrae.dev/controls.json
Map Circle Cluster ui

Marker clustering with circle visualization.

npx shadcn@latest add https://www.terrae.dev/circle-cluster.json
Map Marker Animated ui

Animated marker that moves along a path with trail visualization.

npx shadcn@latest add https://www.terrae.dev/marker-animated.json
Map Line ui

Static routes and paths on the map.

npx shadcn@latest add https://www.terrae.dev/line.json
Map Line Animated ui

Animated path and route animations on the map.

npx shadcn@latest add https://www.terrae.dev/line-animated.json
Map Animated Pulse ui

Pulsing dot animation for map markers.

npx shadcn@latest add https://www.terrae.dev/animated-pulse.json
Map Rain ui

Animated rain effect layer.

npx shadcn@latest add https://www.terrae.dev/rain.json
Map Raster Video ui

Video overlay layers on the map.

npx shadcn@latest add https://www.terrae.dev/raster-video.json
Map Image ui

Image overlay layers on the map.

npx shadcn@latest add https://www.terrae.dev/image.json
Map Mini Map ui

Minimap overview navigation component.

npx shadcn@latest add https://www.terrae.dev/mini-map.json
Map Compare ui

Side-by-side map comparison component.

npx shadcn@latest add https://www.terrae.dev/compare.json
Map Sync ui

Synchronized multi-map component with bidirectional movement sync.

npx shadcn@latest add https://www.terrae.dev/sync.json
Map Arc Animated ui

Animated curved arc between two points for flights, deliveries, and connections.

npx shadcn@latest add https://www.terrae.dev/arc-animated.json
Map Camera Follow ui

Animate camera along a path for immersive fly-through experiences.

npx shadcn@latest add https://www.terrae.dev/camera-follow.json
Map Circle ui

Draggable geographic circle with customizable fill and stroke.

npx shadcn@latest add https://www.terrae.dev/circle.json
Map Animated Circle ui

Animated circle with drawing and fill effects.

npx shadcn@latest add https://www.terrae.dev/animated-circle.json
Map Blur Area ui

Blur sensitive areas on the map with customizable styling.

npx shadcn@latest add https://www.terrae.dev/blur-area.json
Map Targeting Reticle ui

Military-style targeting brackets with tracking and lock-on capabilities.

npx shadcn@latest add https://www.terrae.dev/targeting-reticle.json
Map Radar ui

Animated radar sweep signal overlay on map coordinates.

npx shadcn@latest add https://www.terrae.dev/radar.json
Map Watermark ui

Text watermark overlay for maps with configurable position and styling.

npx shadcn@latest add https://www.terrae.dev/watermark.json
Map Compass ui

Interactive compass overlay with bearing display and click-to-reset.

npx shadcn@latest add https://www.terrae.dev/compass.json
Map Line Radial ui

Radial lines from a center point to multiple destinations with optional markers.

npx shadcn@latest add https://www.terrae.dev/line-radial.json
Map Polygon ui

Geographic polygon with customizable fill and stroke styling.

npx shadcn@latest add https://www.terrae.dev/polygon.json
Map Animated Polygon ui

Animated polygon with draw, fill, and draw-then-fill effects.

npx shadcn@latest add https://www.terrae.dev/animated-polygon.json
Map Choropleth ui

Thematic choropleth map with color-coded regions based on data values.

npx shadcn@latest add https://www.terrae.dev/choropleth.json
Map Animated Footprint ui

Animated footprint steps that walk along a path on the map.

npx shadcn@latest add https://www.terrae.dev/animated-footprint.json
Map Fire ui

Realistic animated fire effect with particle simulation.

npx shadcn@latest add https://www.terrae.dev/fire.json
Map Explosion ui

Animated explosion burst effect with radial particles and flash.

npx shadcn@latest add https://www.terrae.dev/explosion.json
Map Cyclone ui

Animated cyclone funnel with swirling particles and debris.

npx shadcn@latest add https://www.terrae.dev/cyclone.json
Map Music Disc ui

Rotating music disc with floating notes animation.

npx shadcn@latest add https://www.terrae.dev/music-disc.json
Map Steam ui

Rising steam effect with wispy particle animation.

npx shadcn@latest add https://www.terrae.dev/steam.json
Map Tsunami ui

Animated tsunami wave effect with incoming wave, crashing foam, and debris.

npx shadcn@latest add https://www.terrae.dev/tsunami.json
Map Sandstorm ui

Atmospheric sandstorm effect with horizontal particle movement and reduced visibility.

npx shadcn@latest add https://www.terrae.dev/sandstorm.json
Map Snow ui

Falling snowflakes effect with gentle drift and wind.

npx shadcn@latest add https://www.terrae.dev/snow.json
Map Meteor ui

Animated meteor falling from sky with fiery trail and impact effect.

npx shadcn@latest add https://www.terrae.dev/meteor.json
Map Lightning ui

Animated lightning bolt strikes with branching and flash effects.

npx shadcn@latest add https://www.terrae.dev/lightning.json
Map Grid ui

Coordinate grid overlay with latitude/longitude lines and labels.

npx shadcn@latest add https://www.terrae.dev/grid.json