Events Overview

Events adds event records, venues, occurrences, registrations, admin calendar views, frontend event list/calendar pages, and iCalendar feeds to Capell.

Hard Dependencies

• capell-app/admin
• capell-app/frontend
• capell-app/navigation
• capell-app/publishing-studio

Optional integrations are declared for address, form builder, SEO Suite, and tags.

What It Adds

• Event, venue, occurrence, registration, and notification log tables.
• Admin resources for events, venues, occurrences, and registrations.
• Admin event calendar page and dashboard calendar widget.
• Frontend Livewire listing and calendar page components.
• Public .ics calendar feed routes.
• Event schema render hooks.
• Recurrence expansion through rlanvin/php-rrule.
• iCalendar generation through spatie/icalendar-generator.

Admin Surfaces

Surface	Purpose
EventResource index/create/edit	Manage event records and recurrence fields.
EventVenueResource	Manage venues.
EventOccurrenceResource	Review generated occurrences.
EventRegistrationResource	Review event registrations.
EventCalendarPage	Calendar view under content navigation.
EventCalendarWidget	Dashboard/admin calendar widget.

Frontend Surfaces

Surface	Purpose
EventsListingPage	Public list of upcoming events.
EventsCalendarPage	Public calendar page.
EventCalendar	Livewire calendar component used by frontend pages.
events.ics	Global iCalendar feed route.
events/{listingPage}/feed.ics	Listing-specific iCalendar feed route.

Anonymous public output must not expose authoring controls, internal model IDs, editor URLs, or package internals.

Screenshot Coverage

The screenshot contract is stored in screenshots.json. Final capture should cover the admin resources, admin calendar, calendar widget, frontend listing/calendar pages, and feed route verification.

Install And Verify

Install in a Capell app with the hard dependencies:

composer require capell-app/events

Then run:

vendor/bin/pest packages/events/tests --configuration=phpunit.xml