Essentials
Core Concepts
Builder, sources, entries, and renderers.
| Concept | What it represents |
|---|---|
TimelineBuilder | Fluent builder that composes sources, applies filters, and returns paginated TimelineEntry collections. Built per-record via $record->timeline(). |
TimelineSource | Produces TimelineEntry objects from a single origin - spatie log, related timestamps, or custom closure. |
TimelineEntry | Immutable value object describing one event (event, occurredAt, title, causer, properties, …). |
TimelineRenderer | Converts a TimelineEntry into a Blade View or HtmlString. Register custom ones per event or type. |
| Priority | Each source carries a priority; on dedupKey collisions the higher one wins. |
Default source priorities
| Source | Priority |
|---|---|
activity_log | 10 |
related_activity_log | 10 |
related_model | 20 |
custom | 30 |