Advanced 3D Satellite Tracking & Orbital Mechanics Platform
Real-time visualization, pass prediction, and conjunction analysis powered by CesiumJS and SGP4.

Live Demo · Wiki · Theory · Report Bug

Desktop Command Center	Mobile Pocket Lab

• Pocket Lab Interface: A native-app-like mobile UI shell (MobileAppShell) locked to 100dvh to prevent browser bounce and safe-area overlap.
• Native Snapping Sheet: A gesture-driven bottom sheet using framer-motion with 3 snapping heights: Tier 1 (Preview), Tier 2 (Split Tracker), and Tier 3 (Full Scientific Lab).
• Ankara Command Deck: Integrated Doppler frequency shift analysis, space solar weather decay metrics, and visible overhead pass predictions relative to Ankara coordinates.
• Haptic & Scrubber integration: Translucent timeline play/pause controller with speed cycling and haptic triggers.
• Hardware-Aware Profiling: Dynamically downscales globe details and satellite load on lower-tier mobile hardware to secure 60fps rendering.

• 🖥️ Pure HSL Glassmorphic CSS Variables — Frosted glass panels and neon spatial theme color tokens (uplink cyan, orbit gold) decoupled from Tailwind.
• ⏱️ Adaptive Timeline — Context-aware time scrubber that adjusts positions to prevent component clashing.
• 🎥 Satellite Cockpit View (POV) — Camera locked to the velocity vector with smooth Quaternion rotations.
• 🔬 Scientific Modals & Bottom Sheets — Mobile-first scientific lab cards with premium frosted backgrounds and high contrast readability.

• 🛰️ Real-time SGP4 Propagation — Web Worker-driven batch processing for 25,000+ satellites at 60 FPS
• 🧮 Spatial Hashing Collision Engine — O(N) link calculation with 1000km³ grid cells
• 🌍 High-Fidelity Inertial Orbit Rendering — Fixed GMST algorithm shows true Kepler rings
• ⚡ Offline-First Architecture — IndexedDB caching with Stale-While-Revalidate
• 📦 OTA Payload Minification — Server-side TLE parsing and comment/whitespace stripping reduces network overhead by ~40% for mobile connections
• 📊 Scientific Data Export — TLE, CSV, and JSON format export for research

• 🌍 Interactive 3D Globe — Real-time visualization of 25,000+ satellites and space objects
• 🔬 Scientific Analysis — Doppler shift, orbital decay, conjunction analysis, pass prediction
• 🛰️ Professional TLE Hub — Multi-source fallback (Space-Track, CelesTrak, AMSAT)
• ☀️ Eclipse Detection — Real-time sunlight/shadow status for all objects
• ⛓️ Deep Linking — Share specific satellites via URL (e.g., ?sat=25544)
• ⏱️ Time Travel — Simulate orbits at any point in history or future
• 🔭 Scientific Tool Suite — Pass prediction, Skyplot polar view, Orbital decay analysis & Doppler calculator
• 🧭 AR Compass Mode — Use device orientation to spot satellites in the sky
• ⌨️ Power User Tools — Keyboard shortcuts, analyst mode, and TLE exporting
• ⭐ Favorites System — Save and quickly access your favorite satellites

• Node.js 18+
• npm or yarn

# Clone the repository
git clone https://github.com/SpaceEngineerSS/OrbitVieW.git
cd orbitview

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env.local
# Add your Cesium Ion access token to .env.local

# Start development server
npm run dev

Open http://localhost:3000 to see the app.

NEXT_PUBLIC_CESIUM_ACCESS_TOKEN=your_cesium_token_here

Get your free Cesium Ion token at cesium.com/ion.

src/
├── app/                 # Next.js App Router pages
├── components/
│   ├── Globe/          # Cesium globe & satellite rendering
│   ├── HUD/            # Heads-up display components
│   ├── Scientific/     # Analysis dashboards
│   └── layout/         # Responsive layouts (MobileNavBar, InspectorPanel)
├── lib/                # Core calculations
│   ├── DopplerCalculator.ts
│   ├── OrbitalDecay.ts
│   ├── ConjunctionAnalysis.ts
│   └── PassPrediction.ts
├── hooks/              # Custom React hooks
├── workers/            # Web Workers for heavy computation
└── store/              # Zustand state management

OrbitView is engineered with high-fidelity astrodynamic models to ensure research-grade accuracy.

• Propagation: High-precision SGP4/SDP4 models considering Earth's oblateness (J2-J4), atmospheric drag ($B^*$), and deep-space perturbations
• Orbit Rendering: Fixed GMST inertial frame rendering for true Kepler orbit visualization
• Atmospheric Model: Optimized exponential decay model correlated with real-time $B^*$ terms
• Signal Analysis: Relativistic Doppler shift calculations based on ITRF radial velocity vectors

For in-depth analysis and methodology, see THEORY.md

# Run all tests
npm test

# Run with coverage
npm run test:coverage

# Type checking
npm run type-check

# Generate Documentation Screenshots
node scripts/capture-screens.mjs

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project was developed by Mehmet Gümüş.

🌐 Website: spacegumus.com.tr
🐙 GitHub: OrbitVieW
𝕏 X (Twitter): @persesmg
📧 Email: contact@spacegumus.com.tr

This project is licensed under the MIT License - see the LICENSE file for details.

• CelesTrak — TLE data source
• CesiumJS — 3D globe engine
• satellite.js — SGP4 implementation

orbitview-five.vercel.app