Mohamed-Qadar/Somali-UniGuide
Domain:
educationRecord type:
software
Creator:
Moh
Host:
mohamed-qadar.github.io
# Somali-UniGuide
Somali-UniGuide is a free, open-source university guidance platform for Somali students. It runs entirely on GitHub Pages and updates automatically with GitHub Actions and a Python data scraper.
## Features
- University directory with tuition, scholarships, departments, and contact info
- Live search and filters (city, department, scholarships, public/private)
- Dedicated university detail pages
- Monthly automated data refresh via GitHub Actions
## Project Structure
```
Somali-UniGuide/
├── data/
│ ├── universities.json
│ └── sources.json
├── scripts/
│ ├── scraper.py
│ └── generate_pages.py
├── .github/workflows/
│ ├── update.yml
│ └── update_data.yml
├── universities/
│ └── *.html
├── assets/
│ ├── logos/
│ └── images/
├── index.html
├── university.html
├── style.css
├── app.js
└── README.md
```
## Data Format
`data/universities.json` contains a `metadata` block and a `universities` array. Each university record uses the following fields:
- `id` (string) — stable slug for URLs
- `name` (string)
- `city` (string)
- `status` (public/private)
- `description` (string)
- `rector` (string)
- `departments` (array of strings)
- `tuition` (string)
- `scholarships` (object with `available` and `details`)
- `admission_requirements` (string)
- `website` (string)
- `contact` (object with `email`, `phone`)
- `location` (object with `address`, `map`)
- `social_links` (object with optional platform URLs)
- `logo` (path to logo image)
## Automated Monthly Updates
The GitHub Actions workflow in `.github/workflows/update_data.yml` runs monthly:
1. Executes `scripts/scraper.py`
2. Executes `scripts/generate_pages.py`
3. Updates `data/universities.json` and `universities/*.html`
4. Commits the changes back to the repository only when files changed
5. Triggers GitHub Pages redeploy from the default branch
To add real data sources, update `data/sources.json` with either:
- JSON endpoints t …