shenshuu/tellurian

Tellurian is a web application that allows users to explore top news headlines from around the world by interacting with a 3D globe interface.

Tellurian

Live Demo

Tellurian is a web application that allows users to explore top news headlines from around the world by interacting with a 3D globe interface.

Features

• Interactive Globe: Users can spin and zoom in on a 3D globe to explore different countries.
• Country Selection: Users can select a country on the globe to view and save top news articles from that country.
• Top News Headlines: GlobeNews fetches and displays the latest top news headlines from various news sources for the selected country.

Getting Started

To get started with GlobeNews, follow these steps:

1. Clone the repository to your local machine:

   git clone https://github.com/your-username/tellurian.git
   

2. Install dependencies:

   cd tellurian
   npm install
   

3. Start the development server:

   npm run start
   

4. Open your browser and navigate to http://localhost:3000 to view the application.

Technologies Used

• React: Frontend framework for building user interfaces.
• d3.js: JavaScript library for data visualization, used to create the globe
• News API: Provides access to top news headlines from various news sources. -GNews API: Provides access to additional articles
• React Router: For handling navigation and routing within the application.
• axios: Promise-based HTTP client for making API requests.
• Bootstrap: CSS framework for building responsive and mobile-first websites. -Firebase: Framework for user authentication and database

License

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

Acknowledgements

Tellurian uses the following open-source libraries and APIs:

• d3.js
• News API
• GNews API
• React Router
• axios
• Bootstrap
• Firebase