gitwtfhub

wtf is monolith-terrain?

kaolti/monolith-terrain — explained in plain English

Analysis updated 2026-05-18

94JavaScriptAudience · developerComplexity · 2/5LicenseSetup · easy

TL;DR

An interactive browser based 3D map that renders real world or procedural terrain as a vintage topographic sheet with a sci fi control overlay.

Mindmap

mindmap
  root((repo))
    What it does
      Renders 3D terrain maps
      Loads real elevation data
      Generates procedural mountains
    Tech stack
      Three.js
      Vite
      JavaScript
    Use cases
      Explore real world elevation
      Take cinematic terrain tours
      Build procedural landscapes
    Audience
      Developers
      Creative coders
      Map enthusiasts
    Features
      Peak and basin markers
      Radar scan effect
      Tunable visual panels
    Deployment
      GitHub Pages
      Cloudflare via wrangler

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Explore real world elevation data for any location as an interactive 3D map.

REASON 2

Generate and tweak a procedural mountain landscape with live adjustable parameters.

REASON 3

Create a cinematic flyover tour between two points on a terrain map.

REASON 4

Deploy a customized version of the map to GitHub Pages or Cloudflare.

What's in the stack?

JavaScriptThree.jsVitelil-gui

How it stacks up

kaolti/monolith-terraincocktailpeanut/image-to-promptzeborg/kubekosh
Stars949395
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasymoderateeasy
Complexity2/53/53/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

No API keys needed, real elevation data is fetched from a public dataset for free.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

Monolith is an interactive 3D map you view in a web browser, styled to look like an old USGS topographic survey sheet combined with a sci fi heads up display. You can either load real elevation data for any place on Earth, or generate a procedural mountain range from scratch, and then explore it in three dimensions with contour lines, colored elevation tinting, a survey grid overlay, spot elevation markers, and clickable peak markers. Navigation is done by dragging to orbit around the terrain, scrolling to zoom, and right dragging to pan. Clicking a marked peak or basin flies the camera in and opens a small data panel about that spot, and clicking the close button returns you to where you were. There is also a cinematic tour mode where you pick a starting and ending point and the camera flies a smooth path between them, plus a radar scan effect that sweeps a wave across the terrain and visibly lifts the surface as it passes. When using real world data you choose a location by picking a preset or entering latitude and longitude, and you can adjust how much area is shown and how exaggerated the vertical relief looks. In procedural mode you get a seeded, tweakable mountain landscape with a hovering monolith and an excavated instrument basin, and every generation parameter can be adjusted live. The whole interface is broken into adjustable panels covering things like the map overlay coloring, surface material, camera depth of field, overall visual look, the heads up display styling, camera and tour motion, and performance settings such as render scale and shadow quality. Under the hood it is built with the Three.js graphics library for rendering, with the map styling injected into the standard shader. It uses the postprocessing library for depth of field, tone mapping, grain, and antialiasing, lil-gui for the parameter panel, and Vite as the build tool, all in plain JavaScript with no framework. Real world elevation comes from the publicly hosted Terrain Tiles dataset, which draws from sources including NASA's SRTM and USGS elevation data, and requires no API key. To run it locally you install dependencies and start the dev server with npm, and it can be built as a static site and deployed to GitHub Pages or Cloudflare. The project is released under the MIT license.

Yoink these prompts

Prompt 1
Help me run this Three.js terrain map project locally with npm install and npm run dev.
Prompt 2
Explain how to load real world elevation data for a specific latitude and longitude in this project.
Prompt 3
Show me how to set up a cinematic camera tour between two peaks in this terrain map.
Prompt 4
How do I deploy this project to Cloudflare using the included wrangler config?
Prompt 5
Explain how the procedural noise terrain generation works in this codebase.

Frequently asked questions

wtf is monolith-terrain?

An interactive browser based 3D map that renders real world or procedural terrain as a vintage topographic sheet with a sci fi control overlay.

What language is monolith-terrain written in?

Mainly JavaScript. The stack also includes JavaScript, Three.js, Vite.

What license does monolith-terrain use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is monolith-terrain to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is monolith-terrain for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.