Skip to content

Usage

Calendar Operations

  • Navigate: Use Previous/Next buttons to navigate between months
  • Add Events: Click "Add Event" button to create new events
  • View Events: Click on any event in the calendar to view detailed information
  • Edit Events: Click the edit button (✏️) in the event details modal
  • Delete Events: Click the delete button (🗑️) in the event details modal
  • Today: Click "Today" button to return to the current month
  • Import Calendar: Click "Import" button to upload ICS files from other calendar applications

Task Management

  • Add Tasks: Click "Add Task" button in the tasks pane to create new tasks
  • Edit Tasks: Click on any task to edit its details, category, or due date
  • Complete Tasks: Check the checkbox to mark tasks as complete
  • Sort Tasks: Toggle between sorting by due date or by category
  • Show/Hide Completed: Toggle visibility of completed tasks
  • Manage Categories: Click "Categories" button to create, edit, or delete task categories
  • Daily Notifications: Receive automatic notifications at 10:00 AM for incomplete tasks due today or overdue

Task Categories

  • Create Categories: Add new categories with custom names and colours
  • Edit Categories: Modify existing category names and colours
  • Delete Categories: Remove categories (tasks will be uncategorised)
  • Colour Coding: Tasks display with a coloured left border matching their category
  • Visual Organisation: Categories help organise tasks by project, priority, or type

Calendar Import (ICS Files)

  • Supported Sources: Google Calendar, Outlook, Apple Calendar, and any calendar app that exports .ics files
  • Colour Assignment: Choose a colour for imported events during the import process
  • Bulk Import: Import multiple events at once from a single ICS file
  • Description Cleanup: Automatic removal of common calendar metadata (e.g., "[UK Public Holidays]")

Notifications with Gotify

  • Setup: Configure GOTIFY_URL and GOTIFY_TOKEN in your .env file
  • Two Timing Options:
  • Minutes Before: Traditional countdown notifications (5 mins, 30 mins, 1 hour, 1 day before)
  • Specific Date/Time: Set exact notification time (e.g., "December 24th at 4:00 PM" for a Christmas event)
  • Per-Event Configuration: Enable/disable and customise notifications for each event individually
  • Background Processing: Automatic notification delivery via background worker
  • Test Interface: Use /test endpoint to verify Gotify configuration
  • Backward Compatibility: Existing events remain unchanged (no notifications) until manually updated

Event Colours

  • Colour Picker: Use the colour picker for custom colours
  • Quick Presets: Click preset colour buttons for quick selection:
  • Blue, Red, Green, Yellow, Purple, Pink, Cyan, Gray
  • Automatic Contrast: Text colour automatically adjusts for optimal readability

Recurring Events

  • Enable Recurrence: Check "Recurring Event" checkbox when adding/editing
  • Choose Pattern: Select from Daily, Weekly, Monthly, Monthly by weekday, Yearly, or Custom
  • Set Intervals: Customise frequency (e.g., every 2 weeks = Weekly with interval 2)
  • End Conditions: Set end date or maximum number of occurrences

Recurring Event Examples

  • Birthday: Yearly, every 1 year
  • Bin Collection: Custom, every 14 days
  • Weekly Team Meeting: Weekly, every 1 week
  • Monthly Report: Monthly, every 1 month
  • Bi-weekly Sprint: Weekly, every 2 weeks, end after 6 occurrences

Notification Examples

  • Meeting Reminder: "Notify me 15 minutes before the meeting"
  • Birthday Alert: "Notify me the day before at 4:00 PM"
  • Bill Due: "Notify me 3 days before at 9:00 AM"
  • Event Preparation: "Notify me on Friday at 5:00 PM" (for a Monday event)

Validation Features

  • Date Validation: Prevents end dates before start dates
  • Time Validation: Ensures end times are after start times for same-day events
  • Real-time Feedback: Invalid fields highlighted with red borders
  • Server Validation: Backup validation on the server prevents invalid data