README

Appointments for Laravel

A scheduling toolkit for Laravel: book appointments with durations and time zones, attach any Eloquent model as a participant, prevent double-bookings, drive a guarded status lifecycle, generate recurring series and export standards-compliant .ics calendars. Venues, guest contacts, booking approvals and post-visit reviews come built in.

Installation

Requires PHP 8.4, Laravel 12 or 13.

composer require roundly-consulting/appointments-for-laravel
php artisan vendor:publish --tag="appointments-migrations"
php artisan vendor:publish --tag="approvals-migrations" --tag="contacts-migrations" --tag="reviews-migrations" --tag="media-migrations"
php artisan migrate

The migrations are not loaded automatically, and the companion packages' migrations are needed too. If your participant models have UUID/ULID keys, set APPOINTMENTS_KEY_TYPE before migrating.

Usage

Book an appointment with its participants:

use RoundlyConsulting\Appointments\Enums\ParticipantRole;
use RoundlyConsulting\Appointments\Facades\Appointments;

$appointment = Appointments::schedule('Project kickoff')
    ->startingAt('2026-07-01 17:30', timezone: 'Europe/Bratislava')
    ->lasting(90)                                   // minutes; or ->until('2026-07-01 19:00')
    ->withParticipant($host, ParticipantRole::Organiser)
    ->withParticipant($guest)
    ->preventConflicts()                            // refuse a double-booking
    ->create();

Then move it through its lifecycle and export it:

use Carbon\CarbonImmutable;

$booking = Appointments::for($appointment);

$booking->confirm();                                                // pending → confirmed
$booking->reschedule(CarbonImmutable::parse('2026-07-02 10:00'));   // keeps the duration
$booking->participants()->add($colleague);

Appointments::isAvailable($guest, $appointment->starts_at, $appointment->ends_at); // false
$booking->ics();                                                    // an RFC 5545 calendar

Documentation

The full documentation — configuration, every feature and its API, and testing — lives on our website: roundly-consulting.com/open-source/docs/appointments-for-laravel

Release notes are in CHANGELOG.md. To contribute, see the contributing guide.

Support our work

This package is free and open source, built and maintained by Roundly Consulting. If it saves you time, please consider supporting our open-source work — a one-time donation, a monthly pledge on Patreon or a crypto donation helps fund maintenance, new features and new packages.

License

The MIT License (MIT). Please see LICENSE for more information.

roundly-consulting / appointments-for-laravel

Package info

Security

Fund package maintenance!

Statistics