Spacia - LEO Business & Operations Platform

Problem Statement

As the commercialization of space rapidly accelerates, the future of business in low Earth orbit (LEO) holds incredible potential, but also presents significant operational, regulatory, and environmental challenges. This new economic frontier invites innovative and sustainable approaches to foster long-term viability and responsible execution. Your challenge is to conceptualize and design a scalable, sustainable, business model, accompanied by a prototype, that explores the unique opportunities LEO offers while addressing the complexities of operating in space. (Joint Agency Satellite Division)

Project Video

Watch the Video

✨ Page Highlights

🏠 Home Page

Location: src/app/page.tsx The landing page introduces the Spacia platform with a high-impact visual experience.

Hero Section: Features an AnimatedHero component that engages users immediately.
Live Preview: Includes a MiniDashboard to give a glimpse of the real-time tracking capabilities.
Features Overview: Showcases key platform pillars using PillarsSection and WorldviewShowcase.

🌍 Dashboard (3D Earth View)

Location: src/app/dashboard/page.tsx The core of the platform, offering a comprehensive view of the orbital environment.

Interactive Globe: Powered by the EarthView component, rendering a 3D Earth with real-time satellite and debris data.
Real-Time Tracking: Visualizes over 13,000 satellites and 28,000 debris objects.
Risk Zones: Highlights high-density areas and potential collision risks.
Controls: Users can filter objects, view orbits, and inspect specific satellites.

☀️ Space Weather

Location: src/app/spaceweather/page.tsx A dedicated dashboard for monitoring solar and geomagnetic conditions that impact space operations.

Solar Activity: Tracks solar flares and solar wind data.
Impact Analysis: Assesses risks to satellites, communications, and power grids.
Visualizations: Uses charts and data feeds to present complex weather data clearly.

🚀 Launch Planner

Location: src/app/planner/page.tsx A critical tool for mission planning and orbit analysis.

Feasibility Checks: Validates launch sites against desired orbital inclinations.
Debris Risk Assessment: Calculates collision risks for specific altitudes using the LaunchPlanner component.
Lifetime Estimation: Predicts orbital decay and ensures compliance with the 25-year deorbit rule.
3D Preview: Visualizes the planned orbit using OrbitalGlobe.

💼 Business Advisor

Location: src/app/business/page.tsx An AI-powered module designed to assist with the commercial aspects of space missions.

AI Integration: Utilizes any llm model to generate insights and proposals.
Mission Feasibility: Analyzes the viability of proposed space business models.
Proposal Generation: Automatically creates detailed business proposals, which can be exported to PDF.
Partner Ecosystem: Suggests relevant industry partners for launch, ground stations, and insurance.

🔄 Platform Flow

flowchart TB
    A[Home Page] --> B[Dashboard - 3D Earth View]
    A --> C[Space Weather]
    B --> D[Launch Planner]
    D --> E[Business Advisor]
    E --> F[PDF Export]
    C --> G[Impact Analysis]
    B --> H[TLE Data Integration]

User Journey:

Home: Overview with live debris preview
Dashboard: Interactive 3D visualization of LEO environment
Space Weather: Real-time solar activity and geomagnetic conditions
Planner: Launch site analysis and orbital lifetime estimation
Business: AI-powered mission feasibility and proposal generation
About: Platform mission and technology overview

🧱 Tech Stack

Frontend

Framework: Next.js 15 with App Router
React: Version 19.1.0 with Server Components
TypeScript: Version 5 for type safety
Styling: Tailwind CSS 4 with custom space theme
Animations: Framer Motion for smooth transitions
Charts: Recharts for space weather data visualization

3D Visualization

Three.js: 3D graphics rendering for Earth and orbital objects
CesiumJS: Advanced geospatial 3D globe visualization
Satellite.js: TLE orbit propagation and calculations

AI & Machine Learning

LLM Server: Local or remote LLM inference server (e.g., any llm model)
Model: Configurable model for business proposal generation
Private Inference: All AI processing happens on your infrastructure

Backend & APIs

Next.js API Routes: Serverless API endpoints
NextAuth: GitHub OAuth authentication
NASA APIs:
- DONKI (Space Weather Database)
- GIBS (Global Imagery Browse Services)
- CME Analysis API
NOAA APIs:
- Space Weather Prediction Center
- Planetary K-index
- Solar Wind Data
- Proton Events
CelesTrak: TLE (Two-Line Element) data for satellite tracking

Data & External Services

TLE Data Sources: Real-time orbital element sets
Space Weather Data: NOAA SWPC, NASA DONKI
Earth Observation: NASA GIBS WMTS/WMS

Development Tools

ESLint: Code quality and consistency
PostCSS: CSS processing and optimization
Turbopack: Fast bundling for development and production

📂 Project Structure

nasa-space-project-Spacia/
├── README.md                           # This file
├── package.json                        # Dependencies and scripts
├── next.config.ts                      # Next.js configuration
├── tsconfig.json                       # TypeScript configuration
├── tailwind.config.js                  # Tailwind CSS configuration
├── eslint.config.mjs                   # ESLint configuration
│
├── public/                             # Static assets
│   ├── minidasboard.png                # Dashboard preview image
│   ├── *.svg                           # Icon assets
│   └── cesium/                         # CesiumJS static assets
│       ├── Cesium.js                   # Cesium library
│       ├── Assets/                     # Terrain, imagery assets
│       ├── Widgets/                    # Cesium UI widgets
│       └── Workers/                    # Web workers for Cesium
│
└── src/
    ├── app/                            # Next.js App Router
    │   ├── layout.tsx                  # Root layout with auth provider
    │   ├── page.tsx                    # Home page with hero & preview
    │   ├── globals.css                 # Global styles & custom properties
    │   │
    │   ├── dashboard/
    │   │   └── page.tsx                # 3D Earth visualization
    │   │
    │   ├── spaceweather/
    │   │   └── page.tsx                # Space weather dashboard
    │   │
    │   ├── planner/
    │   │   └── page.tsx                # Launch planner interface
    │   │
    │   ├── business/
    │   │   └── page.tsx                # AI business advisor
    │   │
    │   ├── about/
    │   │   └── page.tsx                # About Spacia
    │   │
    │   └── api/                        # API Routes
    │       ├── auth/
    │       │   └── [...nextauth]/
    │       │       └── route.ts        # NextAuth configuration
    │       ├── weather/
    │       │   └── route.ts            # Space weather aggregation
    │       ├── business/
    │       │   └── route.ts            # LLM integration
    │       ├── planner/
    │       │   └── route.ts            # Orbit & launch analysis
    │       ├── alerts/
    │       │   └── route.ts            # Conjunction detection
    │       ├── tle/
    │       │   └── route.ts            # TLE data fetching
    │       └── gibs/
    │           └── route.ts            # NASA GIBS proxy
    │
    └── components/                     # React components
        ├── NavBar.tsx                  # Navigation bar with auth
        ├── Footer.tsx                  # Site footer
        ├── AuthProvider.tsx            # NextAuth session provider
        ├── RouteLoader.tsx             # Loading states
        ├── AnimatedHero.tsx            # Hero section with animations
        ├── MiniDashboard.tsx           # Live preview widget
        ├── PillarsSection.tsx          # Feature highlights
        ├── CTASection.tsx              # Call-to-action
        ├── WorldviewShowcase.tsx       # Platform showcase
        ├── EarthView.tsx               # Main 3D Earth component
        ├── EarthViwlanlog.tsx          # Alternative Earth view
        ├── LaunchPlanner.tsx           # Launch planning interface
        ├── StatsCards.tsx              # Statistics display
        ├── AlertsFeed.tsx              # Conjunction alerts
        ├── OrbitalGlobe.tsx            # Orbital visualization
        └── CesiumViewer.tsx            # Cesium integration

🚀 Getting Started

Prerequisites

Node.js: v18 or higher
npm: v9 or higher
LLM Provider (optional for AI features): Any LLM model server
NASA API Key (optional): Get API Key

Installation

Clone the repository

git clone https://github.com/Rahulgupta7777/nasa-space-project-Spacia.git
cd nasa-space-project-Spacia

Install dependencies

npm install

Configure environment variables

Create a .env.local file in the root directory:

# LLM Configuration (for AI Business Advisor)
LLM_URL=http://localhost:11434
LLM_MODEL=any-llm-model

# NextAuth Configuration
NEXTAUTH_SECRET=your-secret-key-here-generate-with-openssl-rand-base64-32
NEXTAUTH_URL=http://localhost:3000

# GitHub OAuth (optional - required for Business page)
GITHUB_ID=your-github-oauth-client-id
GITHUB_SECRET=your-github-oauth-client-secret

# NASA API (optional - uses DEMO_KEY by default)
NASA_API_KEY=your-nasa-api-key

Set up LLM (Optional - for AI features)

Ensure you have access to any LLM model server.

Run development server

npm run dev

Open http://localhost:3000 in your browser.

Production Build

# Build for production
npm run build

# Start production server
npm start

🎯 Core Modules

1. Dashboard - 3D Earth Visualization

File: src/app/dashboard/page.tsx, src/components/EarthView.tsx

Features:

Real-time 3D Earth globe with orbital objects
Tracks 13,000+ satellites and 28,000+ debris objects
Visual risk zones showing high-density areas
Interactive object selection and information display
Filters for satellites, large debris, and small debris
Orbital path visualization
Conjunction detection with proximity alerts

Technology: Three.js, WebGL, custom orbital mechanics

Data Sources: NASA aggregated statistics, simulated orbital data

2. Space Weather Dashboard

File: src/app/spaceweather/page.tsx, src/app/api/weather/route.ts

Features:

Solar Flares: X/M/C-class event tracking with NOAA data
Geomagnetic Activity: Kp index monitoring with 24-hour forecasts
Solar Wind: Real-time speed, density, temperature, Bz/Bt magnetic field
CME Tracking: Coronal mass ejection detection with Earth-impact ETAs
Proton Events: Solar radiation storm monitoring
Aurora Forecasts: Visibility predictions for high/mid latitudes
Impact Analysis: Effects on satellites, aviation, power grids, GPS, communications
Weather Indices: Dst, radiation belt levels, ionospheric disturbance

Data Sources:

NASA DONKI API (Solar flares, CMEs)
NOAA Space Weather Prediction Center
Real-time magnetometer data
Planetary K-index feeds

Refresh: Auto-updates every 5 minutes

3. Launch Planner

File: src/app/planner/page.tsx, src/components/LaunchPlanner.tsx, src/app/api/planner/route.ts

Features:

Site Feasibility Analysis: Validates if a launch site can reach desired inclination
Debris Risk Scoring: Low/Moderate/High risk assessment based on altitude
Orbital Lifetime Estimation: Predicts satellite lifetime considering:
- Atmospheric drag (altitude, area-to-mass ratio)
- Solar cycle (min/max conditions)
- Ballistic coefficient
25-Year Rule Compliance: Automatic checking for deorbit requirements
Azimuth Calculations: Optimal launch trajectory angles
Alternative Sites: Smart suggestions (KSC, Vandenberg, Kourou, etc.)
Visual Orbit Preview: 3D visualization of planned orbit

Calculations:

King-Hele orbital decay model
Altitude-dependent scale height
Solar flux variations (F10.7 index)

4. AI Business Advisor

File: src/app/business/page.tsx, src/app/api/business/route.ts

Features:

Mission Feasibility Analysis: AI-powered viability assessment
Project Type Support:
- Communication Constellations
- Earth Observation
- Navigation/PNT
- Space Manufacturing
- Debris Removal
- In-Orbit Servicing
- Space Tourism
- R&D Missions
Partner Ecosystem: Integration suggestions across:
- PNT/Navigation (Xona, Aerodome, VyomIC)
- Earth Observation (Planet, Pixxel, Satellogic, Umbra)
- Ground Stations (KSAT, AWS, Azure)
- Communications (Mynaric, Viasat, Iridium)
- Launch Services (SpaceX, Rocket Lab)
- Analytics (SkyServe, Orbital Insight)
Proposal Generation: Complete business proposals with:
- Executive summary
- Market analysis
- Technical approach
- Risk assessment
- Timeline & budget breakdown
- Partner recommendations
PDF Export: Professional documents via jsPDF
Authentication Required: Protected by NextAuth

Technology: Any LLM model, runs 100% locally or remotely

5. Earth Observation

File: src/app/api/gibs/route.ts

Features:

NASA GIBS WMTS/WMS proxy
MODIS/VIIRS imagery layers
Time-series support
Tile-based streaming

📡 API Reference

Authentication

Most API endpoints are public. The /api/business endpoint requires authentication via NextAuth.

Space Weather API

Endpoint: GET /api/weather

Response:

{
  "solarFlare": {
    "latestFlare": {
      "class": "M2.5",
      "activeRegion": "AR3599",
      "location": "N15W45",
      "peakTime": "2025-11-22T14:32:00Z",
      "instruments": ["GOES-16", "GOES-18"]
    },
    "statistics": {
      "last24h": 12,
      "last72h": 38,
      "byClass": { "X": 1, "M": 8, "C": 29 }
    }
  },
  "coronalMassEjection": {
    "latest": {
      "speed": 850,
      "startTime": "2025-11-21T18:00:00Z",
      "type": "S"
    },
    "estimatedArrival": "2025-11-24T06:00:00Z"
  },
  "kpIndex": {
    "current": 4.33,
    "max24h": 6.67,
    "stormLevel": "Minor Storm (G1)",
    "forecastNext24h": [4.0, 4.5, 5.0, ...]
  },
  "solarWind": {
    "speed_km_s": 520,
    "density_p_cm3": 8.2,
    "temperature_k": 95000,
    "bz_nT": -3.5,
    "bt_nT": 8.2,
    "pressure_nPa": 2.8
  },
  "impacts": { ... },
  "aurora": { ... }
}

Caching: 15 minutes

Launch Planner API

Endpoint: POST /api/planner

Request Body:

{
  "siteLat": 28.573255,
  "siteLon": -80.646895,
  "altitudeKm": 500,
  "inclinationDeg": 53,
  "massKg": 200,
  "areaM2": 0.5
}

Response:

{
  "launchSiteAnalysis": {
    "userSite": "Custom Site",
    "feasible": true,
    "minInclinationRequired": 28.57,
    "azimuthRange": [45.2, 134.8],
    "bestAlternative": {
      "name": "Kennedy Space Center",
      "lat": 28.573255,
      "lon": -80.646895,
      "minIncl": 28.5,
      "feasible": true
    }
  },
  "debrisRisk": {
    "score": 6.5,
    "level": "moderate",
    "catalogDensityProxy": 0.65,
    "estimatedConjunctionsPerYear": 120,
    "notes": ["Moderate debris density at 500 km"]
  },
  "lifetimeYears": {
    "median": 8.5,
    "solarMin": 12.3,
    "solarMax": 4.2,
    "complies25yrRule": true
  },
  "recommendations": [
    "Consider active debris removal plan",
    "Implement collision avoidance maneuvers",
    "Install deorbit mechanism"
  ]
}

Business Advisor API

Endpoint: POST /api/business

Authentication: Required (NextAuth session)

Request Body:

{
  "projectName": "IndiaComm Constellation",
  "projectType": "Communication Constellation",
  "description": "Regional communication network for South Asia",
  "budget": "$50M - $100M",
  "timeline": "24-36 months",
  "partners": ["Ground Stations", "Launch Services"],
  "model": "any-llm-model"
}

Response:

{
  "result": "# LEO Commercialization Business Proposal\n\n## Executive Summary\n..."
}

Alerts API

Endpoint: GET /api/alerts

Response:

{
  "count": 3,
  "alerts": [
    {
      "a": "STARLINK-1234",
      "b": "DEBRIS-5678",
      "distance_km": 0.85,
      "time": "2025-11-22T15:30:00Z"
    }
  ]
}

TLE Data API

Endpoint: GET /api/tle

Response: TLE data from CelesTrak

GIBS Proxy API

Endpoint: GET /api/gibs

Query Parameters:

layer (required): GIBS layer name
time: ISO date string
wms: Flag for WMS mode
width, height, bbox: WMS parameters
tileMatrixSet, tileMatrix, tileRow, tileCol: WMTS parameters

Response: image/jpeg or image/png

🔐 Security & Privacy

Authentication

GitHub OAuth: Secure authentication via NextAuth
Session Management: HTTP-only cookies, secure tokens
Protected Routes: Business advisor requires authentication

AI Privacy

Local Inference: LLM runs on your infrastructure
No Data Leakage: Mission data never leaves your network
Model Isolation: Each session is independent

API Security

Rate Limiting: Built-in throttling for external APIs
Input Validation: All user inputs sanitized
CORS Configuration: Restricted cross-origin requests
Environment Variables: Secrets stored in .env.local (never committed)

Data Handling

Caching: 15-minute TTL reduces API load
No Persistence: Mission data not stored server-side
Client-Side Processing: Heavy computation in browser when possible

🔧 Troubleshooting

LLM Connection Issues

Problem: "Failed to connect to LLM server"

Solutions:

Ensure LLM server is running
Verify LLM_URL in .env.local matches server address
Check LLM is accessible
Restart Next.js dev server after LLM changes

CesiumJS Loading Errors

Problem: "Failed to load Cesium assets"

Solutions:

Verify public/cesium/ directory exists and is complete
Check browser console for specific asset errors
Clear browser cache and reload
Ensure static file serving is configured in next.config.ts

NASA API Rate Limits

Problem: "NASA API rate limit exceeded"

Solutions:

Get a free API key from api.nasa.gov
Add NASA_API_KEY to .env.local
Default DEMO_KEY has 30 requests/hour limit
Personal keys have 1000 requests/hour

Three.js Performance Issues

Problem: Low FPS in Dashboard view

Solutions:

Reduce number of visible objects using filters
Disable small debris visualization
Lower screen resolution or use smaller window
Update graphics drivers
Close other GPU-intensive applications

Build Errors

Problem: TypeScript or ESLint errors during build

Solutions:

Run npm install to ensure all dependencies are installed
Check tsconfig.json and eslint.config.mjs configurations
Build ignores are enabled by default in next.config.ts
Use npm run build -- --no-lint to skip linting

Authentication Issues

Problem: GitHub OAuth not working

Solutions:

Verify GITHUB_ID and GITHUB_SECRET in .env.local
Check OAuth app settings in GitHub Developer Settings
Ensure NEXTAUTH_URL matches your deployment URL
Add authorized callback URL: http://localhost:3000/api/auth/callback/github
Regenerate NEXTAUTH_SECRET: openssl rand -base64 32

📄 License

This project is licensed under the MIT License.

MIT License

Copyright (c) 2025 Spacia Project

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

🤝 Contributing

Contributions are welcome! Please follow these guidelines:

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Commit changes: git commit -m 'Add amazing feature'
Push to branch: git push origin feature/amazing-feature
Open a Pull Request

Development Guidelines

Follow TypeScript best practices
Maintain test coverage above 80%
Document all API endpoints
Use conventional commit messages
Ensure accessibility (WCAG 2.1 AA)

🙏 Acknowledgments

NASA: DONKI API, GIBS imagery
NOAA: Space Weather Prediction Center data
CelesTrak: TLE orbital element sets
CesiumJS: 3D geospatial platform
LLM Provider: Local LLM inference
Next.js Team: Amazing React framework
Space Community: Feedback and support

📞 Contact & Support

GitHub: Rahulgupta7777/nasa-space-project-Spacia
Issues: GitHub Issues
Discussions: GitHub Discussions

Name		Name	Last commit message	Last commit date
Latest commit History 47 Commits
public		public
src		src
submission		submission
.gitignore		.gitignore
README.md		README.md
eslint.config.mjs		eslint.config.mjs
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
patch_planner.py		patch_planner.py
patch_spaceweather.py		patch_spaceweather.py
postcss.config.mjs		postcss.config.mjs
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation

Spacia - LEO Business & Operations Platform

Problem Statement

Project Video

Watch the Video

📋 Table of Contents

✨ Page Highlights

🏠 Home Page

🌍 Dashboard (3D Earth View)

☀️ Space Weather

🚀 Launch Planner

💼 Business Advisor

🔄 Platform Flow

🧱 Tech Stack

Frontend

3D Visualization

AI & Machine Learning

Backend & APIs

Data & External Services

Development Tools

📂 Project Structure

🚀 Getting Started

Prerequisites

Installation

Production Build

🎯 Core Modules

1. Dashboard - 3D Earth Visualization

2. Space Weather Dashboard

3. Launch Planner

4. AI Business Advisor

5. Earth Observation

📡 API Reference

Authentication

Space Weather API

Launch Planner API

Business Advisor API

Alerts API

TLE Data API

GIBS Proxy API

🔐 Security & Privacy

Authentication

AI Privacy

API Security

Data Handling

🔧 Troubleshooting

LLM Connection Issues

CesiumJS Loading Errors

NASA API Rate Limits

Three.js Performance Issues

Build Errors

Authentication Issues

📄 License

🤝 Contributing

Development Guidelines

🙏 Acknowledgments

📞 Contact & Support

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages