NUESA Website

The official website for the Nigerian Universities Engineering Students' Association (NUESA). This platform connects engineering students ensuring easy access to academic resources, news, and association updates.

🚀 Features

• Academics & Resource Explorer: A powerful search engine for textbooks, past questions, and lecture notes. Indexed by course code, level, and department.
• News & Blog: Updates on events, scholarships, and engineering news.
• Timetables: Access to lecture and exam schedules.
• Responsive Design: Modern, mobile-first interface built with Tailwind CSS and Framer Motion.

🛠️ Tech Stack

• Frontend: React (Vite)
• Styling: Tailwind CSS, Lucide React
• Animations: Framer Motion
• State Management: React Hooks
• Routing: React Router DOM

⚙️ Setup & Installation

1. Clone the repository

   git clone https://github.com/NuesaTechTeam/NuesaWebsite.git
   cd NuesaWebsite
   

2. Install dependencies

   npm install
   

3. Configure Environment Variables Create a .env file in the root directory and add your API key for the Academics service:

   VITE_API_URL="https://r2-to-firestore-worker.nasurf25.workers.dev"
   VITE_API_KEY="your_api_key_here"
   VITE_UPLOAD_SECRET="your_upload_secret_here"
   

   Note: Contact the technical lead for the API key.

4. Run the development server

   npm run dev
   

📦 Deployment

The project is configured for deployment via GitHub Pages.

npm run deploy

🤝 Contribution

1. Fork the repository.
2. Create a new branch (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'Add some AmazingFeature').
4. Push to the branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

---

Built with ❤️ by the NUESA Tech Team.