Frontend for Somali Education Notes & Past Papers Hub
# Somali Education Notes & Past Papers Hub
A modern web platform where university students and teachers can upload, browse, search, and download lecture notes and past exam papers.
## Features
- **User Authentication**: Register and login as Student, Teacher, or Admin
- **Document Management**: Upload, browse, and download educational materials
- **Advanced Filtering**: Search by University, Faculty, Course, Year, Document Type
- **Favorites System**: Save documents to your personal library
- **Download Tracking**: Track popularity of documents
- **Responsive Design**: Works beautifully on desktop and mobile
## Technology Stack
- **Frontend**: React + TypeScript + Tailwind CSS
- **Backend**: Supabase (PostgreSQL, Auth, Storage)
- **State Management**: React Context API
- **Routing**: React Router
## Getting Started
1. Clone the repository
2. Install dependencies: `npm install`
3. Start development server: `npm run dev`
4. Open
localhost in your browser
## Demo Accounts
- **Admin**: admin@test.com (password: any)
- **Teacher**: teacher@test.com (password: any)
- **Student**: student@test.com (password: any)
## Project Structure
```
src/
├── components/ # Reusable UI components
├── pages/ # Page components
├── contexts/ # React Context providers
├── data/ # Mock data
└── lib/ # Utilities and configs
```
## Features Overview
### For Students
- Browse and search thousands of documents
- Filter by university, course, year
- Download past papers and notes
- Save favorites for quick access
### For Teachers
- Upload lecture notes and materials
- Share resources with students
- Track document downloads
### For Admins
- Manage users and documents
- Approve uploaded content
- Monitor platform activity
## Contributing
This is an educational project to help Somali students access academic resources more easily.
## License
MIT License