Skip to content

About

Explore Equal Earth with fluid rotation and vivid textures.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Equal Earth

Equal Earth — Interactive World Map

Rotate an Equal Earth world map to any center, explore the same view on a synchronized globe, and download your map as a transparent 4K PNG.

Open map ↗ · 한국어 · Report an issue

Build and deployment status WebGPU License: EUPL-1.2

Map styles

Natural Earth II, NASA Blue Marble, and Atlas in the same Balanced view

Choose your center and save a map

  1. Open the interactive map. Choose a continent or pole, enter coordinates, or drag to set the view.
  2. Select Natural Earth II, NASA Blue Marble, or Atlas. Turn on borders and place names if you want them in the image.
  3. Use the download button to save a transparent 4K PNG of the current map.

The Equal Earth projection preserves relative areas, making it useful for comparing the sizes of countries and continents. Shapes are still distorted, as on every flat world map. This project is an independent interactive viewer of that projection.

Features

  • Free rotation — drag, tilt, and roll the map around any point.
  • Synchronized globe — explore the same orientation in flat and spherical views.
  • Map styles — Natural Earth II, NASA Blue Marble, and Atlas, a country-colored map at 8192 × 4096 resolution.
  • Borders and names — toggle national boundaries and upright country/capital labels together on any map style.
  • Mouse, touch, and keyboard — rotate either view; zoom the flat map independently.

The interface follows your browser’s language preferences.

Requires a browser with WebGPU enabled.

Controls

Input Action
Drag / arrow keys Rotate the map and globe
Shift + drag / hold Q or E Roll; Shift + Q/E increases speed
Scroll / pinch / + or − Zoom the flat map
Two-finger gesture Rotate, twist, and zoom
0 / Home / double-click Reset the view
Globe layer button Toggle the graticule or current Earth texture

The interface supports mouse, touch, and keyboard controls.

  • Location & coordinates: use your location or enter latitude, longitude. Location permission is requested on click; your position is not saved.
  • Presets: return to Balanced or choose a continent or pole. Southern-hemisphere presets put the South Pole above the center. Switching preserves zoom.
  • Map details: toggle borders and country/capital names together. Labels stay upright; capitals appear as you zoom in.
  • PNG export: save the current map at 4K with a transparent background, including visible borders and names. Controls and the small globe are excluded.

Regenerate map assets with uv run --script tools/build_political_assets.py. See source details.

Development

Use Node.js 24 or later.

npm ci
npm run dev

Built with TypeScript, Vite, WebGPU, and gl-matrix.

Build and test

npm test
npm run build
npx playwright install chromium
npm run test:browser

Build output goes to dist/. Pushes to main deploy to GitHub Pages after tests pass; pull requests run checks only. See the deployment workflow.

Credits & license

Earth imagery: Natural Earth and NASA Blue Marble. Blue Marble uses the July 2004 composite.

Code and documentation: EUPL-1.2. External assets retain their original terms; see third-party notices and texture sources.

About

Explore Equal Earth with fluid rotation and vivid textures.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages