NMAI Current Affairs - Full Stack Website

A complete full-stack web application for current affairs and competitive exam preparation with Daily Current Affairs, MCQs, User Authentication, Admin Panel, and Google AdSense integration.

🚀 Features

Frontend

✅ Responsive React-based UI
✅ Daily Current Affairs with filtering & search
✅ MCQ Practice with instant results
✅ User Authentication (Register/Login)
✅ User Dashboard with saved articles
✅ Category-wise content organization
✅ Exam-specific filtering (UPSC, SSC, Banking, etc.)
✅ Newsletter subscription
✅ SEO optimized pages
✅ Google AdSense ready

Backend

✅ RESTful API with Express.js
✅ MongoDB database with Mongoose
✅ JWT authentication
✅ Role-based access control (User/Author/Admin)
✅ Article management system
✅ MCQ management with statistics
✅ User profile management
✅ Newsletter system
✅ Admin dashboard

Admin Panel

✅ Dashboard with statistics
✅ Article creation & management
✅ MCQ creation & management
✅ User management
✅ Content moderation

📋 Prerequisites

Node.js (v14 or higher)
MongoDB (local or Atlas)
npm or yarn

🛠️ Installation

1. Clone the repository

git clone https://github.com/yourusername/nmai-website.git
cd nmai-website

2. Backend Setup

cd backend

# Install dependencies
npm install

# Create .env file
cp .env.example .env

# Edit .env with your configuration
nano .env

Required Environment Variables (.env):

PORT=5000
NODE_ENV=development
MONGODB_URI=mongodb://localhost:27017/nmai-current-affairs
JWT_SECRET=your-super-secret-jwt-key-change-this
JWT_EXPIRE=7d
FRONTEND_URL=http://localhost:3000
ADMIN_EMAIL=admin@nmai.in
ADMIN_PASSWORD=Admin@123

For MongoDB Atlas (Production):

MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/nmai

3. Frontend Setup

cd ../frontend

# Install dependencies
npm install

🚀 Running the Application

Development Mode

Terminal 1 - Backend:

cd backend
npm run dev
# Server runs on http://localhost:5000

Terminal 2 - Frontend:

cd frontend
npm start
# App opens on http://localhost:3000

Production Build

Backend:

cd backend
npm start

Frontend:

cd frontend
npm run build
# Serve the build folder with a static server

📦 Database Seeding (Optional)

To populate the database with sample data:

cd backend
npm run seed

This creates:

Sample articles
Sample MCQs
Admin user
Test users

🔑 Default Admin Credentials

Email: admin@nmai.in
Password: Admin@123

⚠️ IMPORTANT: Change these in production!

📁 Project Structure

nmai-website/
├── backend/
│   ├── models/
│   │   ├── Article.js
│   │   ├── MCQ.js
│   │   └── User.js
│   ├── routes/
│   │   ├── articles.js
│   │   ├── mcqs.js
│   │   ├── auth.js
│   │   ├── users.js
│   │   ├── newsletter.js
│   │   └── admin.js
│   ├── middleware/
│   │   └── auth.js
│   ├── .env.example
│   ├── package.json
│   └── server.js
├── frontend/
│   ├── public/
│   ├── src/
│   │   ├── components/
│   │   ├── pages/
│   │   ├── services/
│   │   ├── utils/
│   │   ├── App.js
│   │   └── index.js
│   └── package.json
└── README.md

🔌 API Endpoints

Authentication

POST /api/auth/register - Register new user
POST /api/auth/login - Login user
GET /api/auth/me - Get current user
PUT /api/auth/update-profile - Update profile
PUT /api/auth/change-password - Change password
POST /api/auth/forgot-password - Request password reset
POST /api/auth/reset-password/:token - Reset password

Articles

GET /api/articles - Get all articles (with filters)
GET /api/articles/latest - Get latest articles
GET /api/articles/trending - Get trending articles
GET /api/articles/:slug - Get single article
GET /api/articles/category/:category - Get by category
POST /api/articles - Create article (Admin/Author)
PUT /api/articles/:id - Update article (Admin/Author)
DELETE /api/articles/:id - Delete article (Admin)

MCQs

GET /api/mcqs - Get all MCQs (with filters)
GET /api/mcqs/daily-quiz - Get random 10 MCQs
POST /api/mcqs/submit - Submit quiz answers
GET /api/mcqs/categories - Get categories
GET /api/mcqs/stats - Get statistics
POST /api/mcqs - Create MCQ (Admin/Author)
PUT /api/mcqs/:id - Update MCQ (Admin)
DELETE /api/mcqs/:id - Delete MCQ (Admin)

Users

POST /api/users/save-article/:id - Save article
DELETE /api/users/save-article/:id - Unsave article
GET /api/users/saved-articles - Get saved articles
GET /api/users/quiz-history - Get quiz history

Newsletter

POST /api/newsletter/subscribe - Subscribe
POST /api/newsletter/unsubscribe - Unsubscribe

Admin

GET /api/admin/dashboard-stats - Dashboard statistics
GET /api/admin/users - Get all users
PUT /api/admin/users/:id - Update user
DELETE /api/admin/users/:id - Delete user

🎨 Frontend Components to Create

Core Components

Navbar.js - Navigation header
Footer.js - Footer with legal links
ArticleCard.js - Article preview card
MCQCard.js - MCQ question card
CategoryFilter.js - Filter by category
SearchBar.js - Search functionality

Pages

Home.js - Homepage with latest articles
CurrentAffairs.js - Daily current affairs list
ArticleDetail.js - Single article view
MCQPractice.js - MCQ practice page
DailyQuiz.js - Daily quiz interface
Login.js - Login page
Register.js - Registration page
Profile.js - User profile/dashboard
AdminDashboard.js - Admin panel
Legal pages (already created)

🎨 CSS Styling

The application uses:

Modern CSS3 with Flexbox/Grid
Responsive design (mobile-first)
Color scheme inspired by GKToday/DrishtiIAS
Google Fonts (Inter/Roboto)

🔒 Security Features

Password hashing with bcrypt
JWT token authentication
HTTP-only cookies (optional)
Helmet.js security headers
Rate limiting
Input validation
XSS protection
CORS configuration

📱 Responsive Design

Mobile-first approach
Breakpoints:
- Mobile: < 768px
- Tablet: 768px - 1024px
- Desktop: > 1024px

💰 Monetization (Google AdSense)

Setup Instructions:

Get AdSense approval
Add AdSense script to public/index.html:

<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-YOUR-ID"
     crossorigin="anonymous"></script>

Add ad units in components:

<ins className="adsbygoogle"
     style={{display:'block'}}
     data-ad-client="ca-pub-YOUR-ID"
     data-ad-slot="YOUR-SLOT-ID"
     data-ad-format="auto"></ins>
<script>
     (adsbygoogle = window.adsbygoogle || []).push({});
</script>

🚀 Deployment

Backend (Heroku/Railway/Render)

Create account on deployment platform
Connect GitHub repository
Add environment variables
Deploy

Frontend (Netlify/Vercel)

Build production version

npm run build

Deploy build folder to Netlify/Vercel
Configure environment variables
Set up custom domain

MongoDB (MongoDB Atlas)

Create MongoDB Atlas account
Create cluster
Create database user
Get connection string
Update MONGODB_URI in .env

📊 MongoDB Collections

users

User accounts
Authentication data
Subscriptions
Saved articles
Quiz history

articles

Current affairs content
Metadata
Categories
Exam relevance
View counts

mcqs

Questions
Options
Correct answers
Explanations
Statistics

🔧 Environment-Specific Configurations

Development

Detailed error messages
Hot reloading
CORS: http://localhost:3000
Debug mode ON

Production

Minified builds
Error tracking (Sentry)
CORS: Your domain
Debug mode OFF
HTTPS enforcement

📈 Analytics Integration

Google Analytics

Add to public/index.html:

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-YOUR-ID"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());
  gtag('config', 'G-YOUR-ID');
</script>

🐛 Troubleshooting

MongoDB Connection Issues

# Check if MongoDB is running
sudo systemctl status mongod

# Start MongoDB
sudo systemctl start mongod

Port Already in Use

# Kill process on port 5000
npx kill-port 5000

# Or use different port in .env
PORT=5001

CORS Errors

Check FRONTEND_URL in backend .env
Verify CORS configuration in server.js

📞 Support

For issues or questions:

Email: support@nmai.in
GitHub Issues: [Create Issue]

📄 License

MIT License - feel free to use for your own projects!

🙏 Credits

Inspired by:

GKToday (https://www.gktoday.in)
DrishtiIAS (https://www.drishtiias.com)

⭐ Show Your Support

If this project helps you, please give it a star on GitHub!

Built with ❤️ for Competitive Exam Aspirants

Name		Name	Last commit message	Last commit date
Latest commit History 114 Commits
.vs		.vs
.vscode		.vscode
backend		backend
frontend		frontend
.gitignore		.gitignore
DEPLOYMENT.md		DEPLOYMENT.md
README.md		README.md

Folders and files

Latest commit

History

Repository files navigation

NMAI Current Affairs - Full Stack Website

🚀 Features

Frontend

Backend

Admin Panel

📋 Prerequisites

🛠️ Installation

1. Clone the repository

2. Backend Setup

3. Frontend Setup

🚀 Running the Application

Development Mode

Production Build

📦 Database Seeding (Optional)

🔑 Default Admin Credentials

📁 Project Structure

🔌 API Endpoints

Authentication

Articles

MCQs

Users

Newsletter

Admin

🎨 Frontend Components to Create

Core Components

Pages

🎨 CSS Styling

🔒 Security Features

📱 Responsive Design

💰 Monetization (Google AdSense)

Setup Instructions:

🚀 Deployment

Backend (Heroku/Railway/Render)

Frontend (Netlify/Vercel)

MongoDB (MongoDB Atlas)

📊 MongoDB Collections

users

articles

mcqs

🔧 Environment-Specific Configurations

Development

Production

📈 Analytics Integration

Google Analytics

🐛 Troubleshooting

MongoDB Connection Issues

Port Already in Use

CORS Errors

📞 Support

📄 License

🙏 Credits

⭐ Show Your Support

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages