Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🌌 Cosmic Watch

A full-stack web platform for real-time monitoring and risk analysis of Near-Earth Objects (NEOs) using NASA’s NeoWs API.


📖 About The Project

Cosmic Watch is designed to make asteroid tracking data accessible and understandable.
NASA provides accurate NEO datasets, but they are often raw and difficult to interpret for non-experts.

This platform transforms that data into:

  • Structured dashboards
  • Simplified risk classifications
  • Personalized watchlists
  • Real-time close-approach monitoring

The goal is to combine clean system architecture, secure authentication, and clear data presentation into a production-ready full-stack application.


✨ Core Features

🔐 Authentication

  • Secure user registration & login
  • JWT-based authentication
  • Password hashing
  • Protected routes

☄️ Real-Time NEO Feed

  • Live integration with NASA NeoWs API
  • Displays:
    • Asteroid name
    • Diameter
    • Velocity
    • Miss distance
    • Hazardous status

⚠️ Risk Analysis Engine

Asteroids are categorized using:

  • NASA hazardous flag
  • Estimated diameter thresholds
  • Miss distance from Earth

Risk levels are calculated and displayed in a simplified format for quick understanding.

⭐ Watchlist System

  • Add asteroids to personal watchlist
  • Remove tracked objects
  • View monitored objects in dashboard

🔔 Close Approach Alerts

  • Highlights upcoming close approaches
  • Dashboard-based alert visualization

🐳 Dockerized Setup

  • Multi-service architecture
  • One-command setup using Docker Compose

🏗️ Architecture Overview

Frontend (React) ↓ Backend REST API (Node.js / Express) ↓ NASA NeoWs API ↓ MongoDB Database

  • Frontend and backend are fully separated
  • RESTful API structure
  • Stateless authentication using JWT
  • Containerized deployment

🛠 Tech Stack

Frontend

  • React.js
  • Tailwind CSS
  • Axios

Backend

  • Node.js
  • Express.js
  • JWT Authentication
  • REST API Design

Database

  • MongoDB
  • Mongoose

DevOps

  • Docker
  • Docker Compose
  • Git

External API

  • NASA NeoWs (Near Earth Object Web Service)

📂 Project Structure

cosmic-watch/ │ ├── frontend/ │ ├── src/ │ ├── components/ │ └── pages/ │ ├── backend/ │ ├── controllers/ │ ├── routes/ │ ├── middleware/ │ └── models/ │ ├── docker-compose.yml ├── AI-LOG.md └── README.md


⚙️ Getting Started

1️⃣ Clone the Repository

git clone https://github.com/your-username/cosmic-watch.git
cd cosmic-watch

Releases

Packages

Contributors

Languages