100+ Powerful Features

A complete appointment booking and business management system built for service providers

✅ Production Ready✅ Enterprise Grade✅ TypeScript✅ Well Documented

Core Appointment System

Intelligent scheduling and booking management

Smart Availability Management (V2)

UTC-based architecture with real-time appointment slot generation and timezone-aware booking

  • All times stored in UTC, displayed in business timezone
  • Dynamic appointment slot generation based on business hours
  • Automatic daylight saving time handling
  • Sub-second appointment slot generation performance
  • Eliminated date mismatch and timezone bugs

Business Hours Mode

Uses global business working hours with automatic appointment slot generation based on service duration

Custom Daily Schedule

Different operating hours for each day of the week with unique start/end times

Predefined Slots

Exact time slots set for specific days (e.g., 'Every Monday at 6:00 PM')

Attached Offerings

Link multiple services together for shared availability management

  • Bidirectional availability blocking
  • Smart duration handling (90-min booking blocks multiple 30-min time slots)
  • Prevention of circular dependencies
  • Automatic daily break inheritance

Daily Breaks System

Automatically exclude break times from bookable time slots

  • Every Day Break - Same break time applies daily
  • Specific Days Break - Different breaks per day
  • Overlapping time slot detection
  • Timezone-aware filtering

Off-Duty Periods

Block time for vacations, holidays, or personal time off

  • Date range configuration
  • Full day or specific hours
  • Offering-specific or global
  • Reason tracking

Appointment Booking

Complete appointment lifecycle management with real-time conflict prevention

  • Real-time appointment slot availability checking
  • Automatic conflict prevention
  • Maximum appointments per user enforcement
  • Past date prevention
  • Multiple statuses: pending, confirmed, completed, cancelled, noshow

User Management

Secure authentication and user profile system

Multi-Provider Authentication

Secure authentication with Firebase, Google, and Apple Sign-In

  • JWT token validation via Firebase Admin SDK
  • Business-scoped user isolation
  • Role-based access control (user, admin, super admin)
  • Intelligent user caching with LRU strategy

Apple Sign-In Special Flow

Specialized handling for Apple's unique authentication behavior

  • Detection of Apple provider with displayName
  • Automatic cache invalidation when displayName provided
  • Fresh database sync on Apple authentication
  • MongoDB as source of truth for user profiles

User Caching System

High-performance user data caching with intelligent invalidation

  • LRU cache with 400 user capacity
  • Composite keys (userId + businessId)
  • TTL-based expiration (30s dev, 1min prod)
  • Fresh token detection
  • Stale profile auto-correction

User Profile Management

Complete user profile CRUD operations with Firebase and MongoDB sync

  • Edit display name, email, phone, photo
  • Cache invalidation on updates
  • Business-scoped profiles
  • Profile completion tracking

Announcements System

Broadcast important messages to customers

Announcement Management

Create and manage announcements with categories and scheduling

  • 5 categories: danger, warning, info, success, offer
  • Sticky announcements (always on top)
  • Start/end showing dates
  • Active/inactive toggle
  • Image upload support

Push Notifications for Announcements

Instant notification when announcements are created

  • Optional send_push_notifications_now flag
  • Sends to all users with push tokens
  • Smart priority mapping
  • Tracks success/failure rates
  • Non-blocking design

Announcement Images

Visual content with Firebase Storage integration

  • Base64 image upload
  • Automatic image cleanup on delete
  • Size validation (5MB max)
  • Format validation (JPEG, PNG, GIF, WebP)

Notification System

Comprehensive notification system using Expo Push Notifications

Push Notifications Service

Type-safe notification system with batch processing

  • Single user, multiple users, and broadcast notifications
  • Token validation and batch processing
  • Deep linking data for navigation
  • Priority levels (default, normal, high)
  • Channel routing (appointments, default)

Scheduled Appointment Notifications

Automated notification scheduling throughout appointment lifecycle

  • Confirmation (immediate)
  • 24-hour reminder
  • 1-hour reminder
  • Follow-up (2 hours after)
  • No-show notification
  • Zero-cost architecture (<$1/month)

Appointment Status Notifications

Real-time notifications for appointment changes

  • Triggered by admin updates
  • Status-specific messages
  • Deep link navigation data
  • Non-blocking error handling

AI Image Generation

Google Gemini AI-powered image creation

AI-Powered Offering Images

Generate premium service images using Google Gemini 2.5 Flash

  • Automatic prompt generation
  • Arabic-to-English translation
  • High-resolution output
  • Firebase Storage integration
  • Monthly generation limits per business

AI-Powered Offer/Advertisement Images

Create social media ready promotional graphics in 16:9 format

  • Bold, elegant typography
  • Minimalist luxury composition
  • Product-relevant backgrounds
  • Studio-quality lighting
  • Perfect for seasonal sales and promotions

Analytics & Reporting

Comprehensive insights into business performance

Business Analytics Dashboard

Comprehensive metrics tracking with intelligent caching

  • Total, completed, cancelled appointments
  • Total revenue and revenue by period
  • Popular offerings ranking
  • Active users and admin users
  • Daily/weekly/monthly trends
  • LRU caching (5min TTL production)

Analytics Cache Management

Intelligent caching system with smart invalidation

  • Invalidation on appointment operations
  • Invalidation on offering changes
  • Business + date keying
  • Memory efficient with LRU eviction

Waiting List

Smart waiting list management system

Smart Waiting List Management

Allow users to join waiting lists when appointment slots are full

  • Date-specific waiting lists
  • First-come, first-served ordering
  • Bulk notifications (efficient single API call)
  • Auto-expiration after requested date
  • Status tracking: active, notified, expired, cancelled
  • User self-service cancellation

Business Management

Complete business configuration and multi-tenancy

Business Profile

Complete business information and settings management

  • Business name, description, contact info
  • Working hours per day of week
  • Timezone (IANA format)
  • Default language and active status
  • Maximum appointments per offering/user
  • Days to book in advance

Multi-Tenancy Architecture

Complete business isolation and security

  • Business ID via X-App-Identifier header
  • All queries automatically scoped
  • Cross-business data access prevented
  • Role-based access control
  • Audit trail tracking

Security & Error Handling

Enterprise-grade security and error management

Professional Error Handling System

Type-safe error handling with automatic HTTP status code mapping

  • Custom error codes with status mapping
  • Factory functions for common errors
  • Consistent error responses
  • Frontend-friendly status codes
  • Proper error propagation

Enhanced Authentication Middleware

Secure request validation and user resolution

  • Firebase token validation
  • Business context extraction
  • User caching with intelligent invalidation
  • Provider detection (Google, Apple, Email)
  • Fresh token detection

Admin Authentication

Protected admin-only operations with audit trail

  • Admin role verification
  • Business-scoped operations
  • Operation restrictions
  • Audit trail logging

Technical Infrastructure

Built with modern technologies for scale and performance

MongoDB with Mongoose ODM

Optimized indexes and efficient queries

Multi-Layer Caching

LRU cache with intelligent invalidation

Google App Engine

Auto-scaling with health checks

TypeScript

Type-safe architecture throughout

Comprehensive Docs

20+ documentation files

Production Ready

Tested and deployed

100+
Features
9
Major Categories
20+
Documentation Files
100%
TypeScript

Ready to Transform Your Business?

Join thousands of service providers using Slotify to manage their appointments