Configuration

The published config/appointments.php in full:

use RoundlyConsulting\Appointments\Models\Appointment;
use RoundlyConsulting\Appointments\Models\Participant;
use RoundlyConsulting\Appointments\Reviews\DatabaseVerifiedAttendanceResolver;

return [
    'model' => Appointment::class,
    'participant' => Participant::class,

    // bigint | uuid | ulid — the key type of the polymorphic participant column
    'key_type' => env('APPOINTMENTS_KEY_TYPE', 'bigint'),

    'table_names' => [
        'appointments' => 'appointments',
        'participants' => 'appointment_participants',
    ],

    'timezone' => null,
    'default_duration_minutes' => 60,
    'prevent_conflicts' => false,

    'recurrence' => [
        'max_occurrences' => 365,
    ],

    'reviews' => [
        'verified_attendance_resolver' => DatabaseVerifiedAttendanceResolver::class,
        'require_verified_attendance' => false,
    ],

    'approvals' => [
        'enforce_transitions' => false,
    ],
];

Every key

The bool keys also take env-style strings — true/1/on/yes and false/0/off/no — and the int keys take integer strings ('45'). A key that is not set (absent, null, or blank: '' or whitespace) takes its default. Anything else — a mistyped switch ('disabled'), a duration or cap that isn’t a whole number in range ('an hour', 0), a non-string table name, an unknown timezone, a resolver that isn’t a VerifiedAttendanceResolver — throws InvalidConfigurationException naming the key instead of quietly reading as a default.

Environment

Only the participant key type is env-backed. It types a database column, so set it before you publish and run the migrations:

# bigint | uuid | ulid — set before you publish and run the migrations
APPOINTMENTS_KEY_TYPE=bigint

The about command

php artisan about --only=appointments reports the effective setup:

• Model and Participant model — the short class names of the resolved models.
• Appointments table and Participants table — the configured table names.
• Default timezone — SET or APP DEFAULT. Only presence is reported, never the value.
• Default duration — e.g. 60 min — and Max occurrences, the recurrence cap.
• Prevent conflicts, Require verified attendance and Approval transitions — ON or OFF.
• Attendance resolver — the class name of the bound review resolver.

A malformed table name, timezone, default duration, occurrence cap or resolver shows as INVALID, so about still renders on a misconfigured host while the real read path throws.