Skip to content

Dushxn/Cosmic-Wanderer

Repository files navigation

🌌 Cosmic Wanderer

Cosmic Wanderer is an immersive web application that brings the wonders of space exploration to your fingertips. Leveraging NASA's public APIs, it offers real-time access to astronomical data, captivating imagery, and detailed information about celestial bodies.


💻 Live Demo

🚀 Features

  • 📷 Astronomy Picture of the Day (APOD): View NASA's daily space photo with a description.
  • 🚜 Mars Rover Photos: Browse stunning images taken by rovers like Curiosity, Spirit, and Opportunity.
  • 🌍 Earth Imagery: Fetch satellite images of any location on Earth using coordinates and dates.
  • 🛰️ EPIC Camera: Explore Earth as seen from the DSCOVR satellite’s EPIC camera.
  • ☄️ Near Earth Objects (NEO): Get insights on asteroids and comets approaching Earth.
  • 🧪 NASA TechPort: Discover NASA's current and historical technology projects.

🛠️ Tech Stack

  • Framework: Next.js
  • Language: TypeScript
  • Styling: Tailwind CSS
  • State: React Hooks
  • API: NASA Open APIs
  • Package Manager: npm

📦 Installation

# Clone the repository
git clone https://github.com/Dushxn/Cosmic-Wanderer.git
cd Cosmic-Wanderer

# Install dependencies
npm install

# Setup environment variables
touch .env.local

# Then add your NASA API key inside .env.local:
NEXT_PUBLIC_NASA_API_KEY=your_api_key_here

# Now, run the development server:
npm dev
# Open http://localhost:3000 in your browser.

📂Folder Structure

Cosmic-Wanderer/
├── app/                  # Application routes and pages
├── components/           # Reusable UI components
├── hooks/                # Custom hooks
├── lib/                  # API logic and utilities
├── public/               # Static assets
├── styles/               # Tailwind CSS and global styles
└── .env.local            # Environment variables (not committed)

📄 License

This project is licensed under the MIT License.

🙌 Acknowledgements

NASA Open APIs
Next.js
Tailwind CSS

Made with 🌠 by @Dushxn


You can copy this and paste it directly into your `README.md` file. Let me know if you’d like badges, a logo, or project screenshots added as well!