Skip to content

njange/NewsApp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📰 NewsApp

React Vite JavaScript HTML5 Vercel


🌍 Live Demo

🌐 Check out the live app


📌 Project Overview

NewsApp is a modern and responsive web application that displays the latest news from various categories using a sleek and minimalist interface. It leverages the power of React, Vite, and News API to fetch and display real-time news articles.


✨ Features

  • 📰 Browse the latest headlines
  • 🔍 Search for news by keywords
  • 🌐 Filter news by categories (e.g., sports, tech, entertainment)
  • 📱 Fully responsive design
  • ⚡ Lightning-fast performance with Vite

🛠️ Tech Stack

  • Frontend: React, JavaScript, HTML5, CSS
  • Build Tool: Vite
  • Deployment: Vercel
  • API: NewsAPI.org

🗆️ Screenshots

Home Category


✨ Getting Started

Prerequisites

  • Node.js (v14 or later)
  • NPM or Yarn

Installation

# Clone the repository
git clone https://github.com/njange/NewsApp.git

# Navigate to the project directory
cd NewsApp

# Install dependencies
npm install

Running the App

# Start the development server
npm run dev

Visit http://localhost:5173 to view it in the browser.


🧹 Project Structure

NewsApp/
│
├── public/               # Static assets
├── src/                  # Source code
│   ├── components/       # Reusable components
│   ├── pages/            # Page components
│   └── App.jsx           # Main app component
│
├── .env                  # API keys and environment variables
├── package.json          # Project metadata and scripts
├── vite.config.js        # Vite configuration
└── README.md             # Project documentation

🔐 Environment Variables

Create a .env file in the root directory and add your API key:

VITE_NEWS_API_KEY=your_news_api_key_here

You can get a free API key from https://newsapi.org/.


🌐 Deployment

This app is deployed on Vercel. To deploy your own version:

  1. Push the code to GitHub.
  2. Import the repository into Vercel.
  3. Set the environment variable for VITE_NEWS_API_KEY.
  4. Click Deploy.

🤝 Contributing

Contributions are welcome! Please fork the repo and submit a pull request.


📄 License

This project is licensed under the MIT License.


📢 Contact

Developer: James Njange

📧 Email: njangejames@gmail.com 🔗 LinkedIn: linkedin.com/in/njange


About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors