BookIt is a full-stack learning-session scheduling platform developed by our team to simplify mentor office hours, one-to-one learning sessions, and Study Group coordination.
The platform allows mentees to discover mentors and Study Groups, view real availability, request sessions, manage bookings, request reschedules, receive notifications, and participate in group-learning sessions without relying on repeated direct messages.
Mentors have a dedicated portal for managing availability, booking requests, Study Groups, recurring schedules, attendance, cancellations, and reschedule requests.
Mentor office hours and Study Group sessions were commonly coordinated through direct messages and informal conversations.
During our validation exercise, we asked fellows how they normally know whether a mentor or Study Group partner is available.
Some of the responses we received were:
"I dont know,i just message"
"When he replies and also we must have established an agreement about when am available"
"I don’t"
"I will reach out to them upfront to know when they will be free"
These responses showed that scheduling depended heavily on manually contacting another person and waiting for confirmation.
We also identified cases where a user selected a time only to discover that the same period had already been scheduled with another Study Group.
Our questionnaire showed a 71% occurrence of scheduling conflicts where participants discovered that a selected time had already been scheduled with another Study Group.
BookIt was created to reduce this back-and-forth by allowing users to see real available slots before requesting a session and by protecting against conflicting bookings at the database level.
Our questionnaire focused on how fellows currently schedule learning sessions, determine availability, experience scheduling conflicts, and whether they would use a dedicated booking platform.
The questionnaire results informed the core BookIt workflow:
Discover Resource
↓
View Availability
↓
Choose Available Time
↓
Send Booking Request
↓
Mentor Confirms
↓
Manage Session
BookIt provides a structured alternative to arranging sessions entirely through chat.
The application helps users:
- see when a mentor is actually available;
- request a specific session without repeated scheduling messages;
- prevent conflicting one-to-one bookings;
- keep pending and confirmed sessions in one place;
- request another session time when plans change;
- receive booking and cancellation updates;
- participate in shared Study Group sessions;
- manage Study Group capacity and waitlists;
- keep mentor and mentee workflows separate but connected.
BookIt uses Supabase Authentication.
Supported authentication methods include:
- Email and password
- Google OAuth
- GitHub OAuth
- Protected authenticated routes
- Role-aware routing
- Application session expiry
- Global sign-out
Users enter BookIt through the same authentication system, while their account role determines whether they use the mentee experience or mentor portal.
A mentee can:
- create an account;
- log in with email/password, Google, or GitHub;
- browse available mentors and Study Groups;
- search and filter resources;
- view mentor availability;
- choose an available date and time;
- send a booking request;
- see pending mentor confirmation;
- view confirmed sessions;
- view previous and cancelled sessions;
- cancel an eligible booking;
- request a reschedule;
- join Study Groups;
- leave Study Groups;
- join a Study Group waitlist when capacity is full;
- view recurring Study Group schedules;
- view upcoming Study Group sessions;
- receive notifications;
- filter notifications by All, Unread, and Read;
- mark notifications as read;
- clear delivered notifications;
- manage account and reminder settings;
- use Light, Dark, or System theme.
Mentors use a dedicated mentor portal.
A mentor can:
- manage their mentor profile;
- create availability;
- create multiple future availability slots;
- clear open availability;
- preserve already-booked sessions when clearing availability;
- review pending booking requests;
- confirm booking requests;
- cancel sessions;
- provide a required cancellation reason;
- review reschedule requests;
- approve or decline proposed reschedules;
- create Study Groups;
- manage Study Group members;
- configure recurring Study Group days and times;
- generate future Study Group sessions;
- schedule one-off Study Group sessions;
- cancel Study Group sessions with a reason;
- manage Study Group capacity;
- manage Study Group waitlists;
- record attendance;
- receive booking and Study Group notifications;
- switch to the mentee view when needed.
One-to-one bookings use real mentor availability.
The workflow is:
Mentee
↓
Select Mentor
↓
Select Available Day
↓
Select Available Time
↓
Send Booking Request
↓
Pending Mentor Confirmation
↓
Mentor Reviews Request
↓
Confirm or Cancel
A selected slot is reserved while the booking request is pending.
This prevents another user from taking the same active time while the mentor is reviewing the request.
The database remains the final authority for booking conflicts.
New one-to-one booking requests are created as pending rather than being immediately confirmed.
The mentor can:
Pending Request
↓
Confirm
↓
Confirmed Session
or:
Pending Request
↓
Cancel
↓
Cancellation Reason
After confirmation, the booking becomes an active confirmed session.
The mentee receives a notification when the mentor responds.
Mentees can request another available time for an active booking.
The workflow is:
Existing Booking
↓
Choose Another Available Slot
↓
Send Reschedule Request
↓
Proposed Slot Reserved
↓
Mentor Reviews Request
↓
Approve or Decline
If the mentor approves the request:
- the booking moves to the proposed slot;
- the original slot is released;
- the mentee receives a notification.
If the mentor declines the request:
- the original booking remains unchanged;
- the proposed slot is released;
- the mentee receives the mentor's decision.
Both mentors and mentees can cancel eligible bookings.
A mentor must provide a reason when cancelling a booking.
The cancellation reason is stored with the booking and is shown to the mentee through BookIt.
A mentee can cancel an eligible pending or confirmed booking.
The mentor receives a cancellation notification.
Booking and availability updates are handled by the BookIt database workflow.
Study Groups use a membership model rather than one booking per member.
A member joining a Study Group does not consume the group session for other members.
Study Group functionality includes:
- group membership;
- capacity limits;
- waitlists;
- recurring schedules;
- one-off sessions;
- generated future sessions;
- member management;
- session cancellation;
- cancellation reasons;
- notifications;
- attendance.
Mentors can configure regular Study Group meeting times using:
- weekday;
- start time;
- end time;
- multiple recurring schedule rows.
Future sessions can then be generated from the saved recurring schedule.
BookIt also checks for scheduling conflicts with the mentor's other active sessions.
When a Study Group reaches capacity, a user can join its waitlist.
The flow is:
Study Group Full
↓
Join Waitlist
↓
Capacity Becomes Available
↓
Eligible Waiting Member Promoted
↓
Notification Sent
Mentors can record attendance for eligible Study Group sessions.
Supported attendance statuses are:
- Present
- Absent
- Excused
Attendance remains associated with the correct Study Group session and member.
BookIt contains an in-app notification centre for mentors and mentees.
Notifications are used for events such as:
- new booking requests;
- booking confirmations;
- mentor cancellations;
- cancellation reasons;
- mentee cancellations;
- reschedule requests;
- reschedule approvals;
- reschedule declines;
- Study Group sessions;
- Study Group cancellations;
- waitlist promotion;
- session reminders.
Users can filter notifications using:
All
Unread
Read
Users can also:
- mark all notifications as read;
- clear delivered notifications;
- see unread notification counts in the navigation.
BookIt includes account and application preferences.
Users can manage:
- Light theme
- Dark theme
- System theme
- Booking update preferences
- Study Group update preferences
- Reminder preferences
- Reminder lead time
- Password
- Global sign-out
BookIt is built with:
- Next.js 16 App Router
- React 19
- TypeScript
- Tailwind CSS
- Supabase Authentication
- Supabase PostgreSQL
- TanStack Query
- React Hook Form
- Zod
- Lucide React
- Git
- GitHub
- Vercel
The application follows a layered structure:
Page
↓
Component
↓
Hook / Server Action / Application Logic
↓
Supabase Client / RPC
↓
PostgreSQL
Main project directories:
src/
app/
components/
hooks/
lib/
providers/
schemas/
types/
supabase/
schema.sql
seed.sql
migrations/
images/
mform1.jpg
mform2.jpg
mform3.jpg
mform4.jpg
Clone the repository:
git clone https://github.com/NetsGit/BOOKIT.gitMove into the project:
cd BOOKITInstall dependencies:
npm installCreate:
.env.local
using the team's Supabase project credentials:
NEXT_PUBLIC_SUPABASE_URL=...
NEXT_PUBLIC_SUPABASE_ANON_KEY=...Do not commit .env.local.
Start the development server:
npm run devOpen:
http://localhost:3000
BookIt uses Supabase PostgreSQL.
For a completely new Supabase project, use:
supabase/schema.sql
as the current schema reference.
Existing BookIt databases should be upgraded using the migration files in:
supabase/migrations/
Migrations should be applied in chronological order.
Do not repeatedly run:
supabase/schema.sql
against an existing live BookIt database.
schema.sql is maintained as a reference for creating a fresh database.
BookIt uses the Supabase OAuth flow for Google and GitHub authentication.
For each provider:
- Enable the provider under Supabase Authentication.
- Add the provider client ID and secret.
- Configure the allowed redirect URLs.
- Add the local application URL:
http://localhost:3000/**
- Add the deployed BookIt callback URL:
https://<your-vercel-domain>/auth/callback
OAuth returns through:
src/app/auth/callback/route.ts
The callback exchanges the authentication code for a Supabase session and routes the authenticated user to the appropriate BookIt experience.
Before major changes are merged, we run:
npm run typecheck
npm run lint
npm run buildThe current project has successfully passed:
TypeScript check PASS
ESLint PASS
Production build PASS
Our testing covers the main cross-role workflows.
- Signup
- Login
- Logout
- Google OAuth
- GitHub OAuth
- Protected route handling
- Role-aware navigation
- Session expiry
- Availability loading
- Day selection
- Time selection
- Booking request
- Pending state
- Mentor confirmation
- Conflict rejection
- Cancellation
- Cancellation reason
- Rescheduling
- Reschedule approval
- Reschedule decline
- Join
- Leave
- Capacity
- Waitlist
- Promotion
- Recurring schedule
- Session generation
- Cancellation
- Attendance
- New notification
- Unread count
- All filter
- Unread filter
- Read filter
- Mark all as read
- Clear all
- Desktop layout
- Mobile layout
- Light mode
- Dark mode
- Mentee navigation
- Mentor navigation
BookIt is deployed with Vercel.
Git-connected deployments allow our team to test changes through Preview deployments before updating the production application.
The normal deployment workflow is:
Feature Branch
↓
Vercel Preview Deployment
↓
Test
↓
Merge into Main
↓
Production Deployment
This allows a new version of BookIt to be built and tested without intentionally taking the existing production application offline.
BookIt is maintained as a shared team project.
Our workflow separates feature development from the main production branch so changes can be tested before they are merged.
Before merging major changes, we run:
npm run typecheck
npm run lint
npm run buildShared changes involving authentication, database migrations, types, dependencies, or common components are reviewed carefully because they affect multiple areas of the application.
BookIt started with a clear responsibility split across ten members. As the project expanded, additional files were created around each member's original area of responsibility.
Some files are shared across multiple features, especially authentication, booking, mentor workflows, Study Groups, notifications, settings, and database migrations.
Name: Akintobi Abibat Olamide
Primary responsibility: authentication infrastructure, Supabase clients, shared application authentication setup, and global session initialization.
src/lib/supabase/client.ts
src/lib/supabase/server.ts
src/app/layout.tsx
src/components/auth/SessionExpiryGuard.tsx
src/components/auth/SessionExpiredBanner.tsx
src/components/theme/ThemeInitializer.tsx
src/app/auth/callback/route.ts
.env.example
src/middleware.ts
Supabase client setup
Supabase server setup
Authentication session initialization
OAuth callback support
Session expiry support
Global application authentication setup
Authentication-related changes to protected routes and session behaviour are shared with Member 3 where required.
Name: Aminu Fatimah Zahra
Primary responsibility: login, signup, and the user-facing authentication experience.
src/components/auth/LoginForm.tsx
src/components/auth/SignupForm.tsx
src/app/login/page.tsx
src/app/signup/page.tsx
src/components/auth/SessionExpiredBanner.tsx
Login form
Signup form
Email/password authentication UI
Google OAuth UI
GitHub OAuth UI
Authentication validation feedback
Session-expired message
Authentication page layout
Name: Mohammed Sofiyah
Primary responsibility: authentication support, navigation behaviour, protected-route testing, session behaviour, and role-aware routing.
src/components/layout/Navbar.tsx
src/app/auth/callback/route.ts
src/components/auth/SessionExpiryGuard.tsx
src/components/auth/SessionExpiredBanner.tsx
src/middleware.ts
src/app/dashboard/
src/app/mentor/
src/app/login/
src/app/signup/
Email/password authentication
Google OAuth
GitHub OAuth
Protected-route redirects
Session persistence
Session expiry
Role-aware redirects
Logout
Authenticated navigation
Name: Abubakar Rashida
Primary responsibility: resource pages, resource routing, resource loading, and resource discovery.
src/app/resources/page.tsx
src/app/resources/[id]/page.tsx
src/app/resources/new/page.tsx
Resources page
Dynamic resource detail page
Mentor resource routing
Study Group resource routing
Resource loading states
Resource empty states
Resource search flow
Resource filter flow
Availability entry point
Study Group join entry point
Name: Jamiu AbdulQoyum Ifetayo
Primary responsibility: resource presentation and reusable resource interface components.
src/components/resources/ResourceCard.tsx
src/components/resources/ResourceList.tsx
src/components/resources/ResourceDetails.tsx
Mentor resource cards
Study Group resource cards
Resource list presentation
Resource details layout
Resource status display
Skills display
Availability selection interface
Study Group membership actions
Resource responsive behaviour
Resource UI is shared with booking and Study Group logic where those workflows appear within resource details.
Name: Harry Oluwaseyi Williams
Primary responsibility: resource data structures, Supabase resource queries, resource availability data, and integration of resource-related data across BookIt.
src/types/resource.ts
src/lib/supabase/resources.ts
src/hooks/useAvailabilitySlot.ts
src/lib/study-groups/index.ts
Resource data retrieval
Mentor resource data
Study Group resource data
Resource type definitions
Availability data
Exact availability-slot lookup
Resource status data
Resource ownership data
Study Group membership data
Study Group schedule data
Study Group session data
Study Group waitlist data
Resource and Study Group data integration
supabase/schema.sql
supabase/migrations/20260818_bookit_hardening.sql
supabase/migrations/20260821_expand_resource_availability.sql
supabase/migrations/20260901_mentor_portal.sql
supabase/migrations/20260902_00_add_pending_booking_status.sql
supabase/migrations/20260902_study_groups.sql
supabase/migrations/20260902_workflow_notifications_settings.sql
supabase/migrations/20260904_notification_cleanup_and_sample_resource_archive.sql
These database files are shared integration files and are not treated as exclusive Member 6 ownership. They are listed because they directly affect resource, availability, mentor, and Study Group data behaviour.
Name: Salahudeen Hassan Adeboye
Primary responsibility: booking creation, booking validation, slot reservation, conflict protection, and rescheduling logic.
src/app/book/[id]/page.tsx
src/schemas/bookingSchema.ts
src/lib/bookings/actions.ts
src/hooks/useAvailabilitySlot.ts
Booking request creation
Booking validation
Pending booking state
Availability-slot reservation
Mentor booking confirmation
Booking conflict protection
Availability release
Booking rescheduling
Reschedule approval
Reschedule decline
Booking database workflow
supabase/migrations/20260818_bookit_hardening.sql
supabase/migrations/20260902_workflow_notifications_settings.sql
These migrations are shared integration files.
Name: Rufai Awwal
Primary responsibility: booking interface, booking cards, booking actions, and booking-related interaction.
src/components/booking/
src/components/booking/BookingCard.tsx
Booking confirmation UI
Pending mentor confirmation
Upcoming booking display
Past booking display
Cancelled booking display
Booking status badges
Cancellation controls
Cancellation reason display
Reschedule modal
Reschedule request feedback
Booking action buttons
Responsive booking layout
Member 8 works closely with Members 7, 9, and 10 because booking actions appear across several application areas.
Name: Yunus Ismail
Primary responsibility: the My Bookings experience, booking history, and session-management presentation.
src/app/my-bookings/page.tsx
src/components/booking/BookingCard.tsx
src/app/dashboard/page.tsx
src/app/dashboard/overview/
Upcoming bookings
Past bookings
Pending bookings
Confirmed bookings
Cancelled bookings
Booking history
Reschedule status
Cancellation reason display
Booking counts
Dashboard booking integration
Session-management navigation
Name: Yusuf AbdulRahman Opeyemi
Primary responsibility: cancellation workflows, cancellation feedback, cancellation reasons, and related updates.
src/components/booking/BookingCard.tsx
src/components/mentor/MentorSessionsList.tsx
src/lib/bookings/actions.ts
src/lib/mentor/actions.ts
src/schemas/mentorSchema.ts
Mentee booking cancellation
Mentor booking cancellation
Required mentor cancellation reason
Cancellation reason storage
Booking status updates
Availability release or closure
Cancellation feedback
Cancellation notifications
Study Group session cancellation
Study Group cancellation reason
src/components/notifications/NotificationsWorkspace.tsx
src/components/notifications/NotificationBadge.tsx
src/app/messages/page.tsx
src/app/mentor/messages/page.tsx
Cancellation notifications are shared with the notifications feature.
As BookIt expanded, several features became shared across the original allocations.
These files should not be presented as the exclusive responsibility of one member unless the team agrees and the named member actually completed that work.
src/app/mentor/
src/components/mentor/
src/lib/mentor/
src/schemas/mentorSchema.ts
src/app/mentor/dashboard/
src/app/mentor/sessions/
src/app/mentor/availability/
src/app/mentor/messages/
src/app/mentor/profile/
src/app/mentor/study-groups/
src/components/mentor/MentorAppShell.tsx
src/components/mentor/MentorSessionsList.tsx
src/components/mentor/MentorAvailabilityManager.tsx
src/components/mentor/MentorStudyGroupsList.tsx
src/components/mentor/MentorStudyGroupDetail.tsx
src/lib/mentor/actions.ts
src/lib/mentor/index.ts
Mentor dashboard
Booking request review
Booking confirmation
Mentor cancellation
Cancellation reasons
Availability management
Clear open availability
Reschedule approval
Reschedule decline
Mentor profile
Study Group management
Mentee View
Mentor notifications
src/app/my-study-groups/page.tsx
src/app/mentor/study-groups/
src/components/study-groups/
src/components/mentor/MentorStudyGroupsList.tsx
src/components/mentor/MentorStudyGroupDetail.tsx
src/lib/study-groups/index.ts
Group membership
Join Group
Leave Group
Capacity management
Waitlist
Waitlist promotion
Recurring schedules
Generated sessions
One-off sessions
Member management
Group session cancellation
Cancellation reasons
Attendance
Study Group notifications
src/app/messages/page.tsx
src/app/mentor/messages/page.tsx
src/components/notifications/NotificationsWorkspace.tsx
src/components/notifications/NotificationBadge.tsx
src/hooks/useNotifications.ts
src/types/notification.ts
Booking request notifications
Booking confirmation notifications
Cancellation notifications
Cancellation reasons
Reschedule request notifications
Reschedule decision notifications
Study Group updates
Waitlist promotion
Session reminders
Unread notification badge
All filter
Unread filter
Read filter
Mark all as read
Clear notifications
src/app/settings/page.tsx
src/components/settings/AccountSettings.tsx
src/components/theme/ThemeInitializer.tsx
src/app/globals.css
Light mode
Dark mode
System theme
Booking update preferences
Study Group update preferences
Reminder preferences
Reminder lead time
Password management
Global sign-out
src/components/auth/SessionExpiryGuard.tsx
src/components/auth/SessionExpiredBanner.tsx
src/app/auth/callback/route.ts
src/middleware.ts
Session expiry
OAuth callback
Protected-route behaviour
Role-aware navigation
Expired-session feedback
src/components/ui/PageBadge.tsx
src/components/ui/AutoDismissAlert.tsx
src/components/layout/
src/components/mentor/MentorAppShell.tsx
These components are reused across several BookIt pages and workflows.
Database migrations affect several team areas and are treated as shared integration files.
supabase/schema.sql
supabase/seed.sql
supabase/migrations/
supabase/migrations/20260818_bookit_hardening.sql
supabase/migrations/20260821_expand_resource_availability.sql
supabase/migrations/20260901_mentor_portal.sql
supabase/migrations/20260902_00_add_pending_booking_status.sql
supabase/migrations/20260902_study_groups.sql
supabase/migrations/20260902_workflow_notifications_settings.sql
supabase/migrations/20260904_notification_cleanup_and_sample_resource_archive.sql
These migrations support multiple areas including:
Resources
Availability
Bookings
Booking approval
Rescheduling
Mentor workflows
Study Groups
Attendance
Waitlists
Notifications
Settings
Resource cleanup
Our goal with BookIt is to replace an informal scheduling process such as:
Message mentor
↓
Wait for response
↓
Suggest time
↓
Discover conflict
↓
Suggest another time
with:
See real availability
↓
Choose a slot
↓
Send request
↓
Mentor confirms
↓
Manage the session in BookIt
BookIt gives mentors, mentees, and Study Group members one structured place to coordinate learning sessions.