🛑 The Problem
During registration periods, getting into the right course sections with preferred timings or instructors can be incredibly difficult. Students often resort to constantly refreshing the registration portal hoping a seat opens up, or they turn to social media groups trying to arrange manual "swaps" with other students. This process is highly uncoordinated, relies heavily on luck, and requires tedious manual communication that often falls through at the last minute.
💡 The Idea
CourseMate acts as an intelligent intermediary. Instead of hunting through WhatsApp groups or hoping for a random drop, students can use CourseMate to declare exactly what course section they have, and what section they want. The platform handles the rest securely and intelligently.
🚀 How It Solves These Problems
CourseMate streamlines the entire process through several key mechanisms:
- Smart Swapping: If Student A has Section 1 but wants Section 2, and Student B has Section 2 but wants Section 1, CourseMate's smart matching algorithm instantly connects them.
- Giveaways & Requests: If a student is simply dropping a course and doesn't need a swap, they can list it as a Giveaway for anyone who needs it. Conversely, students can post Requests for sections they desperately need.
- Instant Notifications: Students no longer need to constantly monitor the app. By watching a course section, they receive an in-app notification and email the moment a relevant swap or giveaway becomes available — all collected in a dedicated notification center with a live unread badge.
- Tailored Academic Experience: The platform natively understands the University of Sharjah's structure. By capturing a student's gender and major, it automatically filters out irrelevant sections.
- Visual Schedule Builder: To prevent overlapping swaps, students can visually master and preview their potential schedule right within the app before finalizing changes.
🧭 Platform Architecture & Routing
Every single aspect of the app is engineered to funnel students toward successful, stress-free schedules.
1. / (Home Dashboard)
The landing hub after sign-in. It surfaces a personalized snapshot rather than the raw feed: your active-post and pending-match counts, the total credits in your latest saved schedule, and the electives offered this semester (department and university baskets) filtered to your major. Targeted announcements surface here on arrival.
2. /browse (The Feed)
The central marketplace. The feed natively applies intelligent filtering to only show posts (swaps, giveaways, and requests) that match your declared major and gender (preventing campus overlap).
- Capabilities: Users can instantly search this curated feed by Course CRN, Course Name, or Course ID.
- Interest Flow: For giveaways and requests (which aren't swaps), an "I'm interested" action lets a student share their own contact with the poster by email — the poster's number stays private unless they explicitly choose to publish it.
- Section Alerts: This is where students set up watch-a-section alerts (see
/notifications).
3. /post (Creation Hub)
The hub where students officially register a "Have" or "Want" section.
- Logic: It dynamically parses the user's major to only allow submitting posts for relevant courses. It enforces constraints—preventing users from exceeding the 5 active post maximum, keeping them from submitting identical swap requests, and ensuring no bad data permeates the system.
4. /matches (Swap Transactions)
When the matching engine finds a reciprocal 1-to-1 swap between two students, a record is created here in a Pending Match state. (Giveaways and requests don't use matches — they're coordinated through the "I'm interested" flow on the feed.)
- The 24-Hour Timer: Matches are securely held for exactly 24 hours.
- Dual Acceptance Logic: Only when both independent parties click "Accept" inside the 24-hour window will the match finalize and exchange contact details. If a match is declined or expires, the original post is auto-requeued and placed back on the market instantly.
5. /schedule (Visual Builder)
An advanced graphical permutations tool natively built into the platform.
- Complexity Management: It dynamically renders lectures, linked labs, and tutorial combinations so they never overlap.
- Preferences: Students can customize gap minimization rules, instruct the system to pack classes into compact days, strictly avoid Arabic or English designated classes (e.g., stopping section "01A" if English is preferred), and cleanly ingest "Major Elective" baskets flawlessly.
6. /instructors (Instructor Schedule)
A lookup tool that lets a student search any instructor by name and see the full weekly schedule of class times they teach this term — useful for vetting a section before swapping into a different professor.
7. /profile (User Settings)
The core setup and onboarding view that forcefully captures necessary metadata required to feed the logic loops for the rest of the application.
- Settings & Preferences: Beyond identity fields, students control their app theme and a set of email notification preferences — independently toggling swap-match, interest, and watched-section emails off. In-app notifications always remain on; these toggles govern email delivery only.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
