Skip to content

Latest commit

 

History

58 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TimeFrame - Calendar Availability App

Overview

The Calendar Availability App is a full-stack web application that helps users find the best available meeting times by combining multiple schedules.

Users can connect their Google Calendar, add manual busy times, and instantly see ranked free-time slots. The app is designed to solve a real coordination problem in a clean, user-friendly way.


What the App Does

  • Imports busy events from Google Calendar
  • Allows users to manually add busy time blocks
  • Merges overlapping schedules automatically
  • Finds valid free-time windows
  • Ranks free times by quality (duration and time of day)
  • Supports group scheduling via shareable links
  • Saves schedules so data persists on refresh

Key Features

Google Calendar Integration

  • Secure OAuth login
  • Reads busy events from the user’s primary calendar
  • Automatically updates availability

Smart Availability Engine

  • Merges all busy intervals into a single schedule
  • Detects free time within daily boundaries
  • Filters out short or unusable gaps

Ranked Results

  • Longer time slots score higher
  • Midday hours are prioritized
  • Results are displayed in readable durations (e.g., 2 hours 15 minutes)

Group Scheduling

  • Create a group link
  • Combine availability from multiple users
  • Find the best shared meeting times

Persistent State

  • Busy times and results remain saved when the page reloads
  • No account creation required

Tech Stack

Frontend

  • React (Vite)
  • JavaScript
  • Deployed on Vercel

Backend

  • FastAPI (Python)
  • Google Calendar API
  • SQLite
  • Deployed on Render

Author

Samuel Esebor
UBC Computer Engineering student, Full-stack developer with ML and microelectronics background. Checkout my linkedin at linkedin.com/in/samuel-esebor.com

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages