Skip to content

itzharshit99/Headline-Hub

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Headline Hub

Project Overview

The Headline Hub is a web application that fetches and displays news from newsapi.org. Users can explore top headlines, country-specific news, and more. The application is designed to provide a seamless and responsive user experience.

Features

  • Fetch top headlines from various categories.
  • Browse country-specific news.
  • Interactive and user-friendly interface.
  • Fully responsive design for desktop and mobile devices.

Screenshots

Screenshot 2024-12-22 160718

Screenshot 2024-12-22 160751

Screenshot 2024-12-22 160804

Tech Stack

  • Frontend: React.js, Tailwind CSS
  • Backend: Node.js
  • API: NewsAPI (https://newsapi.org)
  • HTTP Client: Axios

Installation and Setup

Prerequisites

  • Node.js installed on your machine.
  • A valid API key from newsapi.org.

Steps to Run the Project

  1. Clone the repository:

    git clone https://github.com/itzharshit99/Headline-Hub.git
    cd headline-hub
  2. Install dependencies:

    # Install frontend dependencies
    cd client
    npm install
    
    # Install backend dependencies
    cd ../server
    npm install
  3. Set up environment variables:

    • Create a .env file in the server directory and add the following:
      API_KEY=your_api_key_here
      PORT=3000
  4. Start the development servers:

    # Start the backend server
    cd server
    nodemon server.js
    
    # Start the frontend server
    cd ../client
    npm run dev
  5. Open your browser and navigate to http://localhost:3000.

  6. API Integration

The project integrates with NewsAPI for fetching news data. Axios is used for making HTTP requests.

Future Enhancements

  • Add search functionality to find news by keyword.
  • Add user preferences for personalized news feeds.

Contributions

Contributions, issues, and feature requests are welcome! Feel free to check out the issues page.

License

This project is licensed under the MIT License.

Acknowledgments

  • newsapi.org for providing the news data.
  • Open-source libraries and tools used in this project.

Feel free to reach out with any questions or feedback about this project!

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published