📚 Content Aggregator

A Django-based web application that aggregates News, Technology Articles, and Stock Market information into a single dashboard using RSS feeds and external APIs.

---

📖 About

Content Aggregator is a web application built with Django that collects content from multiple sources and presents it in one place. It provides users with the latest news, technology articles, and stock market updates through a clean and responsive interface.

---

✨ Features

• 📰 Latest News Feed
• 💻 Programming & Technology Articles
• 📈 NSE Top Gainers & Losers
• 📡 RSS Feed Integration
• ⚡ Fast and lightweight Django application
• 📱 Responsive user interface

---

🛠 Tech Stack

Category	Technologies
Backend	Django 3.2
Language	Python
Frontend	HTML, CSS, JavaScript
Data Sources	RSS Feeds, External APIs
Deployment	Render
Server	Gunicorn
Static Files	WhiteNoise

---

🚀 Live Demo

🔗 https://contentaggregator.onrender.com

---

📂 Project Structure

contentAggregator/
│
├── contentAggregator/      # Django project configuration
├── news/                   # News module
├── tech/                   # Technology articles module
├── stocks/                 # Stock market module
├── static/                 # Static assets
├── manage.py
├── requirements.txt
└── README.md

---

⚙️ Getting Started

1. Clone the Repository

git clone https://github.com/shaanguptaa/contentAggregator.git
cd contentAggregator

2. Create a Virtual Environment

Windows

python -m venv venv
venv\Scripts\activate

Linux/macOS

python3 -m venv venv
source venv/bin/activate

---

3. Install Dependencies

pip install -r requirements.txt

---

4. Create a .env File

Create a .env file in the project root.

SECRET_KEY=your-secret-key
DEBUG=True
ALLOWED_HOSTS=127.0.0.1,localhost

---

5. Apply Database Migrations

python manage.py migrate

---

6. Run the Development Server

python manage.py runserver

Open your browser and visit:

http://127.0.0.1:8000/

---

📸 Screenshots

🏠 Home

---

📰 News

---

💻 Technology

---

📈 Stocks

---

🗺 Roadmap

• News Feed
• Technology Articles
• RSS Feed Integration
• Stock Market Dashboard
• Replace nsetools with a maintained alternative
• Search functionality
• Dark Mode
• Bookmark favorite articles
• Improve UI/UX

---

⚠ Known Issues

• The nsetools library is currently incompatible due to changes made by the NSE website.
• Stock market data may occasionally fail until the library is replaced.

---

🤝 Contributing

Contributions are welcome!

1. Fork this repository
2. Create your feature branch

git checkout -b feature/my-feature

3. Commit your changes

git commit -m "Add my feature"

4. Push to the branch

git push origin feature/my-feature

5. Open a Pull Request

---

📄 License

This project is licensed under the MIT License.

See the LICENSE file for more information.

---

⭐ If you found this project useful, consider giving it a star!

Made with ❤️ using Django