NewsQuest is a next-generation, gamified news platform that transforms passive news reading into an interactive, competitive, and intelligent experience.
Instead of just scrolling headlines, users:
- 🎮 Play through news like a game
- 🧪 Test knowledge with quizzes
- 🔮 Predict real-world outcomes
- 📈 Track progress with XP & streaks
- 🏆 Compete on leaderboards
Traditional news platforms are:
- ❌ Passive
- ❌ Hard to retain
- ❌ Not engaging
NewsQuest makes news:
- ✅ Interactive
- ✅ Fun
- ✅ Educational
- ✅ Addictive (in a good way)
- Bite-sized, structured news
- Clean UI for fast reading
- Categories like Polity, Economy, Tech
- 2–3 MCQs per article
- Instant feedback + explanations
- XP rewards for correct answers
- Predict future outcomes of real-world events
- Confidence-based answering
- Accuracy tracking over time
- Compete with other users in real-time
- Answer questions faster and more accurately
- Earn bonus XP and rank higher
-
Earn XP by:
- Reading news
- Solving quizzes
- Making predictions
-
Level up as you progress
- Daily activity tracking
- Rewards for consistency
- Encourages habit building
- Global ranking system
- Based on XP and performance
- Weekly competition resets
-
Complete tasks like:
- Read articles
- Take quizzes
- Make predictions
-
Earn bonus rewards
NewsQuest uses advanced AI to generate:
- 🧪 Quiz questions
- 🔮 Prediction scenarios
- Qwen API → For intelligent content generation
- NewIO API → For dynamic processing and responses
- Authentication
- Database storage
- Real-time updates
Stores:
- User progress
- XP & levels
- Quiz results
- Predictions
- Leaderboard data
- Read news 📰
- Take quiz 🧪
- Make prediction 🔮
- Earn XP ⭐
- Maintain streak 🔥
- Climb leaderboard 🏆
- Repeat 🔁
- Dark theme with neon accents
- Smooth animations
- Game-like interface
- Mobile-first design
- AI-powered summaries
- Voice-based news (TTS)
- Avatar progression system
- Multiplayer challenges
- Personalized recommendations
NewsQuest/
│── src/
│ ├── components/
│ ├── pages/
│ ├── services/
│ ├── utils/
│── public/
│── README.md👉 Combines news + gaming + AI + prediction 👉 Encourages critical thinking 👉 Builds daily learning habits
NewsQuest is not just a news app — it's a learning game.
“Don’t just read the news. Play it. Predict it. Master it.” 🚀
- Node.js 18 or newer
- npm
- Internet access for live news APIs
frontend/- React app, UI, and client-side statebackend/- News API, enrichment API, and content generation endpoints
- Install dependencies in both folders:
cd backend && npm installcd frontend && npm install
- Make sure the backend environment file exists:
backend/.env.localshould containNEWSDATA_API_KEY- You can copy values from
backend/.env.exampleand fill in your key
- Start the backend first:
cd backend && npm run start- Default backend URL:
http://127.0.0.1:3001
- Start the frontend in a second terminal:
cd frontend && npm run dev- Default frontend URL:
http://127.0.0.1:4000
- The frontend uses
/apiin development and Vite proxies it to the backend automatically. - If you want to point the frontend to a hosted backend, set
VITE_API_URLinfrontend/.env. - If you see
ECONNREFUSED 127.0.0.1:3001, the backend is not running yet.
Frontend:
cd frontend && npm run devcd frontend && npm run buildcd frontend && npm run lintcd frontend && npm run test
Backend:
cd backend && npm run startcd backend && npm run buildcd backend && npm run typecheck