# AuroraMap.app - Complete Documentation

> Real-time aurora forecast for both hemispheres - Aurora Australis (Southern Lights) and Aurora Borealis (Northern Lights). High-performance interactive maps, KP index monitoring, and geomagnetic storm tracking for aurora enthusiasts worldwide.

## About AuroraMap.app

AuroraMap.app is a comprehensive aurora forecasting platform designed to provide accurate, real-time predictions for both Aurora Australis (Southern Lights) and Aurora Borealis (Northern Lights) visibility. The platform serves aurora enthusiasts, photographers, scientists, and tourists worldwide who want to maximize their chances of witnessing this spectacular natural phenomenon. With cutting-edge performance optimizations and personalized location-based predictions, AuroraMap.app delivers the most advanced aurora forecasting experience available.

### Key Features

**Real-time Aurora Forecasting for Both Hemispheres**
- Live aurora predictions for both Aurora Australis and Aurora Borealis based on current solar wind conditions
- Real-time NOAA OVATION aurora probability model integration
- 24-hour KP index forecast window with current readings
- Geomagnetic storm alerts and notifications
- Personalized aurora visibility probability calculations for any location worldwide
- Night-time weather integration (cloud cover, visibility, precipitation probability)

**High-Performance Interactive Maps**
- Canvas-based rendering delivering 5-10x performance improvement over traditional SVG
- Dual hemisphere support with seamless switching between Northern and Southern views
- Real-time aurora probability overlays with color-coded intensity levels (0-100%)
- User location marker with automatic geolocation and manual positioning
- Full-screen mode for immersive viewing experience
- Optimized legend with clear probability thresholds
- Delayed tooltip loading reducing initial render time by 60-70%
- Smooth pan and zoom with touch-friendly mobile controls
- Live forecast images for 30-minute, tonight, and tomorrow predictions

**3D Interactive Globe Visualization**
- Real-time 3D Earth rendering using WebGL (globe.gl)
- Interactive rotation and zoom to view aurora from any angle
- Accurate mapping of aurora probability data onto the spherical surface
- Visualization of the day/night terminator line
- seamless toggling between Northern and Southern hemisphere views
- High-performance rendering suitable for modern mobile devices

**CME (Coronal Mass Ejection) Monitor**
- Tracking of solar eruptions and Coronal Mass Ejections
- Impact time forecasts (Arrival Time) for Earth-directed CMEs
- Analysis of CME speed (km/s) and type (Halo, Partial Halo)
- Historical CME data log for correlation with geomagnetic storms
- Visual indicators for potential Earth-impact events

**Advanced KP Index Monitoring**
- Real-time geomagnetic activity monitoring (KP index 0-9 scale)
- 24-hour forecast window showing upcoming geomagnetic activity
- Time-based KP chart with historical trends and patterns
- Color-coded alerts for elevated geomagnetic activity (green/yellow/orange/red)
- Correlation analysis between KP values and aurora visibility at different latitudes
- Automatic updates every 3 hours with real-time data synchronization

**Hemispheric Power Index (HPI) Charts**
- Real-time current HPI display in Gigawatts (GW) with color-coded intensity
- Historical aurora power data showing seasonal patterns and trends
- Peak activity forecasting for optimal viewing windows
- Hemispheric power comparison between Northern and Southern auroras
- Time-series visualization with interactive Chart.js graphs

**Solar Wind & Magnetic Field Monitoring**
- Real-time Bz (magnetic field) measurements with current value display
- Earth position calculations accounting for solar wind travel time from L1 point
- Solar wind speed, density, and magnetic field component tracking
- Predictive Earth arrival time for solar wind disturbances
- Color-coded Bz indicators (southward/northward orientation impact on aurora)

## Scientific Background

**Aurora Formation**
Aurora (both Australis and Borealis) occurs when charged particles from the solar wind interact with Earth's magnetosphere. These particles are channeled by Earth's magnetic field toward the polar regions, where they collide with atmospheric gases at altitudes of 100-400 km, producing the characteristic green, red, purple, and blue lights. The color depends on the type of gas molecule and the altitude of the collision:
- Green (most common): Oxygen at 100-300 km altitude
- Red: Oxygen at higher altitudes (>300 km)
- Purple/Blue: Nitrogen at lower altitudes
- Pink: Mix of nitrogen and oxygen

**Geomagnetic Activity & Solar Wind**
The intensity and visibility of aurora depend on several interconnected factors:
- **Solar Wind Speed**: Faster solar wind (>500 km/s) increases aurora intensity
- **Solar Wind Density**: Higher particle density enhances aurora brightness
- **Interplanetary Magnetic Field (IMF) Bz Component**: Southward Bz (negative values) is crucial for aurora activity as it allows solar wind to penetrate Earth's magnetosphere
- **Geomagnetic Storm Intensity**: Measured by KP index (0-9 scale), with higher values indicating stronger storms
- **Hemispheric Power Index (HPI)**: Measures total aurora energy in Gigawatts, indicating overall aurora intensity
- **Local Atmospheric Conditions**: Cloud cover, humidity, and air quality affect visibility
- **Light Pollution**: Urban light pollution significantly reduces aurora visibility

**Visibility Factors & Optimal Conditions**
- **KP Index Thresholds**:
  - KP 0-2: Aurora visible only at very high latitudes (>65°)
  - KP 3-4: Aurora visible at mid-high latitudes (55-65°)
  - KP 5-6: Aurora visible at mid latitudes (45-55°), including Tasmania, southern New Zealand, northern Scotland
  - KP 7-9: Major geomagnetic storm, aurora visible at lower latitudes (35-45°), including Melbourne, Christchurch, northern USA
- **Moon Phase**: New moon or crescent moon provides darkest skies for optimal viewing
- **Weather Conditions**: Clear skies with <30% cloud cover essential for observation
- **Light Pollution**: Rural locations with Bortle scale 1-3 provide best viewing conditions
- **Time of Night**: Peak aurora activity typically 10 PM - 2 AM local time
- **Seasonal Factors**: Equinox months (March, September) often show increased aurora activity
- **Bz Orientation**: Sustained southward Bz (<-5 nT) for 2+ hours significantly increases aurora probability

## Data Sources and Methodology

**Primary Data Sources**
- **NOAA Space Weather Prediction Center (SWPC)**: Primary source for all geomagnetic and aurora data
- **NOAA OVATION Aurora Model**: Real-time aurora probability predictions with 30-minute forecasts
- **ACE (Advanced Composition Explorer)**: Satellite data from L1 Lagrange point (~1.5 million km from Earth)
- **DSCOVR (Deep Space Climate Observatory)**: Real-time solar wind measurements and magnetic field data
- **Ground-based Magnetometer Networks**: Global network providing geomagnetic field measurements
- **Solar Wind Monitoring Stations**: Multiple stations tracking solar wind parameters
- **Open-Meteo Weather API**: Real-time weather data for aurora viewing conditions (cloud cover, visibility, precipitation)

**Advanced Forecast Algorithm**
The platform uses a sophisticated multi-layered approach:
1. **Real-time Solar Wind Analysis**: Continuous monitoring of speed, density, and magnetic field components (Bx, By, Bz)
2. **Earth Position Calculations**: Accounting for solar wind travel time from L1 point to Earth (typically 30-60 minutes depending on speed)
3. **OVATION Model Integration**: NOAA's empirical aurora prediction model providing probability maps
4. **Historical Correlation Patterns**: Decades of aurora observation data correlating solar activity with visibility
5. **Atmospheric Modeling**: Location-specific predictions considering magnetic latitude, local time, and seasonal factors
6. **Weather Integration**: Real-time cloud cover and visibility data to assess actual viewing conditions
7. **Machine Learning Enhancement**: Algorithms trained on historical data to improve prediction accuracy

**Data Update Frequency & Latency**
- Solar wind data: Every 1-2 minutes (real-time streaming)
- Magnetic field (Bz) data: Every 1-2 minutes with Earth position adjustment
- Aurora probability maps: Every 5-10 minutes
- KP index: Every 3 hours (official) with nowcast updates every 15 minutes
- Hemispheric Power Index (HPI): Every 5 minutes
- Weather data: Every 15 minutes
- Forecast images: Every 30 minutes
- Total system latency: <5 minutes from data source to display

## Regional Focus Areas

**Southern Hemisphere Coverage (Aurora Australis)**
- **Australia**:
  - Tasmania (Hobart, Launceston): Best viewing locations in Australia, visible during KP 4+
  - Victoria (Melbourne, Geelong): Visible during KP 5-6+ events
  - South Australia (Adelaide): Visible during major storms (KP 6+)
  - Western Australia (Albany): Southern coast viewing during strong activity
- **New Zealand**:
  - South Island (Queenstown, Dunedin, Invercargill): Excellent viewing locations
  - Stewart Island: One of the best aurora viewing locations in the world
  - North Island: Visible only during major geomagnetic storms (KP 7+)
- **South America**:
  - Southern Chile (Punta Arenas, Puerto Natales): Regular aurora visibility
  - Argentina Patagonia (Ushuaia, El Calafate): Excellent southern viewing locations
  - Falkland Islands: Frequent aurora sightings
- **Southern Africa**:
  - South Africa (Cape Town, Port Elizabeth): Visible only during major storms (KP 7+)
  - Rare but spectacular displays during extreme events

**Northern Hemisphere Coverage (Aurora Borealis)**
- **North America**:
  - Alaska (Fairbanks, Anchorage): Prime viewing locations, visible most clear nights
  - Canada (Yukon, Northwest Territories, Churchill): Excellent aurora zones
  - Northern USA (Montana, North Dakota, Minnesota, Maine): Visible during KP 5+ events
  - Mid-latitude USA: Visible during major storms (KP 7+)
- **Europe**:
  - Iceland (Reykjavik, Akureyri): Popular aurora tourism destination
  - Norway (Tromsø, Lofoten Islands): Within aurora oval, frequent sightings
  - Sweden (Kiruna, Abisko): Excellent viewing with clear weather
  - Finland (Lapland, Rovaniemi): Aurora zone with good infrastructure
  - Scotland (Highlands, Orkney Islands): Visible during moderate activity (KP 4-5)
- **Russia**: Murmansk, Siberia - Regular aurora activity in northern regions

**Magnetic Latitude Considerations**
- **Routine Visibility (KP 0-2)**: 60-70° magnetic latitude (aurora oval)
- **Moderate Activity (KP 3-4)**: 55-65° magnetic latitude (expanded oval)
- **Strong Activity (KP 5-6)**: 45-55° magnetic latitude (Tasmania, southern NZ, northern Scotland, northern USA)
- **Major Storms (KP 7-8)**: 35-45° magnetic latitude (Melbourne, Christchurch, mid-USA, southern UK)
- **Extreme Events (KP 9)**: As low as 25-35° magnetic latitude (rare, visible from Sydney, Los Angeles, Mediterranean)

## API Documentation

**Core Endpoints**
```
GET /api/current-forecast
- Returns comprehensive current aurora forecast data
- Includes KP index, HPI, solar wind parameters, Bz values
- Response includes current readings and 24-hour forecast window
- Update frequency: Every 5 minutes

GET /api/solar-wind
- Real-time solar wind measurements from DSCOVR/ACE satellites
- Parameters: speed (km/s), density (particles/cm³), temperature (K)
- Magnetic field components: Bx, By, Bz (nT)
- Earth arrival time calculations included
- Update frequency: Every 1-2 minutes

GET /api/magnetic-field
- Current magnetic field measurements with Bz component
- Earth position adjusted values (accounting for L1 to Earth travel time)
- Historical data for trend analysis
- Color-coded indicators for aurora impact (southward vs northward Bz)
- Update frequency: Every 1-2 minutes

GET /api/kp-index
- Current KP index value (0-9 scale)
- 24-hour forecast window with 3-hour intervals
- Historical KP data for trend analysis
- Nowcast and predicted values
- Update frequency: Every 3 hours (official), every 15 minutes (nowcast)

GET /api/aurora-power
- Hemispheric Power Index (HPI) in Gigawatts
- Separate values for Northern and Southern hemispheres
- Current HPI display value
- Historical data for charts and trends
- Update frequency: Every 5 minutes

GET /api/aurora-ovation
- NOAA OVATION aurora probability model data
- Latitude/longitude grid with probability values (0-100%)
- Separate data for Northern and Southern hemispheres
- Used for interactive map overlays
- Update frequency: Every 5-10 minutes

GET /api/visibility/{latitude}/{longitude}
- Location-specific aurora visibility forecast
- Personalized probability percentages based on current conditions
- Optimal viewing times for next 24 hours
- Night-time weather integration (cloud cover, visibility, precipitation)
- Magnetic latitude calculations
- Update frequency: On-demand with 5-minute cache
```

**Response Format & Standards**
- All API responses in JSON format with consistent structure
- Timestamps in UTC ISO 8601 format (YYYY-MM-DDTHH:mm:ssZ)
- Data quality indicators included (source, confidence level, last update time)
- Source attribution for all data points (NOAA, DSCOVR, ACE, etc.)
- Error responses with detailed error codes and messages
- CORS enabled for cross-origin requests
- Rate limiting: 100 requests per minute per IP
- Caching headers for optimal performance

## Aurora Photography Guidelines

**Essential Camera Settings**
- **Mode**: Full manual mode (M) for complete control
- **Exposure Time**:
  - Weak aurora (KP 1-3): 15-30 seconds
  - Moderate aurora (KP 4-6): 5-15 seconds
  - Strong aurora (KP 7+): 2-8 seconds (faster to capture movement)
- **Lens**: Wide-angle lens (14-24mm recommended, 10-20mm for ultra-wide)
- **ISO**:
  - Start at ISO 1600-3200 for most conditions
  - Increase to ISO 4000-6400 for weak aurora or faster shutter speeds
  - Modern cameras can handle high ISO with minimal noise
- **Aperture**: f/2.8 or wider (f/1.4-f/2.0 ideal) for maximum light gathering
- **Focus**: Manual focus set to infinity (use live view and zoom to focus on distant stars)
- **White Balance**: 3500-4000K for natural colors, or shoot RAW for post-processing flexibility
- **Image Format**: RAW for maximum editing flexibility

**Advanced Techniques**
- **Intervalometer**: Use for time-lapse sequences (1-5 second intervals)
- **Foreground Lighting**: Use subtle LED light painting for foreground interest (2-3 second exposure)
- **Panoramas**: Shoot multiple frames for wide panoramic aurora scenes
- **Star Trails**: Combine aurora with star trail photography using stacking techniques
- **Composition**: Rule of thirds, include interesting foreground elements (trees, mountains, water reflections)

**Location Scouting & Preparation**
- **Dark Sky Sites**: Find Bortle scale 1-3 locations away from city lights (use light pollution maps)
- **Daytime Scouting**: Visit locations during daylight for safety, composition planning, and accessibility
- **Foreground Elements**: Identify compelling foreground subjects (lone trees, rock formations, lakes for reflections)
- **Safety**: Inform someone of your location, bring warm clothing, headlamp with red light mode
- **Weather Check**: Use AuroraMap.app's weather integration to verify cloud cover and visibility
- **Accessibility**: Ensure safe access in darkness, consider proximity to parking

**Optimal Timing & Conditions**
- **Time of Night**: Peak aurora activity typically 10 PM - 2 AM local time
- **Seasonal Peaks**: Equinox months (March, September) often show increased activity
- **Moon Phase**: New moon or crescent moon provides darkest skies (check moon rise/set times)
- **KP Index**: Monitor AuroraMap.app for KP 4+ predictions at your latitude
- **Bz Component**: Watch for sustained southward Bz (<-5 nT) indicating high aurora probability
- **Weather**: Clear skies with <20% cloud cover essential
- **Eye Adaptation**: Allow 20-30 minutes for eyes to fully adjust to darkness
- **Patience**: Aurora can be dynamic - stay for 2-3 hours to catch peak activity

**Post-Processing Tips**
- Adjust white balance for natural or creative color rendering
- Increase clarity and vibrance to enhance aurora colors
- Reduce noise while preserving detail (use luminance noise reduction)
- Adjust highlights and shadows to balance foreground and sky
- Consider focus stacking for sharp foreground and stars
- Create time-lapse videos from image sequences

## Historical Performance & Accuracy

**Forecast Accuracy Metrics**
- **Major Geomagnetic Storms (KP ≥ 6)**: 85-90% accuracy for timing and intensity predictions
- **Moderate Activity (KP 4-5)**: 75-80% accuracy with ±1 KP index margin
- **Weak Activity (KP 1-3)**: 60-70% accuracy (inherently more variable)
- **Location-Specific Visibility**: 80% accuracy when weather conditions are favorable
- **False Positive Rate**: Maintained below 12% for KP 5+ predictions
- **Lead Time**: 30-90 minute advance warning for sudden aurora intensifications
- **Weather Integration**: 85% accuracy for cloud cover predictions affecting visibility

**Notable Aurora Events (2022-2025)**
- **May 2024**: Extreme G5 geomagnetic storm (KP 9) - Aurora visible from Mexico, Mediterranean, northern Australia
- **March 2024**: Strong G4 storm - Widespread aurora across Tasmania, New Zealand, northern USA
- **November 2023**: Sustained multi-day aurora activity - Excellent viewing across southern Australia
- **March 2023**: Major G3 geomagnetic storm - Aurora visible from Melbourne, Adelaide, Christchurch
- **October 2022**: Sustained aurora activity across New Zealand - Multiple nights of strong displays
- **September 2022**: Equinox aurora season peak - Frequent sightings across Tasmania and South Island NZ
- **April 2022**: Rare aurora visibility from South Africa (Cape Town) during G4 storm
- **February 2022**: Northern Hemisphere aurora visible from Scotland, northern England, Pacific Northwest

**Platform Performance Metrics**
- **Uptime**: 99.8% availability over past 12 months
- **Data Latency**: Average 3.2 minutes from source to display
- **Map Rendering**: 5-10x performance improvement with Canvas rendering (November 2025 update)
- **Page Load Time**: <2 seconds on 4G connection, <1 second on broadband
- **Mobile Optimization**: 95+ Google PageSpeed score
- **User Satisfaction**: 4.8/5.0 average rating from aurora photographers

## Technical Implementation

**Frontend Technology Stack**
- **Framework**: Astro.js 4.x for static site generation with partial hydration
- **Interactive Maps**: Leaflet.js 1.9+ with custom Canvas-based aurora overlays
- **3D Visualization**: globe.gl & Three.js for interactive 3D Earth rendering
- **Charting**: Chart.js 4.x with chartjs-adapter-date-fns for time-series data
- **Styling**: Tailwind CSS 3.x with custom aurora-themed color palette
- **Real-time Updates**: Fetch API with automatic retry and fallback mechanisms
- **State Management**: Vanilla JavaScript with efficient DOM manipulation
- **Responsive Design**: Mobile-first approach with touch-optimized controls
- **Accessibility**: WCAG 2.1 AA compliant with keyboard navigation and screen reader support

**Performance Optimizations (November 2025 Updates)**
- **Canvas Rendering**: Switched from SVG to Canvas for 5-10x map rendering performance
- **Delayed Tooltip Loading**: Tooltips created on-demand, reducing initial render time by 60-70%
- **Smart Caching**: Multi-layer caching strategy (browser, CDN, API) with stale-while-revalidate
- **Code Splitting**: Dynamic imports for non-critical components
- **Image Optimization**: WebP format with fallback, lazy loading, responsive images
- **Resource Hints**: Preconnect, prefetch, and preload for critical resources
- **Debounced Events**: Optimized zoom and pan handlers to prevent excessive re-renders
- **Progressive Enhancement**: Core functionality works without JavaScript

**Backend Infrastructure**
- **API Servers**: Node.js with Express.js for RESTful API endpoints
- **Data Processing**: Real-time stream processing for solar wind and magnetic field data
- **Database**: PostgreSQL for historical data storage with TimescaleDB extension for time-series
- **Caching Layer**: Redis for frequently accessed forecasts and API responses (5-minute TTL)
- **Data Ingestion**: Automated polling from NOAA, DSCOVR, ACE with error handling and retry logic
- **Queue System**: Bull queue for background jobs and data processing tasks
- **Monitoring**: Real-time error tracking and performance monitoring
- **Backup Systems**: Multi-source fallback for critical data endpoints

**Deployment & Infrastructure**
- **Hosting**: Netlify for static site with edge functions
- **CDN**: Global CDN delivery for low-latency access worldwide
- **DNS**: Cloudflare for DNS management and DDoS protection
- **SSL/TLS**: Automatic HTTPS with Let's Encrypt certificates
- **Analytics**: Matomo self-hosted analytics (privacy-focused, GDPR compliant)
- **Monitoring**: Uptime monitoring with alerting for critical failures
- **Backup**: Automated daily backups of historical data and configurations

**Data Flow Architecture**
1. **Data Collection**: Automated polling from NOAA/DSCOVR/ACE every 1-5 minutes
2. **Processing**: Real-time data transformation and Earth position calculations
3. **Storage**: Time-series data stored in PostgreSQL with Redis caching
4. **API Layer**: RESTful endpoints with rate limiting and authentication
5. **Frontend**: Static site with dynamic data fetching and real-time updates
6. **User Experience**: Smooth interactions with skeleton loading and error handling

## User Features & Experience

**Personalized Aurora Predictions**
- **Automatic Location Detection**: Browser geolocation API with user permission
- **Manual Location Selection**: Click-to-place marker on interactive map
- **Visibility Calculations**: Real-time aurora visibility probability for user's location
- **Magnetic Latitude**: Automatic calculation of magnetic latitude for accurate predictions
- **Optimal Viewing Times**: Personalized recommendations for next 24 hours
- **Weather Integration**: Night-time cloud cover, visibility, and precipitation forecasts

**Interactive Map Features**
- **Dual Hemisphere Support**: Seamless switching between Northern and Southern aurora views
- **Full-Screen Mode**: Immersive viewing experience with dedicated full-screen button
- **User Location Marker**: Visual indicator of user's position with visibility range circle
- **Aurora Probability Overlay**: Color-coded grid showing 0-100% aurora probability
- **Optimized Legend**: Clear probability thresholds with color-coded indicators
- **Touch-Friendly Controls**: Optimized for mobile aurora chasing
- **Zoom & Pan**: Smooth navigation with performance-optimized rendering
- **Layer Controls**: Toggle between different data layers and overlays

**Real-Time Dashboard**
- **Current KP Index**: Live geomagnetic activity reading with color-coded alert level
- **Current HPI**: Hemispheric Power Index in Gigawatts showing aurora intensity
- **Current Bz**: Magnetic field orientation with aurora impact indicator
- **24-Hour Forecast**: Visual timeline of predicted aurora activity
- **Skeleton Loading**: Smooth loading states with animated placeholders
- **Error Handling**: Graceful degradation with retry mechanisms

**Mobile Experience**
- **Responsive Design**: Optimized layouts for all screen sizes
- **Touch Gestures**: Swipe, pinch-to-zoom, tap interactions
- **Live Forecast Images**: Mobile-optimized aurora forecast images (30-min, tonight, tomorrow)
- **Bottom Navigation**: Easy access to key features on mobile
- **Progressive Web App**: Install to home screen for app-like experience
- **Offline Support**: Basic functionality available without internet connection

**Accessibility Features**
- **Keyboard Navigation**: Full keyboard support for all interactive elements
- **Screen Reader Support**: ARIA labels and semantic HTML for assistive technologies
- **High Contrast Mode**: Support for system-level high contrast preferences
- **Reduced Motion**: Respects prefers-reduced-motion for animations
- **Focus Indicators**: Clear visual focus states for keyboard navigation
- **Alt Text**: Descriptive alternative text for all images and charts

## Companion Apps & Resources

**Stargazing Hub Mobile App**
- Companion mobile app for aurora alerts and notifications
- Push notifications for major geomagnetic storms
- Offline aurora forecast data
- Integrated with AuroraMap.app for seamless experience
- Available for iOS and Android
- Download links available on homepage

**Educational Resources**
- **Aurora Science**: Comprehensive guide to aurora formation and physics
- **Photography Tutorials**: Step-by-step guides for capturing aurora
- **Location Guides**: Best aurora viewing locations by region
- **FAQ**: Common questions about aurora forecasting and viewing
- **Glossary**: Definitions of technical terms (KP index, Bz, HPI, etc.)

## Contact and Support

**Technical Support**
- **Email**: axxu0607@gmail.com
- **Response Time**: 24-48 hours for general inquiries, priority for critical issues
- **Bug Reports**: Detailed bug reports with screenshots appreciated
- **Feature Requests**: Open to suggestions for new features and improvements

**Community & Social**
- **Social Media**: Follow for major geomagnetic event alerts and aurora photography
- **User Contributions**: Share your aurora photography and sightings
- **Feedback**: User feedback directly improves forecast accuracy and features
- **Newsletter**: Optional email updates for major aurora events (no spam)

**Data Attribution & Acknowledgments**
This service acknowledges and thanks the following data providers:
- **NOAA Space Weather Prediction Center (SWPC)**: Primary data source for all geomagnetic and aurora data
- **NASA Goddard Space Flight Center**: ACE and DSCOVR satellite data
- **ESA Space Weather Service Network**: European space weather monitoring
- **International Service of Geomagnetic Indices**: Official KP index data
- **Open-Meteo**: Weather data for aurora viewing conditions
- **Leaflet.js**: Open-source mapping library
- **Chart.js**: Open-source charting library
- **Astro.js**: Modern web framework

**Privacy & Data Policy**
- **No Personal Data Collection**: Location data processed client-side only
- **Privacy-Focused Analytics**: Self-hosted Matomo analytics (GDPR compliant)
- **No Tracking**: No third-party tracking scripts or cookies
- **Open Source**: Core algorithms and methodologies documented publicly

**License & Usage**
- **Free for Personal Use**: All features free for aurora enthusiasts
- **API Access**: Contact for commercial API access and higher rate limits
- **Attribution**: Please credit AuroraMap.app when sharing forecasts or screenshots

---

*Last updated: January 2026*
*Version: 3.2.0*
*Major updates: 3D Globe visualization, CME Monitor, Canvas rendering performance optimization, personalized location predictions*