Skip to content

gideonabe/news_today

Repository files navigation

NewsToday Banner

NewsToday

NewsToday is a modern, responsive news website built with Next.js 13, React, Redux, and Tailwind CSS. It features a dynamic navbar, dark/light mode toggle, mobile-friendly design, and a clean, user-friendly interface for browsing news across multiple categories. News are fetched through google news api endpoint based on different categories and search queries.


Table of Contents


Features

  • Fully responsive design (mobile, tablet, desktop)
  • Dark and light theme toggle
  • Dynamic navigation bar with:
    • Logo
    • Search bar (centered on tablet/iPad)
    • Notifications
    • Profile avatar
    • Hamburger menu for mobile and tablet
  • Multi-category navigation: Top Stories, World, Politics, Business, Tech, Culture
  • Hamburger menu overlays content (does not push it down)
  • Smooth animations for opening/closing menus
  • LocalStorage theme persistence

Demo

You can check the live demo here: https://newstoday-nu.vercel.app/


Screenshots

Desktop

Desktop Screenshot

Tablet/iPad

Tablet Screenshot

Mobile

Mobile Screenshot


Technologies Used


Installation

  1. Clone the repository:

    git clone https://github.com/gideonabe/news_today.git

  2. Navigate into the project directory

    cd news_today

  3. Install dependicies

npm install yarn install

  1. Run the development server

npm run dev yarn dev

  1. Open http://localhost:3000 in your browser.

Usage

  • Toggle Theme: Click the Moon/Sun icon to switch between light and dark mode.

  • Search: Use the search input to fetch news based on input keywords.

  • Hamburger Menu: On mobile and tablet, click the hamburger to open the navigation menu overlay.

  • Navigation: Click menu items to navigate diffent news categories.

  • Categories: works like the nav menus, click on any of the categories to see different news articles based on selected category

  • News Details: click on the "Read more" button or any of the news article to see more details about it, you can also check other related articles in the same page.


Contributing

Contributions are welcome!

  • Fork the repository

  • Create a new branch: git checkout -b feature-name

  • Make your changes and commit: git commit -m "Add new feature"

  • Push to your branch: git push origin feature-name

  • Open a Pull Request


License

This project is licensed under the MIT License.

About

a news feed page using the Google News API that displays latest headlines + search + category filter and shows loading and error states

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors