README

A spooky Halloween theme plugin for Filament that adds animated ghosts, jumpscares, and a festive pumpkin button to your admin panel.

Features

• 👻 Animated Ghosts: Floating ghosts that spawn when dark mode is enabled
• 😱 Jumpscares: Random jumpscare videos for a spooky surprise
• 🎃 Pumpkin Button: Interactive pumpkin that encourages users to enable dark mode
• 🌙 Theme-Aware: Automatically enables/disables effects based on the theme switcher

Installation

1. Add the package to your project

If using as a local package:

{
    "repositories": [
        {
            "type": "path",
            "url": "./packages/halloween-theme"
        }
    ],
    "require": {
        "ueap/halloween-theme": "@dev"
    }
}

Then run:

composer update ueap/halloween-theme

2. Publish Assets

Publish the JavaScript files, images, and videos to your public directory:

php artisan vendor:publish --tag=halloween-theme-js
php artisan vendor:publish --tag=halloween-theme-images
php artisan vendor:publish --tag=halloween-theme-videos

Or publish all at once:

php artisan vendor:publish --tag=halloween-theme-js --tag=halloween-theme-images --tag=halloween-theme-videos

3. Register the Plugin

The plugin is automatically registered via Laravel's package discovery. The service provider will:

• Register JavaScript assets (jumpscare, phantom, watchtheme)
• Configure navigation items to remove icons
• Only load assets for authenticated users (skips login page)

Usage

The plugin works automatically once installed. When users switch to dark mode, the Halloween effects will activate:

• Ghosts will spawn every 3 seconds
• The pumpkin button appears in light mode to encourage switching to dark mode
• Clicking the pumpkin in dark mode triggers a jumpscare

Customization

Adjusting Ghost Behavior

Edit resources/js/phantom.js:

const maxGhosts = 3  // Maximum number of ghosts on screen
const chaseCooldown = 30 * 1000  // Time between ghost chases

Adjusting Jumpscare Timing

Edit resources/js/jumpscare.js:

const delay = 40000 + Math.random() * 50000;  // Random delay between jumpscares

Route Name Configuration

If your Filament panel uses a different ID than app, update the route check in HalloweenThemeServiceProvider.php:

if ($user && !request()->routeIs('filament.YOUR_PANEL_ID.auth.login')) {
    // ...
}

Assets

The plugin includes:

• JavaScript: jumpscare.js, phantom.js, watchtheme.js
• Images: fantasma.png, bats.png, pumpkin.png
• Videos: jumpscare1.mp4, jumpscare2.mp4, jumpscare3.mp4, jumpscare4.mp4

Requirements

• PHP ^8.1
• Filament ^3.0 or ^4.0
• Laravel package with theme switcher

License

MIT