DNewsApp

A next-generation news aggregator built for speed, clarity, and global reach.
Explore the Live Demo »

Report Bug · Request Feature

---

📋 Table of Contents

1. About The Project
2. Key Features
3. Technical Architecture
4. Getting Started
5. Roadmap
6. Contact

---

⚡ About The Project

DNewsApp redefines how users consume daily information. Moving away from cluttered, ad-heavy news sites, this application provides a minimalist, focus-driven interface that aggregates headlines from the world's most trusted sources.

Built with the T3 stack philosophy in mind (Type-Safe, Performant), DNewsApp ensures that staying updated is seamless, whether you are reading in English or German.

---

🚀 Key Features

Feature	Description
🌍 Multi-Language Support	New: Toggle instantly between English and German content streams for a localized reading experience.
🔥 Real-Time Feeds	Instant integration with NewsAPI to fetch breaking news as it happens.
📱 Adaptive UI	A "Glassmorphism" inspired design that adapts perfectly to any screen size using Tailwind CSS.
⚡ Blazing Fast	Powered by Vite, ensuring near-instant load times and HMR (Hot Module Replacement).
🗂 Smart Categories	Filter effortlessly between Tech, Business, Sports, Health, and Entertainment.

---

🏗 Technical Architecture

The project is structured to ensure scalability and maintainability.

DNewsApp/
├── public/              # Static assets
├── src/
│   ├── components/      # Reusable UI components (Navbar, NewsCard, Spinner)
│   ├── assets/          # Images and global styles
│   ├── App.tsx          # Main Layout & Routing Logic
│   ├── main.tsx         # Entry point
│   └── vite-env.d.ts    # TypeScript declarations
├── tailwind.config.ts   # Design token configuration
└── package.json         # Dependency manifest

---

🛠️ Getting Started

Follow these steps to set up the environment locally.

Prerequisites

• Node.js (v16+) or Bun (v1.0+)
• NewsAPI Key (Get it for free at newsapi.org)

Installation

1. Clone the Repo

   git clone [https://github.com/Divyamsharma-18/DNewsApp.git](https://github.com/Divyamsharma-18/DNewsApp.git)

2. Install Dependencies (I recommend using Bun for speed)

   cd DNewsApp
   bun install 
   # or npm install

3. Environment Setup Create a .env file in the root directory:

   VITE_NEWS_API_KEY=your_secret_key_here

4. Ignition

   bun dev
   # or npm run dev

---

🔮 Roadmap & Future Improvements

• Expanded Localization: Add support for Spanish and French news sources.
• Dark Mode Toggle: Implement system-preference detection for dark mode.
• Search Functionality: Allow users to search for specific keywords or topics.
• Bookmarks: Use LocalStorage to save "Read Later" articles.

---

📞 Contact

Divyam Sharma

• GitHub: @Divyamsharma-18
• Project Link: https://github.com/Divyamsharma-18/DNewsApp

Built with ❤️ by Divyam Sharma

German Version