Eclipse Atlas is an interactive planning map for the solar eclipses visible across Spain in 2026, 2027 and 2028. It brings eclipse geometry, the western terrain horizon and atmospheric data into one bilingual interface while keeping each source of evidence separate.
- Explore the total eclipses of 12 August 2026 and 2 August 2027, and the annular eclipse of 26 January 2028.
- View regional layers for central-phase duration, shadow passage, maximum obscuration and solar altitude.
- Select a saved reference, click the map, enter coordinates or use your current location.
- Search a source-bound national catalogue of cities, named viewpoints, observatories and planetariums without treating them as ranked or endorsed viewing sites.
- Find any Spanish settlement or nomenclátor toponym by name through the live IGN/CNIG CartoCiudad geocoder, listed apart from the curated catalogue with its own attribution.
- Inspect local contact times, eclipse circumstances and the western terrain horizon.
- Follow eclipse day in a full-screen live mode: a countdown to each contact of the selected spot, a device clock checked against a network time stamp with its offset and states shown, and an app shell that keeps working after coverage drops.
- See the Sun and Moon against an elevation profile calculated from IGN/CNIG data, with optional calculated planet and bright-star positions near the selected view.
- Compare up to three locations without reducing astronomy, terrain and weather to a single score.
- Review August cloud climatology, event-day model forecasts when they become available, and the official AEMET municipal forecast for the 2026 eclipse day.
- Switch the base map between OpenStreetMap and the official IGN topographic map or PNOA aerial imagery.
- Share the selected event, location, comparison and map layer through the page URL.
- Use the application in English or Spanish on desktop, tablet and mobile.
Saved places are approximate planning references, not endorsed viewing venues. The map does not determine access, capacity, nearby obstacles or current local conditions.
Eclipse Atlas requires Node.js 22.13 or later and npm.
git clone https://github.com/jgorostegui/eclipse-atlas.git
cd eclipse-atlas
npm ci
npm run devOpen http://localhost:3000.
Build and preview the production application with:
npm run build
npm run previewRun the project checks:
npm run checkRun the functional browser tests after an interface change:
npm run test:uiThe CI workflow runs both commands before publishing the application to GitHub Pages.
Eclipse calculations, terrain, map layers and atmospheric context come from separately identified public sources. Their producers, licences, transformations and limitations are documented in SOURCES.md and the machine-readable source catalog.
Terrain data cannot account for every building, tree or temporary obstruction. Climate summaries are not forecasts, and forecasts do not change the eclipse geometry. Confirm field conditions, access and organizer information before travelling.
Read CONTRIBUTING.md before proposing a change. Changes to public data or scientific behaviour should include tests and provenance updates.
Report security issues according to SECURITY.md.
Eclipse Atlas source code is available under the MIT License. Public data keeps its source licence: the generated place catalogue contains GeoNames data under CC BY 4.0 and OpenStreetMap-derived data under ODbL 1.0; it is not relicensed as MIT. Full data licences, attribution and transformation details are in SOURCES.md and public/sources.json. Runtime dependency notices are listed in THIRD_PARTY_NOTICES.md.