{"id":23033924,"url":"https://github.com/dadvaiahpavan/newsaggregator","last_synced_at":"2026-05-09T00:32:28.990Z","repository":{"id":268876902,"uuid":"896905350","full_name":"DadvaiahPavan/NewsAggregator","owner":"DadvaiahPavan","description":"NewsAggregator is a full-stack web application that aggregates and summarizes news articles from various sources using React and Flask. Stay updated with the latest news and concise summaries in a user-friendly interface.","archived":false,"fork":false,"pushed_at":"2024-12-19T12:09:48.000Z","size":138,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-08T12:29:54.423Z","etag":null,"topics":["flask","fullstack-web-application","news-aggregator","news-summarization","nlp","react"],"latest_commit_sha":null,"homepage":"https://news-portal-cyan-iota.vercel.app/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DadvaiahPavan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-01T15:40:57.000Z","updated_at":"2024-12-19T12:09:51.000Z","dependencies_parsed_at":"2024-12-19T13:22:59.343Z","dependency_job_id":"b722f336-90e8-4494-9c33-0072df329b1d","html_url":"https://github.com/DadvaiahPavan/NewsAggregator","commit_stats":null,"previous_names":["dadvaiahpavan/newsaggregator"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DadvaiahPavan%2FNewsAggregator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DadvaiahPavan%2FNewsAggregator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DadvaiahPavan%2FNewsAggregator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DadvaiahPavan%2FNewsAggregator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DadvaiahPavan","download_url":"https://codeload.github.com/DadvaiahPavan/NewsAggregator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246899663,"owners_count":20851898,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["flask","fullstack-web-application","news-aggregator","news-summarization","nlp","react"],"created_at":"2024-12-15T16:20:21.300Z","updated_at":"2026-05-09T00:32:23.970Z","avatar_url":"https://github.com/DadvaiahPavan.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📰 Modern News Aggregator\n\nA sophisticated news aggregation platform built with React, Node.js, and modern web technologies. This application aggregates news from multiple sources, provides intelligent summaries, and offers a seamless reading experience.\n\n![News Aggregator Demo](https://i.ibb.co/j6JRD0L/Screenshot-2024-12-01-220015.png)\n\n## ✨ Features\n\n- 🔄 Real-time news aggregation from multiple trusted sources\n- 🤖 AI-powered article summarization\n- 📱 Responsive design for all devices\n- 🎯 Category-based news filtering\n- 🌙 Modern, clean UI with smooth animations\n- ⚡ Fast and efficient content delivery\n- 🔍 Smart content extraction and cleaning\n\n## 🚀 Tech Stack\n\n### Frontend\n- **React** - UI Framework\n- **TypeScript** - Type Safety\n- **TailwindCSS** - Styling\n- **React Router** - Navigation\n- **Axios** - HTTP Client\n- **Lucide React** - Icons\n\n### Backend\n- **Node.js** - Runtime\n- **Express** - Web Framework\n- **Cheerio** - Web Scraping\n- **Natural** - Text Processing\n- **Axios** - HTTP Client\n\n## 🛠️ Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/DadvaiahPavan/NewsAggregator.git\n   cd news-aggregator\n   ```\n\n2. **Install dependencies**\n   ```bash\n   # Install frontend dependencies\n   cd src\n   npm install\n\n   # Install backend dependencies\n   cd ../server\n   npm install\n   ```\n\n3. **Start the development servers**\n   ```bash\n   # Start backend server (from /server directory)\n   npm start\n\n   # Start frontend development server (from /src directory)\n   npm run dev\n   ```\n\n4. **Open your browser**\n   - Frontend: [http://localhost:5173](http://localhost:5173)\n   - Backend API: [http://localhost:3000](http://localhost:3000)\n\n## 🌟 Usage\n\n1. **Browse News**\n   - Visit the homepage to see trending news\n   - Use the navigation bar to filter news by category\n   - Scroll through the responsive article grid\n\n2. **Read Summaries**\n   - Click \"Summarize\" on any article to view AI-generated summary\n   - Access original articles via \"Read More\"\n\n3. **Mobile Experience**\n   - Fully responsive design\n   - Touch-friendly interface\n   - Mobile-optimized reading experience\n\n## 🎨 Key Components\n\n- **Article Cards**: Modern, interactive cards displaying news previews\n- **Smart Navbar**: Category-based navigation with mobile responsiveness\n- **Summary Generator**: AI-powered content summarization\n- **Content Extractor**: Intelligent article content extraction\n- **Category Filters**: Easy news filtering by topics\n\n## 🔧 Configuration\n\nCreate a `.env` file in the server directory:\n\n```env\nPORT=3000\nNODE_ENV=development\n# Add any API keys or secrets here\n```\n\n## 📈 Performance Optimizations\n\n- Efficient content caching\n- Lazy loading of images\n- Code splitting\n- Optimized build process\n- Smart data fetching\n\n## 🔒 Security Features\n\n- Input sanitization\n- Rate limiting\n- CORS protection\n- Error handling\n- Secure HTTP headers\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 👏 Acknowledgments\n\n- News data providers\n- Open-source community\n- UI/UX inspiration sources\n- Contributors and testers\n\n## 📞 Support\n\nFor support, email pavannetha219@gmail.com or open an issue in the repository.\n\n## 🚀 Deployment Instructions\n\n### Backend Deployment (Render/Heroku)\n\n1. Create a new account on Render.com or Heroku\n2. Create a new Web Service\n3. Connect your GitHub repository\n4. Set the following:\n   - Build Command: `npm install`\n   - Start Command: `node server/server.js`\n   - Environment Variables:\n     ```\n     NODE_ENV=production\n     PORT=3000\n     ```\n\n### Frontend Deployment (Netlify)\n\n1. Create a new account on Netlify\n2. Connect your GitHub repository\n3. Set the following build settings:\n   - Base directory: `src`\n   - Build command: `npm run build`\n   - Publish directory: `src/dist`\n4. Add environment variables:\n   ```\n   VITE_API_URL=https://your-backend-url.com\n   ```\n\n### Local Development\n\n1. Clone the repository\n2. Install dependencies:\n   ```bash\n   # Install backend dependencies\n   cd server\n   npm install\n\n   # Install frontend dependencies\n   cd ../src\n   npm install\n   ```\n3. Start the development servers:\n   ```bash\n   # Start backend (from server directory)\n   npm start\n\n   # Start frontend (from src directory)\n   npm run dev\n   ```\n\n## Deployment Steps\n\n1. Push your code to GitHub\n2. Deploy the backend:\n   - Create a new web service on Render/Heroku\n   - Connect your repository\n   - Configure environment variables\n   - Deploy the service\n   - Copy the deployed URL\n\n3. Deploy the frontend:\n   - Log in to Netlify\n   - Import your repository\n   - Configure build settings\n   - Set the VITE_API_URL environment variable to your backend URL\n   - Deploy the site\n\n4. Test the deployed application\n\n## Environment Variables\n\n### Backend\n- `NODE_ENV`: Set to 'production' in production\n- `PORT`: Port number (default: 3000)\n\n### Frontend\n- `VITE_API_URL`: URL of the backend API\n\n## Monitoring and Maintenance\n\n- Monitor server logs through your hosting platform\n- Check API response times and errors\n- Monitor resource usage\n- Set up alerts for critical errors\n\n---\n\nMade with ❤️ by Pavan Dadvaiah\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdadvaiahpavan%2Fnewsaggregator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdadvaiahpavan%2Fnewsaggregator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdadvaiahpavan%2Fnewsaggregator/lists"}