This library is not production-ready yet. Developers should use it with caution and expect breaking changes.

Steam

Rising steam effect with wispy particle animation for map locations.

Installation

First, make sure you have the base map component installed:

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

Then install the steam component:

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

Intensity

Control the steam density with the intensity prop. Higher values create denser, more visible steam. Combine with size to create steam plumes of different scales.

Custom Colors

Customize the steam color with the color prop. Create white water vapor, yellowish sulfuric steam, or greenish toxic fumes.

Programmatic Control

Use the useSteamControl hook to start, stop, or adjust steam intensity programmatically.

Properties

PropertyTypeDefaultDescription
idstringauto-generatedUnique identifier for programmatic control via useSteamControl
coordinates[number, number]requiredSteam location as [longitude, latitude]
sizenumber100Steam plume size in pixels
intensitynumber1Steam density and opacity
particleCountnumber40Number of steam particles
colorstring#ffffffSteam color (hex)
driftnumber0.4Horizontal drift amount
riseSpeednumber1Vertical rise speed
autoStartbooleantrueStart animation on mount

Use Cases

Geothermal Activity

Display hot springs, geysers, and volcanic vents

Industrial Sites

Show factories, power plants, or cooling towers