Skip to content

anointedthedeveloper/ExamNews

Repository files navigation

Exam News Nigeria 🎓

Nigeria's #1 Exam Portal for JAMB, WAEC, NECO Updates & Admission Information

License: MIT React Vite

🌟 Features

  • JAMB Updates: Registration dates, exam schedules, result checking, CBT centers
  • WAEC & NECO: Timetables, registration info, exam dates
  • Cut-Off Marks: Federal, state, and private universities
  • Admission Guides: Post-UTME, CAPS, admission status checking
  • Mobile-First: Fully responsive design
  • SEO Optimized: Fast loading, proper meta tags, sitemap
  • AdSense Ready: Compliant with Google AdSense policies

🚀 Quick Start

Prerequisites

  • Node.js 18+ installed
  • npm or yarn package manager

Installation

# Clone the repository
git clone https://github.com/anointedthedeveloper/examnews.git

# Navigate to project directory
cd examnews

# Install dependencies
npm install

# Start development server
npm run dev

Open http://localhost:5173 in your browser.

📦 Build for Production

# Create optimized production build
npm run build

# Preview production build
npm run preview

🎯 Project Structure

examnews/
├── public/
│   ├── robots.txt
│   └── sitemap.xml
├── src/
│   ├── assets/          # Images and static files
│   ├── components/      # Reusable components
│   │   ├── Navbar.jsx
│   │   ├── Footer.jsx
│   │   ├── CookieConsent.jsx
│   │   ├── AdSlot.jsx
│   │   └── ErrorBoundary.jsx
│   ├── pages/           # Page components
│   │   ├── Home.jsx
│   │   ├── Jamb.jsx
│   │   ├── PrivacyPolicy.jsx
│   │   ├── TermsOfService.jsx
│   │   └── ...
│   ├── styles/          # CSS files
│   ├── App.jsx          # Main app component
│   └── main.jsx         # Entry point
├── .env.example         # Environment variables template
├── index.html           # HTML template
└── package.json         # Dependencies

🔧 Configuration

Environment Variables

Create a .env file in the root directory:

VITE_SHOW_ADS=false              # Set to true after AdSense approval
VITE_SITE_URL=https://examnews.work.gd
VITE_GA_TRACKING_ID=             # Optional: Google Analytics ID

📄 Pages

Main Pages

  • Home - Latest exam news and updates
  • JAMB - JAMB UTME information
  • WAEC - WAEC timetables and guides
  • NECO - NECO exam schedules
  • Cut-Off Marks - University admission requirements
  • Admission Status - How to check admission
  • Post-UTME - Screening information

Legal Pages

  • Privacy Policy - Data protection and privacy
  • Terms of Service - Usage terms and conditions
  • About - Company information
  • Contact - Get in touch
  • Support - Bug reports and donations

🎨 Tech Stack

  • Frontend: React 19.2.0
  • Build Tool: Vite 8.0
  • Routing: React Router DOM 7.13.1
  • SEO: React Helmet Async 2.0.5
  • Icons: Lucide React 0.575.0
  • Styling: CSS3 (Custom)

🔍 SEO Features

  • ✅ Dynamic meta tags per page
  • ✅ Canonical URLs
  • ✅ OpenGraph tags
  • ✅ Twitter cards
  • ✅ Structured data (JSON-LD)
  • ✅ Sitemap.xml
  • ✅ Robots.txt
  • ✅ Semantic HTML

💰 Monetization

Current:

  • Opay donations (9016471351 - Anointed Agunloye Ayokunle)
  • WhatsApp channel for community building

Future (18+ or with Guardian):

  • Google AdSense integration ready
  • Ad slots prepared and compliant
  • See ADSENSE_SETUP_GUIDE.md for details

📊 Performance

  • Lazy Loading: All routes lazy-loaded
  • Code Splitting: Automatic by route
  • Optimized Build: Vite production build
  • Target Lighthouse Score: 90+

🛡️ Compliance

  • ✅ GDPR compliant (Cookie consent)
  • ✅ Privacy Policy
  • ✅ Terms of Service
  • ✅ Google AdSense ready
  • ✅ Error boundary for stability
  • ✅ Accessible design

📱 Browser Support

  • Chrome (latest)
  • Firefox (latest)
  • Safari (latest)
  • Edge (latest)
  • Mobile browsers

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📝 License

This project is licensed under the MIT License.

👨‍💻 Developer

Created by anointedthedeveloper

📞 Support

📚 Documentation

🎯 Roadmap

  • Google Analytics integration
  • Blog section for articles
  • User accounts and saved preferences
  • Push notifications for exam updates
  • Mobile app (React Native)

⭐ If you find this project helpful, please give it a star!

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors