The open-source, community-driven survival guide and campus companion built by Great Ife students for incoming Great Ife freshmen.
100% Non-Profit • Mobile-First • Offline-Ready • Built with Pride for Obafemi Awolowo University, Ile-Ife.
Stepping onto the grounds of Obafemi Awolowo University for the first time is both exhilarating and bewildering. Every session, thousands of freshers arrive in Ile-Ife to face an initiation by fire:
- The Bed Space Balloting Scramble: Frantically refreshing portals at 10:00 AM, worrying about accommodation in Angola Hall (freshmen males) or Mozambique Hall (freshmen females), and dodging opportunistic middlemen and scams.
- The Clearance Paper Chase: Endless queues across campus—ensuring you have the mandatory red-background passport photos, the standard pale yellow file jacket, paying fees through Remita/ePortal, and getting signatures from the Faculty Officer to the Health Center.
- The Campus Labyrinth: Walking under the hot sun trying to locate BOOC, ODLT, Spider House, White House, Yellow House, Pit Theatre, or your department's administrative offices.
- Transit Confusion: Deciding whether to take a Campus Shuttle bus from Main Gate to SUB, where to catch a tricycle (keke) to Mozambique or Fajuyi, and what the legitimate student fares are so you don't get overcharged.
- Information Chaos: 50+ unofficial WhatsApp and Telegram groups broadcasting outdated, conflicting PDF circulars and repeating the exact same questions around the clock.
OAUMods exists to solve this once and for all. We are building a single, cohesive, ultra-fast, mobile-first web app that serves as every freshman’s pocket mentor.
OAUMods is designed to be the single place a Great Ife student goes whenever they need to find something, understand something, or figure out what to do next.
- Interactive campus map and route guidance.
- Comprehensive database of faculties, departments, and administrative annexes.
- Every lecture theatre (BOOC, AUD, ODLT 1 & 2, PGLT, BOOT, Spider House, White House, Yellow House, Pit Theatre).
- Hostels, landmarks, walking shortcuts, and key campus points of interest.
- Detailed hall guides: Angola (freshmen males), Mozambique (freshmen females), Fajuyi, Awolowo, Moremi, Alumni, ETF.
- Bed-space balloting strategy: countdowns, network prep tips, portal steps, and verification.
- Hostel rules, porter desk info, and survival hacks.
- Off-campus accommodation directory (Maintenance, Mayfair, Asherifa, Ibadan Road, AP, OAU Gate) with verified landlord tips and pricing expectations.
- Directory of faculties, departments, and course codes.
- Course information, units, prerequisites, and typical freshman elective selections.
- Timetable planner & examination schedules.
- Official academic calendar tracking.
- 🧮 Great Ife GPA Calculator: Tailored precisely to OAU's 5.0 grading system (A=5, B=4, C=3, D=2, E=1, F=0) with target GPA projections.
- Step-by-step interactive clearance checklist (School Fees on Remita -> Bio-data -> Health Center medical screening -> Bed Space -> Faculty clearance -> Departmental clearance -> Library ID).
- Exact document requirements per office (number of copies, red background passport mandate, standard pale yellow file jackets).
- Freshers' Survival Guide: what to do during your first 30 days.
- Campus shuttle bus routes (Main Gate to SUB, Town to Campus, Hall routes).
- Tricycle (Keke) parks & drop-off points (SUB, Fajuyi, Mozambique, Maintenance, Gate).
- Verified, official student fares to protect students from exploitation.
- Walking guides and inter-faculty shortcuts.
- Affordable food spots, cafeterias, and buttery joints across campus and halls.
- Essential student services: Printing/photocopying hubs, cybercafés, bookshops, laundry.
- Banks, working ATMs, and POS points.
- Campus events, fellowship centers, and student union activities.
- Direct emergency call triggers: Health Center Ambulance (JAC), Campus Security Post.
- Dean of Student Affairs, Faculty Officers, Sub-Deans, and SUG Welfare Desk.
- One-box universal search: Type any building, lecturer office, course code, clearance requirement, or food spot to get instant results.
- 100% core functionality without internet access.
- Cached offline state for clearance checklists, directories, and maps.
- Automatic background sync when connection is restored.
- Student-powered crowdsourced corrections and data updates.
- Departmental verification badges ensuring freshmen get accurate information.
- Lightweight curation portal to manage campus notices, update transit fares, and approve community additions.
- Timely tracking of portal deadlines, balloting dates, matriculation rehearsals, and exam commencement.
- Natural language Q&A: "How do I register for MTH101?", "Where is Room 15 in White House?", "What documents do I take to Faculty of Tech?"
- ⚡ Zero-Friction (Mobile Web / PWA): No 100MB app store downloads required. Open the link in any mobile browser, tap "Add to Home Screen", and start using it instantly.
- 📶 100% Offline-Capable: Freshmen frequently struggle with spotty data reception in lecture halls and hostels. Once cached, all directories, checklists, and survival guides work completely offline.
- 🕊️ 100% Free & Open Source: No paywalls, no monetization, no predatory ads. Built as a public service for the Great Ife student community.
- 🤝 Community-Powered: Maintained by Great Ife students. Anyone can contribute corrections, new departmental requirements, photos, and features via GitHub.
Because OAUMods is designed as a zero-bloat, framework-free PWA, you don't need heavy build chains to run it locally:
# 1. Clone the repository
git clone https://github.com/Alqaasimee-jr2/OAUMods.git
cd OAUMods
# 2. Start any local static file server (e.g. Python or Node)
python -m http.server 3000
# or: npx serve .
# 3. Open in your mobile browser or emulator
# http://localhost:3000This is a community effort born out of personal experience. Whether you are a developer, designer, or just a student who knows the ins and outs of your faculty clearance:
- Read our MILESTONES.md to see what we are currently building.
- Check our CHANGELOG.md to see our daily progress and thoughts.
- Review our PROJECT_RULES.md for contribution guidelines.
Great Ife! Against all odds, we build for the community. ✊