PHPackages                             guava/calendar - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. guava/calendar

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

guava/calendar
==============

Adds support for vkurko/calendar to Filament PHP.

3.2.2(3w ago)310424.4k↓17%60[16 issues](https://github.com/GuavaCZ/calendar/issues)[5 PRs](https://github.com/GuavaCZ/calendar/pulls)3MITPHPPHP ^8.2CI failing

Since Jul 15Pushed 2w ago4 watchersCompare

[ Source](https://github.com/GuavaCZ/calendar)[ Packagist](https://packagist.org/packages/guava/calendar)[ Docs](https://github.com/GuavaCZ/calendar)[ GitHub Sponsors](https://github.com/GuavaCZ)[ RSS](/packages/guava-calendar/feed)WikiDiscussions main Synced 2w ago

READMEChangelog (10)Dependencies (42)Versions (46)Used By (3)

[![calendar Banner](https://github.com/GuavaCZ/calendar/raw/main/.github/banner.png)](https://github.com/GuavaCZ/calendar/raw/main/.github/banner.png)

Adds support for vkurko/calendar to Filament PHP.
=================================================

[](#adds-support-for-vkurkocalendar-to-filament-php)

[![Latest Version on Packagist](https://camo.githubusercontent.com/ed9385ddfb568731d0a659e46860154e53c3b29b8a84c6ac8202d868e5dd5614/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f67756176612f63616c656e6461722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/guava/calendar)[![Total Downloads](https://camo.githubusercontent.com/bf7fd3091ea44ef05dc4f9c4f78185393b6399be73bbd64cb8cb46ba377dd284/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f67756176612f63616c656e6461722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/guava/calendar)

This package adds support for [vkurko/calendar](https://github.com/vkurko/calendar) (free, open-source alternative to FullCalendar) to your FilamentPHP panels.

It allows you to create a widget with a calendar with support for **multiple** models and even resources you can group your events into. For example, you could have lessons (events) that are held in different rooms (resources).

Documentation
-------------

[](#documentation)

The full documentation is available at [guava.cz](https://guava.cz/developers/packages/calendar?ref=github&utm_campaign=calendar).

Version compatibility
---------------------

[](#version-compatibility)

Filament versionPlugin versionMin. PHP version3.x1.x8.14.x2.x8.15.x3.x8.2Showcase
--------

[](#showcase)

[![Showcase 01](https://github.com/GuavaCZ/calendar/raw/main/docs/images/showcase_01.png)](https://github.com/GuavaCZ/calendar/raw/main/docs/images/showcase_01.png)[![Showcase 02](https://github.com/GuavaCZ/calendar/raw/main/docs/images/showcase_02.png)](https://github.com/GuavaCZ/calendar/raw/main/docs/images/showcase_02.png)

    Screen.Recording.2025-08-18.at.18.39.38.mov        Screen.Recording.2024-07-15.at.9.31.47.mp4    [![Resources Screenshot 01](https://github.com/GuavaCZ/calendar/raw/main/docs/images/resources_screenshot_01.png)](https://github.com/GuavaCZ/calendar/raw/main/docs/images/resources_screenshot_01.png)

    context\_menu\_preview.mp4        context\_menu\_preview\_2.mp4        no\_events\_context\_menu.mp4    Support us
----------

[](#support-us)

Your support is key to the continual advancement of our plugin. We appreciate every user who has contributed to our journey so far.

While our plugin is available for all to use, if you are utilizing it for commercial purposes and believe it adds significant value to your business, we kindly ask you to consider supporting us through GitHub Sponsors. This sponsorship will assist us in continuous development and maintenance to keep our plugin robust and up-to-date. Any amount you contribute will greatly help towards reaching our goals. Join us in making this plugin even better and driving further innovation.

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require guava/calendar
```

Make sure to publish the package assets using:

```
php artisan filament:assets
```

Finally, make sure you have a **custom filament theme** (read [here](https://filamentphp.com/docs/4.x/styling/overview#creating-a-custom-theme) how to create one) and add the following to your **theme.css** file:

This ensures that the CSS is properly built:

```
@source '../../../../vendor/guava/calendar/resources/**/*';
```

This is optional but highly recommended as it will apply styles to better fit with the (default) filament theme:

```
@import '../../../../vendor/guava/calendar/resources/css/theme.css';
```

The paths might be a little bit different if your theme.css is located in a non-standard path. Adjust accordingly.

Usage
-----

[](#usage)

Create a widget extending `CalendarWidget`, return some events, and add it to a Filament page:

```
use Guava\Calendar\Filament\CalendarWidget;
use Guava\Calendar\ValueObjects\CalendarEvent;
use Guava\Calendar\ValueObjects\FetchInfo;
use Illuminate\Support\Collection;

class MyCalendarWidget extends CalendarWidget
{
    protected function getEvents(FetchInfo $info): Collection|array
    {
        return [
            CalendarEvent::make()
                ->title('My first event')
                ->start(now())
                ->end(now()->addHours(2)),
        ];
    }
}
```

Add the widget to any Filament page you like, such as your `Dashboard`, and you're done!

For everything else, including multiple models, resources, interactivity (drag &amp; drop, resize, context menus), custom event/resource content, actions and authorization, see the full documentation at [guava.cz](https://guava.cz/developers/packages/calendar?ref=github&utm_campaign=calendar).

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Lukas Frey](https://github.com/lukas-frey)
- [All Contributors](../../contributors)
- Spatie - Our package skeleton is a modified version of [Spatie's Package Skeleton](https://github.com/spatie/package-skeleton-laravel)
- [vkurko/calendar](https://github.com/vkurko/calendar) - free, open-source alternative to FullCalendar
- [saade/filament-fullcalendar](https://github.com/saade/filament-fullcalendar) - heavy inspiration for this package

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

66

—

FairBetter than 99% of packages

Maintenance95

Actively maintained with recent releases

Popularity58

Moderate usage in the ecosystem

Community31

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 83.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~19 days

Recently: every ~39 days

Total

40

Last Release

23d ago

Major Versions

1.14.2 → 2.0.0-beta.12025-06-11

2.1.1 → 3.0.02026-01-24

PHP version history (2 changes)1.0.0PHP ^8.1|^8.2

3.2.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/42d872f5f47cd71cfd46c8fbd6ec77a6bfb46d6d9499b5e1f843eb407c07f737?d=identicon)[Skrypt](/maintainers/Skrypt)

---

Top Contributors

[![lukas-frey](https://avatars.githubusercontent.com/u/10926334?v=4)](https://github.com/lukas-frey "lukas-frey (179 commits)")[![mwagena](https://avatars.githubusercontent.com/u/1246801?v=4)](https://github.com/mwagena "mwagena (8 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (5 commits)")[![p3dro-docplanner](https://avatars.githubusercontent.com/u/60880234?v=4)](https://github.com/p3dro-docplanner "p3dro-docplanner (4 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (2 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (2 commits)")[![hammadzafar05](https://avatars.githubusercontent.com/u/75698921?v=4)](https://github.com/hammadzafar05 "hammadzafar05 (2 commits)")[![pauloffb](https://avatars.githubusercontent.com/u/3179361?v=4)](https://github.com/pauloffb "pauloffb (1 commits)")[![sawirricardo](https://avatars.githubusercontent.com/u/37329575?v=4)](https://github.com/sawirricardo "sawirricardo (1 commits)")[![se1exin](https://avatars.githubusercontent.com/u/2385350?v=4)](https://github.com/se1exin "se1exin (1 commits)")[![sparksp](https://avatars.githubusercontent.com/u/243893?v=4)](https://github.com/sparksp "sparksp (1 commits)")[![webard](https://avatars.githubusercontent.com/u/855788?v=4)](https://github.com/webard "webard (1 commits)")[![yanntyb](https://avatars.githubusercontent.com/u/69966391?v=4)](https://github.com/yanntyb "yanntyb (1 commits)")[![ibrahem-kamal](https://avatars.githubusercontent.com/u/38753243?v=4)](https://github.com/ibrahem-kamal "ibrahem-kamal (1 commits)")[![Kepsondiaz](https://avatars.githubusercontent.com/u/67605105?v=4)](https://github.com/Kepsondiaz "Kepsondiaz (1 commits)")[![marcogermani87](https://avatars.githubusercontent.com/u/998645?v=4)](https://github.com/marcogermani87 "marcogermani87 (1 commits)")[![michaelnjuguna](https://avatars.githubusercontent.com/u/74660393?v=4)](https://github.com/michaelnjuguna "michaelnjuguna (1 commits)")[![m-lotze](https://avatars.githubusercontent.com/u/7899692?v=4)](https://github.com/m-lotze "m-lotze (1 commits)")[![paulhennell](https://avatars.githubusercontent.com/u/4799852?v=4)](https://github.com/paulhennell "paulhennell (1 commits)")

---

Tags

laravelcalendarGuava

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/guava-calendar/health.svg)

```
[![Health](https://phpackages.com/badges/guava-calendar/health.svg)](https://phpackages.com/packages/guava-calendar)
```

###  Alternatives

[rawilk/profile-filament-plugin

Profile &amp; MFA starter kit for filament.

3915.5k](/packages/rawilk-profile-filament-plugin)[backstage/mails

View logged mails and events in a beautiful Filament UI.

16429.7k](/packages/backstage-mails)[finity-labs/fin-mail

A powerful email template manager and composer for Filament with dynamic token replacement, template versioning, and inline email sending.

316.8k2](/packages/finity-labs-fin-mail)[stephenjude/filament-jetstream

A Laravel starter kit built with Filament inspired by Jetstream.

17861.9k3](/packages/stephenjude-filament-jetstream)[stephenjude/filament-debugger

About

104173.6k2](/packages/stephenjude-filament-debugger)[tapp/filament-form-builder

User facing form builder using Filament components

133.5k6](/packages/tapp-filament-form-builder)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
