Tellurian is a web application that allows users to explore top news headlines from around the world by interacting with a 3D globe interface.
![](https://private-user-images.githubusercontent.com/26040264/329357108-2e99f291-975e-4a91-a624-bd4363da0db8.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjM4NTQ1MDQsIm5iZiI6MTcyMzg1NDIwNCwicGF0aCI6Ii8yNjA0MDI2NC8zMjkzNTcxMDgtMmU5OWYyOTEtOTc1ZS00YTkxLWE2MjQtYmQ0MzYzZGEwZGI4LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA4MTclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwODE3VDAwMjMyNFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTlhMTIzMWIyOGNmZmE3Nzc5YmExMDhmMjkzZjE3N2M2N2RjMmRmMDdhN2E1ZWRiMjdkZjg0MmJiMDRjZDg3ODYmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.heA8p7avNh7P2P4XWpgrT35nViva_AN5KBY5LMw9f70)
- 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.
To get started with GlobeNews, follow these steps:
-
Clone the repository to your local machine:
git clone https://github.com/your-username/tellurian.git
-
Install dependencies:
cd tellurian npm install
-
Start the development server:
npm run start
-
Open your browser and navigate to
http://localhost:3000
to view the application.
- 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
This project is licensed under the MIT License - see the LICENSE file for details.
Tellurian uses the following open-source libraries and APIs: