Skip to content

rohit-bytesview/newsdata-universal-app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

image (3)

📰 NewsData Universal App

A comprehensive news aggregator built with React.js and NewsData.io API. Browse Latest, Crypto, Market, and Archive news with advanced filtering by country, category, and language.

✨ Features

  • 4 News Endpoints: Latest, Crypto, Market, Archive
  • Advanced Filters: Category, Country, Language, Search
  • Auto-refresh: Updates every 60 seconds (toggleable)
  • Pagination: Load more with seamless scrolling
  • Responsive Design: Works on desktop, tablet, mobile
  • Clean UI: Modern, intuitive interface

🚀 Quick Start

Prerequisites

  • Node.js 18+ and npm

Installation

# 1. Extract and navigate
cd newsdata-universal-app

# 2. Install dependencies
npm install

# 3. Configure API key
cp .env.example .env
nano .env
# Add: REACT_APP_NEWSDATA_API_KEY=your_key_here

# 4. Start the app
npm start

The app opens at http://localhost:3000

📖 Usage

Get Your API Key

  1. Visit https://newsdata.io/register
  2. Sign up (free tier available)
  3. Copy your API key
  4. Add to .env file

Navigation

  • 📰 Latest News: General news from all categories
  • ₿ Crypto News: Cryptocurrency-specific news
  • 📈 Market News: Financial market news
  • 📚 Archive: Historical news search

Filters

  • Search: Find specific topics
  • Category: Business, Tech, Sports, etc.
  • Country: 30+ countries available
  • Language: 15+ languages supported

🎯 Real-World Use Cases

Perfect for:

  • News Junkies: All news in one place
  • Researchers: Quick country/category filtering
  • Professionals: Business + Crypto news together
  • Students: Current affairs preparation
  • Content Creators: Find trending topics

🛠️ Tech Stack

  • React 18
  • React Router 6
  • Axios
  • CSS3
  • NewsData.io API

📁 Project Structure

src/
├── components/
│   ├── Header.js         # Top navigation
│   ├── Sidebar.js        # Filters & endpoints
│   ├── NewsCard.js       # Article display
│   └── Pagination.js     # Load more
├── pages/
│   └── NewsPage.js       # Main news view
├── services/
│   └── api.js            # API integration
├── constants/
│   └── index.js          # Categories, countries
└── App.js                # Main component

🔧 Configuration

Environment Variables

REACT_APP_NEWSDATA_API_KEY=your_key
REACT_APP_NEWSDATA_BASE_URL=https://newsdata.io/api/1
REACT_APP_AUTO_REFRESH_INTERVAL=60

🤝 Contributing

Contributions welcome! Please read CONTRIBUTING.md first.

📄 License

MIT License - see LICENSE file

🔗 Links


Made with ❤️ using NewsData.io API

About

A React news app that uses NewsData.io API to deliver latest, crypto, market & archive news. Filter by category, country, or language. Includes auto-refresh, pagination, and a clean responsive design. Built for anyone who wants all their news in one convenient place.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors