Our Interactive Orrery Web Application brings space exploration to your fingertips by visualizing near-Earth objects and planets in our solar system. It serves as an educational tool that allows users to:
- ๐ View real-time positions of planets and near-Earth objects.
- Experience a ๐ dynamic simulation that shows their movements over time.
- Explore ๐ educational tooltips packed with fascinating facts about celestial bodies.
- Navigate easily with ๐ zoom controls for better exploration.
- Participate in ๐ฎ quizzes and challenges to test and deepen your space knowledge.
We aim to make space education engaging and accessible by providing an interactive learning experience. Users can explore space through visual learning and access informational articles to broaden their knowledge.
- ๐ช Interactive Visualization: Real-time positions of celestial bodies.
- ๐ Dynamic Simulation: Illustrating movements over time.
- ๐ Educational Tooltips: Facts about planets, asteroids, and near-Earth objects.
- ๐ User-Friendly Controls: Zoom in/out to explore different regions of the solar system.
- ๐ฏ Quizzes & Challenges: Engaging activities to test users' knowledge.
- ๐ป JavaScript: For both front-end and back-end development.
- โ๏ธ React.js: To manage the UI and components efficiently.
- ๐ Three.js: For creating 3D visualizations of the solar system.
- ๐จ CSS: To create a visually appealing interface.
Check out the deployed version of the application here. ๐๐
Make sure you have the following installed on your machine:
- Node.js: Download and install Node.js ๐
- npm: Installed with Node.js or you can get it from npm's website ๐ ๏ธ
Follow these steps to run the project locally:
- Clone the repository ๐:
git clone https://github.com/your-usernamePharoh-s-StarCode.git
cd Pharoh-s-StarCode
- Install the dependencies ๐:
npm install
- Start the development server ๐:
npm run dev
- Visit the application in your browser ๐:
http://localhost:3000
Here are some of the key resources and APIs we used in building the project:
- NASA API: ๐ NASA's Near Earth Object Web Service
- Three.js: ๐ Three.js Documentation
- React Documentation: โ๏ธ React Official Docs
- NEO API from NASA: We used this API to retrieve the Near-Earth objects data.
- JPL Approximate Positions: ๐ JPL Approximate Positions - We used this website to scale the data so we can display it in approximately real scale.
- NASA Eyes on Asteroids: ๐ Eyes on Asteroids - We used this tool to try to display asteroids in a similar way.
Important
To contribute, Fork this repository, create a new branch from the main branch, make your changes, and submit a pull request.
Include a description of your changes in the pull request description.
Ahmed Fathy |
Abdallah Ahmed |
Rahma Fathy |
Ammar Yasser |
Habiba Mahmoud |
Mohammed Gamil |