fix(#158): do not require ID header on /display endpoint

add error handling for preview

fix idx bug and add tests

fix light mode styling and remove transitions

add global styling class

.devcontainer/cli/Dockerfile

@@ -1,5 +1,5 @@
 # From official php image.
-FROM php:8.3-cli-alpine
+FROM php:8.4-cli-alpine
 # Create a user group and account under id 1000.
 RUN addgroup -g 1000 -S user && adduser -u 1000 -D user -G user
 # Install quality-of-life packages.
@@ -9,21 +9,22 @@ RUN apk add --no-cache composer
 # Add Chromium and Image Magick for puppeteer.
 RUN apk add --no-cache \
   imagemagick-dev \
-  chromium
+  chromium \
+  libzip-dev
 
 ENV PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium
 ENV PUPPETEER_DOCKER=1
 
 RUN mkdir -p /usr/src/php/ext/imagick
 RUN chmod 777 /usr/src/php/ext/imagick
-RUN curl -fsSL https://github.com/Imagick/imagick/archive/refs/tags/3.7.0.tar.gz | tar xvz -C "/usr/src/php/ext/imagick" --strip 1
+RUN curl -fsSL https://github.com/Imagick/imagick/archive/refs/tags/3.8.0.tar.gz | tar xvz -C "/usr/src/php/ext/imagick" --strip 1
 
 # Install PHP extensions
-RUN docker-php-ext-install imagick
+RUN docker-php-ext-install imagick zip
 
 # Composer uses its php binary, but we want it to use the container's one
-RUN rm -f /usr/bin/php83
-RUN ln -s /usr/local/bin/php /usr/bin/php83
+RUN rm -f /usr/bin/php84
+RUN ln -s /usr/local/bin/php /usr/bin/php84
 # Install postgres pdo driver.
 # RUN apk add --no-cache postgresql-dev && docker-php-ext-install pdo_pgsql
 # Install redis driver.

.devcontainer/fpm/Dockerfile

@@ -1,5 +1,5 @@
 # From official php image.
-FROM php:8.3-fpm-alpine
+FROM php:8.4-fpm-alpine
 RUN addgroup -g 1000 -S user && adduser -u 1000 -D user -G user
 # Install postgres pdo driver.
 # RUN apk add --no-cache postgresql-dev && docker-php-ext-install pdo_pgsql
@@ -14,17 +14,18 @@ RUN apk add --no-cache \
   nodejs \
   npm \
   imagemagick-dev \
-  chromium
+  chromium \
+  libzip-dev
 
 ENV PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium
 ENV PUPPETEER_DOCKER=1
 
 RUN mkdir -p /usr/src/php/ext/imagick
 RUN chmod 777 /usr/src/php/ext/imagick
-RUN curl -fsSL https://github.com/Imagick/imagick/archive/refs/tags/3.7.0.tar.gz | tar xvz -C "/usr/src/php/ext/imagick" --strip 1
+RUN curl -fsSL https://github.com/Imagick/imagick/archive/refs/tags/3.8.0.tar.gz | tar xvz -C "/usr/src/php/ext/imagick" --strip 1
 
 # Install PHP extensions
-RUN docker-php-ext-install imagick
+RUN docker-php-ext-install imagick zip
 
-RUN rm -f /usr/bin/php83
-RUN ln -s /usr/local/bin/php /usr/bin/php83
+RUN rm -f /usr/bin/php84
+RUN ln -s /usr/local/bin/php /usr/bin/php84

.github/workflows/docker-build.yml

@@ -42,8 +42,7 @@ jobs:
         with:
           images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
           tags: |
-            type=ref,event=tag
-            latest
+            type=semver,pattern={{version}}
 
       - name: Build and push Docker image
         uses: docker/build-push-action@v6

.github/workflows/test.yml

@@ -22,7 +22,7 @@ jobs:
       - name: Setup PHP
         uses: shivammathur/setup-php@v2
         with:
-          php-version: 8.3
+          php-version: 8.4
           coverage: xdebug
 
       - name: Setup Node

.gitignore

@@ -22,3 +22,15 @@ yarn-error.log
 /.vscode
 /.zed
 /database/seeders/PersonalDeviceSeeder.php
+/.junie/mcp/mcp.json
+/.cursor/mcp.json
+/.cursor/rules/laravel-boost.mdc
+/.github/copilot-instructions.md
+/.junie/guidelines.md
+/CLAUDE.md
+/.mcp.json
+/.ai
+.DS_Store
+/boost.json
+/.gemini
+/GEMINI.md

Dockerfile

@@ -1,7 +1,7 @@
 ########################
 # Base Image
 ########################
-FROM bnussbau/serversideup-php:8.3-fpm-nginx-alpine-imagick-chromium AS base
+FROM bnussbau/serversideup-php:8.4-fpm-nginx-alpine-imagick-chromium@sha256:52ac545fdb57b2ab7568b1c7fc0a98cb1a69a275d8884249778a80914272fa48 AS base
 
 LABEL org.opencontainers.image.source=https://github.com/usetrmnl/byos_laravel
 LABEL org.opencontainers.image.description="TRMNL BYOS Laravel"
@@ -12,9 +12,14 @@ ENV APP_VERSION=${APP_VERSION}
 
 ENV AUTORUN_ENABLED="true"
 
+# Mark trmnl-liquid-cli as installed
+ENV TRMNL_LIQUID_ENABLED=1
+
 # Switch to the root user so we can do root things
 USER root
 
+COPY --chown=www-data:www-data --from=bnussbau/trmnl-liquid-cli:0.1.0 /usr/local/bin/trmnl-liquid-cli /usr/local/bin/
+
 # Set the working directory
 WORKDIR /var/www/html
 
@@ -48,6 +53,5 @@ FROM base AS production
 # Copy the assets from the assets image
 COPY --chown=www-data:www-data --from=assets /app/public/build /var/www/html/public/build
 COPY --chown=www-data:www-data --from=assets /app/node_modules /var/www/html/node_modules
-
 # Drop back to the www-data user
 USER www-data

README.md

@@ -3,9 +3,7 @@
 [![tests](https://github.com/usetrmnl/byos_laravel/actions/workflows/test.yml/badge.svg)](https://github.com/usetrmnl/byos_laravel/actions/workflows/test.yml)
 
 TRMNL BYOS Laravel is a self-hostable implementation of a TRMNL server, built with Laravel.
-It enables you to manage TRMNL devices, generate screens dynamically, and can act as a proxy for the native cloud service (native plugins, recipes).
-
-If you are looking for a Laravel package designed to streamline the development of both public and private TRMNL plugins, check out [bnussbau/trmnl-laravel](https://github.com/bnussbau/laravel-trmnl).
+It allows you to manage TRMNL devices, generate screens using **native plugins** (Screens API, Markup), **recipes** (120+ from the [OSS community catalog](https://bnussbau.github.io/trmnl-recipe-catalog/), 600+ from the [TRMNL catalog](https://usetrmnl.com/recipes), or your own), or the **API**, and can also act as a **proxy** for the native cloud service (Core). With over 40k downloads and 160+ stars, it’s the most popular community-driven BYOS.
 
 ![Screenshot](README_byos-screenshot.png)
 ![Screenshot](README_byos-screenshot-dark.png)
@@ -16,21 +14,32 @@ If you are looking for a Laravel package designed to streamline the development
 
 * 📡 Device Information – Display battery status, WiFi strength, firmware version, and more.
 * 🔍 Auto-Join – Automatically detects and adds devices from your local network.
-* 🖥️ Screen Generation – Supports Plugins (even Mashups), Recipes, API, Markup, or updates via Code.
-  * Supported Devices / Apps: TRMNL, ESP32 with TRMNL firmware, [trmnl-android](https://github.com/usetrmnl/trmnl-android), [trmnl-kindle](https://github.com/usetrmnl/byos_laravel/pull/27), …
+* 🖥️ Screen Generation – Supports Plugins (including Mashups), Recipes, API, Markup, or updates via Code.
+  * Support for TRMNL [Design Framework](https://usetrmnl.com/framework)
+  * Compatible open-source recipes are available in the [community catalog](https://bnussbau.github.io/trmnl-recipe-catalog/)
+  * Import from the [TRMNL community recipe catalog](https://usetrmnl.com/recipes)
+  * Supported Devices
+    * TRMNL OG (1-bit & 2-bit)
+    * SeeedStudio TRMNL 7,5" (OG) DIY Kit
+    * Seeed Studio (XIAO 7.5" ePaper Panel)
+    * reTerminal E1001 Monochrome ePaper Display
+    * Custom ESP32 with TRMNL firmware
+    * E-Reader Devices
+      * KOReader ([trmnl-koreader](https://github.com/usetrmnl/trmnl-koreader))
+      * Kindle ([trmnl-kindle](https://github.com/usetrmnl/byos_laravel/pull/27))
+      * Nook ([trmnl-nook](https://github.com/usetrmnl/trmnl-nook))
+      * Kobo ([trmnl-kobo](https://github.com/usetrmnl/trmnl-kobo))
+    * Android Devices with [trmnl-android](https://github.com/usetrmnl/trmnl-android)
+    * Raspberry Pi (HDMI output) [trmnl-display](https://github.com/usetrmnl/trmnl-display)
 * 🔄 TRMNL API Proxy – Can act as a proxy for the native cloud service (requires TRMNL Developer Edition).
     * This enables a hybrid setup – for example, you can update your custom Train Monitor every 5 minutes in the morning, while displaying native TRMNL plugins throughout the day.
 * 🌙 Dark Mode – Switch between light and dark mode.
 * 🐳 Deployment – Dockerized setup for easier hosting (Dockerfile, docker-compose).
+* 💾 Flexible Database configuration – uses SQLite by default, also compatible with MySQL or PostgreSQL 
 * 🛠️ Devcontainer support for easier development.
 
 ![Devices](README_byos-devices.jpeg)
 
-### 🎯 Target Audience
-
-This project is for developers who are looking for a self-hosted server for devices running the TRMNL firmware.
-It serves as a starter kit, giving you the flexibility to build and extend it however you like.
-
 ### Support ❤️
 This repo is maintained voluntarily by [@bnussbau](https://github.com/bnussbau).
 
@@ -40,6 +49,8 @@ or
 
 [!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/bnussbau)
 
+[GitHub Sponsors](https://github.com/sponsors/bnussbau/)
+
 ### Hosting
 
 Run everywhere, where Docker is supported: Raspberry Pi, VPS, NAS, Container Cloud Service (Cloud Run, ...).
@@ -65,9 +76,12 @@ docker compose up -d
 If you’re using a VPS (e.g., Hetzner) and prefer an alternative to native Docker, you can install Dokploy and deploy BYOS Laravel using the integrated [Template](https://templates.dokploy.com/?q=trmnl+byos+laravel).
 It’s a quick way to get started without having to manually manage Docker setup.
 
-### PikaPods
+#### PikaPods
 You can vote for TRMNL BYOS Laravel to be included as PikaPods Template here: [feedback.pikapods.com](https://feedback.pikapods.com/posts/842/add-app-trmnl-byos-laravel)
 
+#### Umbrel
+Umbrel is supported through a community store, [see](http://github.com/bnussbau/umbrel-store).
+
 #### Other Hosting Options
 Laravel Forge, or bare metal PHP server with Nginx or Apache is also supported.
 
@@ -110,6 +124,7 @@ php artisan db:seed --class=ExampleRecipesSeeder
 | `FORCE_HTTPS`                 | If your server handles SSL termination, enforce HTTPS.                                                                                      | 0                 |
 | `PHP_OPCACHE_ENABLE`          | Enable PHP Opcache                                                                                                                          | 0                 |
 | `TRMNL_IMAGE_URL_TIMEOUT`     | How long TRMNL waits for a response on the display endpoint. (sec)                                                                          | 30                |
+| `APP_TIMEZONE`                | Default timezone, which will be used by the PHP date functions                                                                              | UTC               |
 
 #### Login
 
@@ -203,6 +218,12 @@ You can dynamically update screens by sending a POST request.
 }
 ```
 
+### Releated Work
+* [bnussbau/laravel-trmnl-blade](https://github.com/bnussbau/laravel-trmnl-blade) – Blade Components on top of the TRMNL Design System
+* [bnussbau/trmnl-pipeline-php](https://github.com/bnussbau/trmnl-pipeline-php) – Browser Rendering and Image Conversion Pipeline with support for TRMNL Models API
+* [bnussbau/trmnl-recipe-catalog](https://github.com/bnussbau/trmnl-recipe-catalog) – A community-driven catalog of public repositories containing trmnlp-compatible recipes.
+
+
 ### 🤝 Contribution
 Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
 

app/Console/Commands/FetchDeviceModelsCommand.php

@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Console\Commands;
+
+use App\Jobs\FetchDeviceModelsJob;
+use Exception;
+use Illuminate\Console\Command;
+
+final class FetchDeviceModelsCommand extends Command
+{
+    /**
+     * The name and signature of the console command.
+     *
+     * @var string
+     */
+    protected $signature = 'device-models:fetch';
+
+    /**
+     * The console command description.
+     *
+     * @var string
+     */
+    protected $description = 'Fetch device models from the TRMNL API and update the database';
+
+    /**
+     * Execute the console command.
+     */
+    public function handle(): int
+    {
+        $this->info('Dispatching FetchDeviceModelsJob...');
+
+        try {
+            FetchDeviceModelsJob::dispatchSync();
+
+            $this->info('FetchDeviceModelsJob has been dispatched successfully.');
+
+            return self::SUCCESS;
+        } catch (Exception $e) {
+            $this->error('Failed to dispatch FetchDeviceModelsJob: '.$e->getMessage());
+
+            return self::FAILURE;
+        }
+    }
+}

app/Console/Commands/FirmwareCheckCommand.php

@@ -23,7 +23,7 @@ class FirmwareCheckCommand extends Command
         );
 
         $latestFirmware = Firmware::getLatest();
-        if ($latestFirmware) {
+        if ($latestFirmware instanceof Firmware) {
             table(
                 rows: [
                     ['Latest Version', $latestFirmware->version_tag],

app/Console/Commands/FirmwareUpdateCommand.php

@@ -42,15 +42,14 @@ class FirmwareUpdateCommand extends Command
             label: 'Which devices should be updated?',
             options: [
                 'all' => 'ALL Devices',
-                ...Device::all()->mapWithKeys(function ($device) {
+                ...Device::all()->mapWithKeys(fn ($device): array =>
                     // without _ returns index
-                    return ["_$device->id" => "$device->name (Current version: $device->last_firmware_version)"];
-                })->toArray(),
+                    ["_$device->id" => "$device->name (Current version: $device->last_firmware_version)"])->toArray(),
             ],
             scroll: 10
         );
 
-        if (empty($devices)) {
+        if ($devices === []) {
             $this->error('No devices selected. Aborting.');
 
             return;
@@ -59,9 +58,7 @@ class FirmwareUpdateCommand extends Command
         if (in_array('all', $devices)) {
             $devices = Device::pluck('id')->toArray();
         } else {
-            $devices = array_map(function ($selected) {
-                return (int) str_replace('_', '', $selected);
-            }, $devices);
+            $devices = array_map(fn ($selected): int => (int) str_replace('_', '', $selected), $devices);
         }
 
         foreach ($devices as $deviceId) {

app/Console/Commands/GenerateDefaultImagesCommand.php

@@ -0,0 +1,201 @@
+<?php
+
+namespace App\Console\Commands;
+
+use App\Models\DeviceModel;
+use Bnussbau\TrmnlPipeline\Stages\BrowserStage;
+use Bnussbau\TrmnlPipeline\Stages\ImageStage;
+use Bnussbau\TrmnlPipeline\TrmnlPipeline;
+use Exception;
+use Illuminate\Console\Command;
+use Illuminate\Support\Facades\Storage;
+use InvalidArgumentException;
+use RuntimeException;
+use Wnx\SidecarBrowsershot\BrowsershotLambda;
+
+class GenerateDefaultImagesCommand extends Command
+{
+    /**
+     * The name and signature of the console command.
+     *
+     * @var string
+     */
+    protected $signature = 'images:generate-defaults {--force : Force regeneration of existing images}';
+
+    /**
+     * The console command description.
+     *
+     * @var string
+     */
+    protected $description = 'Generate default images (setup-logo and sleep) for all device models from Blade templates';
+
+    /**
+     * Execute the console command.
+     */
+    public function handle(): int
+    {
+        $this->info('Starting generation of default images for all device models...');
+
+        $deviceModels = DeviceModel::all();
+
+        if ($deviceModels->isEmpty()) {
+            $this->warn('No device models found in the database.');
+
+            return self::SUCCESS;
+        }
+
+        $this->info("Found {$deviceModels->count()} device models to process.");
+
+        // Create the target directory
+        $targetDir = 'images/default-screens';
+        if (! Storage::disk('public')->exists($targetDir)) {
+            Storage::disk('public')->makeDirectory($targetDir);
+            $this->info("Created directory: {$targetDir}");
+        }
+
+        $successCount = 0;
+        $skipCount = 0;
+        $errorCount = 0;
+
+        foreach ($deviceModels as $deviceModel) {
+            $this->info("Processing device model: {$deviceModel->label} (ID: {$deviceModel->id})");
+
+            try {
+                // Process setup-logo
+                $setupResult = $this->transformImage('setup-logo', $deviceModel, $targetDir);
+                if ($setupResult) {
+                    ++$successCount;
+                } else {
+                    ++$skipCount;
+                }
+
+                // Process sleep
+                $sleepResult = $this->transformImage('sleep', $deviceModel, $targetDir);
+                if ($sleepResult) {
+                    ++$successCount;
+                } else {
+                    ++$skipCount;
+                }
+
+            } catch (Exception $e) {
+                $this->error("Error processing device model {$deviceModel->label}: ".$e->getMessage());
+                ++$errorCount;
+            }
+        }
+
+        $this->info("\nGeneration completed!");
+        $this->info("Successfully processed: {$successCount} images");
+        $this->info("Skipped (already exist): {$skipCount} images");
+        $this->info("Errors: {$errorCount} images");
+
+        return self::SUCCESS;
+    }
+
+    /**
+     * Transform a single image for a device model using Blade templates
+     */
+    private function transformImage(string $imageType, DeviceModel $deviceModel, string $targetDir): bool
+    {
+        // Generate filename: {width}_{height}_{bit_depth}_{rotation}.{extension}
+        $extension = $deviceModel->mime_type === 'image/bmp' ? 'bmp' : 'png';
+        $filename = "{$deviceModel->width}_{$deviceModel->height}_{$deviceModel->bit_depth}_{$deviceModel->rotation}.{$extension}";
+        $targetPath = "{$targetDir}/{$imageType}_{$filename}";
+
+        // Check if target already exists and force is not set
+        if (Storage::disk('public')->exists($targetPath) && ! $this->option('force')) {
+            $this->line("  Skipping {$imageType} - already exists: {$filename}");
+
+            return false;
+        }
+
+        try {
+            // Create custom Browsershot instance if using AWS Lambda
+            $browsershotInstance = null;
+            if (config('app.puppeteer_mode') === 'sidecar-aws') {
+                $browsershotInstance = new BrowsershotLambda();
+            }
+
+            // Generate HTML from Blade template
+            $html = $this->generateHtmlFromTemplate($imageType, $deviceModel);
+            // dump($html);
+
+            $browserStage = new BrowserStage($browsershotInstance);
+            $browserStage->html($html);
+
+            // Set timezone from app config (no user context in this command)
+            $browserStage->timezone(config('app.timezone'));
+
+            $browserStage
+                ->width($deviceModel->width)
+                ->height($deviceModel->height);
+
+            $browserStage->setBrowsershotOption('waitUntil', 'networkidle0');
+
+            if (config('app.puppeteer_docker')) {
+                $browserStage->setBrowsershotOption('args', ['--no-sandbox', '--disable-setuid-sandbox', '--disable-gpu']);
+            }
+
+            $outputPath = Storage::disk('public')->path($targetPath);
+
+            $imageStage = new ImageStage();
+            $imageStage->format($extension)
+                ->width($deviceModel->width)
+                ->height($deviceModel->height)
+                ->colors($deviceModel->colors)
+                ->bitDepth($deviceModel->bit_depth)
+                ->rotation($deviceModel->rotation)
+                // ->offsetX($deviceModel->offset_x)
+                // ->offsetY($deviceModel->offset_y)
+                ->outputPath($outputPath);
+
+            (new TrmnlPipeline())->pipe($browserStage)
+                ->pipe($imageStage)
+                ->process();
+
+            if (! file_exists($outputPath)) {
+                throw new RuntimeException('Image file was not created: '.$outputPath);
+            }
+
+            if (filesize($outputPath) === 0) {
+                throw new RuntimeException('Image file is empty: '.$outputPath);
+            }
+
+            $this->line("  ✓ Generated {$imageType}: {$filename}");
+
+            return true;
+
+        } catch (Exception $e) {
+            $this->error("  ✗ Failed to generate {$imageType} for {$deviceModel->label}: ".$e->getMessage());
+
+            return false;
+        }
+    }
+
+    /**
+     * Generate HTML from Blade template for the given image type and device model
+     */
+    private function generateHtmlFromTemplate(string $imageType, DeviceModel $deviceModel): string
+    {
+        // Map image type to template name
+        $templateName = match ($imageType) {
+            'setup-logo' => 'default-screens.setup',
+            'sleep' => 'default-screens.sleep',
+            default => throw new InvalidArgumentException("Invalid image type: {$imageType}")
+        };
+
+        // Determine device properties from DeviceModel
+        $deviceVariant = $deviceModel->name ?? 'og';
+        $colorDepth = $deviceModel->color_depth ?? '1bit'; // Use the accessor method
+        $scaleLevel = $deviceModel->scale_level; // Use the accessor method
+        $darkMode = $imageType === 'sleep'; // Sleep mode uses dark mode, setup uses light mode
+
+        // Render the Blade template
+        return view($templateName, [
+            'noBleed' => false,
+            'darkMode' => $darkMode,
+            'deviceVariant' => $deviceVariant,
+            'colorDepth' => $colorDepth,
+            'scaleLevel' => $scaleLevel,
+        ])->render();
+    }
+}

app/Console/Commands/MashupCreateCommand.php

@@ -9,9 +9,6 @@ use App\Models\Plugin;
 use Illuminate\Console\Command;
 use Illuminate\Support\Collection;
 
-use function Laravel\Prompts\select;
-use function Laravel\Prompts\text;
-
 class MashupCreateCommand extends Command
 {
     /**
@@ -31,17 +28,17 @@ class MashupCreateCommand extends Command
     /**
      * Execute the console command.
      */
-    public function handle()
+    public function handle(): int
     {
         // Select device
         $device = $this->selectDevice();
-        if (! $device) {
+        if (! $device instanceof Device) {
             return 1;
         }
 
         // Select playlist
         $playlist = $this->selectPlaylist($device);
-        if (! $playlist) {
+        if (! $playlist instanceof Playlist) {
             return 1;
         }
 
@@ -88,9 +85,9 @@ class MashupCreateCommand extends Command
             return null;
         }
 
-        $deviceId = select(
-            label: 'Select a device',
-            options: $devices->mapWithKeys(fn ($device) => [$device->id => $device->name])->toArray()
+        $deviceId = $this->choice(
+            'Select a device',
+            $devices->mapWithKeys(fn ($device): array => [$device->id => $device->name])->toArray()
         );
 
         return $devices->firstWhere('id', $deviceId);
@@ -106,9 +103,9 @@ class MashupCreateCommand extends Command
             return null;
         }
 
-        $playlistId = select(
-            label: 'Select a playlist',
-            options: $playlists->mapWithKeys(fn (Playlist $playlist) => [$playlist->id => $playlist->name])->toArray()
+        $playlistId = $this->choice(
+            'Select a playlist',
+            $playlists->mapWithKeys(fn (Playlist $playlist): array => [$playlist->id => $playlist->name])->toArray()
         );
 
         return $playlists->firstWhere('id', $playlistId);
@@ -116,24 +113,29 @@ class MashupCreateCommand extends Command
 
     protected function selectLayout(): ?string
     {
-        return select(
-            label: 'Select a layout',
-            options: PlaylistItem::getAvailableLayouts()
+        return $this->choice(
+            'Select a layout',
+            PlaylistItem::getAvailableLayouts()
         );
     }
 
     protected function getMashupName(): ?string
     {
-        return text(
-            label: 'Enter a name for this mashup',
-            required: true,
-            default: 'Mashup',
-            validate: fn (string $value) => match (true) {
-                mb_strlen($value) < 1 => 'The name must be at least 2 characters.',
-                mb_strlen($value) > 50 => 'The name must not exceed 50 characters.',
-                default => null,
-            }
-        );
+        $name = $this->ask('Enter a name for this mashup', 'Mashup');
+
+        if (mb_strlen((string) $name) < 2) {
+            $this->error('The name must be at least 2 characters.');
+
+            return null;
+        }
+
+        if (mb_strlen((string) $name) > 50) {
+            $this->error('The name must not exceed 50 characters.');
+
+            return null;
+        }
+
+        return $name;
     }
 
     protected function selectPlugins(string $layout): Collection
@@ -148,7 +150,7 @@ class MashupCreateCommand extends Command
         }
 
         $selectedPlugins = collect();
-        $availablePlugins = $plugins->mapWithKeys(fn ($plugin) => [$plugin->id => $plugin->name])->toArray();
+        $availablePlugins = $plugins->mapWithKeys(fn ($plugin): array => [$plugin->id => $plugin->name])->toArray();
 
         for ($i = 0; $i < $requiredCount; ++$i) {
             $position = match ($i) {
@@ -159,9 +161,9 @@ class MashupCreateCommand extends Command
                 default => ($i + 1).'th'
             };
 
-            $pluginId = select(
-                label: "Select the $position plugin",
-                options: $availablePlugins
+            $pluginId = $this->choice(
+                "Select the $position plugin",
+                $availablePlugins
             );
 
             $selectedPlugins->push($plugins->firstWhere('id', $pluginId));

app/Console/Commands/OidcTestCommand.php

@@ -0,0 +1,104 @@
+<?php
+
+namespace App\Console\Commands;
+
+use Exception;
+use Illuminate\Console\Command;
+use InvalidArgumentException;
+use Laravel\Socialite\Facades\Socialite;
+
+class OidcTestCommand extends Command
+{
+    /**
+     * The name and signature of the console command.
+     *
+     * @var string
+     */
+    protected $signature = 'oidc:test';
+
+    /**
+     * The console command description.
+     *
+     * @var string
+     */
+    protected $description = 'Test OIDC configuration and driver registration';
+
+    /**
+     * Execute the console command.
+     */
+    public function handle(): int
+    {
+        $this->info('Testing OIDC Configuration...');
+        $this->newLine();
+
+        // Check if OIDC is enabled
+        $enabled = config('services.oidc.enabled');
+        $this->line('OIDC Enabled: '.($enabled ? '✅ Yes' : '❌ No'));
+
+        // Check configuration values
+        $endpoint = config('services.oidc.endpoint');
+        $clientId = config('services.oidc.client_id');
+        $clientSecret = config('services.oidc.client_secret');
+        $redirect = config('services.oidc.redirect');
+        if (! $redirect) {
+            $redirect = config('app.url', 'http://localhost').'/auth/oidc/callback';
+        }
+        $scopes = config('services.oidc.scopes', []);
+        $defaultScopes = ['openid', 'profile', 'email'];
+        $effectiveScopes = empty($scopes) ? $defaultScopes : $scopes;
+
+        $this->line('OIDC Endpoint: '.($endpoint ? "✅ {$endpoint}" : '❌ Not set'));
+        $this->line('Client ID: '.($clientId ? "✅ {$clientId}" : '❌ Not set'));
+        $this->line('Client Secret: '.($clientSecret ? '✅ Set' : '❌ Not set'));
+        $this->line('Redirect URL: '.($redirect ? "✅ {$redirect}" : '❌ Not set'));
+        $this->line('Scopes: ✅ '.implode(', ', $effectiveScopes));
+
+        $this->newLine();
+
+        // Test driver registration
+        try {
+            // Only test driver if we have basic configuration
+            if ($endpoint && $clientId && $clientSecret) {
+                $driver = Socialite::driver('oidc');
+                $this->line('OIDC Driver: ✅ Successfully registered and accessible');
+
+                if ($enabled) {
+                    $this->info('✅ OIDC is fully configured and ready to use!');
+                    $this->line('You can test the login flow at: /auth/oidc/redirect');
+                } else {
+                    $this->warn('⚠️ OIDC driver is working but OIDC_ENABLED is false.');
+                }
+            } else {
+                $this->line('OIDC Driver: ✅ Registered (configuration test skipped due to missing values)');
+                $this->warn('⚠️ OIDC driver is registered but missing required configuration.');
+                $this->line('Please set the following environment variables:');
+                if (! $enabled) {
+                    $this->line('  - OIDC_ENABLED=true');
+                }
+                if (! $endpoint) {
+                    $this->line('  - OIDC_ENDPOINT=https://your-oidc-provider.com  (base URL)');
+                    $this->line('    OR');
+                    $this->line('  - OIDC_ENDPOINT=https://your-oidc-provider.com/.well-known/openid-configuration  (full URL)');
+                }
+                if (! $clientId) {
+                    $this->line('  - OIDC_CLIENT_ID=your-client-id');
+                }
+                if (! $clientSecret) {
+                    $this->line('  - OIDC_CLIENT_SECRET=your-client-secret');
+                }
+            }
+        } catch (InvalidArgumentException $e) {
+            if (str_contains($e->getMessage(), 'Driver [oidc] not supported')) {
+                $this->error('❌ OIDC Driver registration failed: Driver not supported');
+            } else {
+                $this->error('❌ OIDC Driver error: '.$e->getMessage());
+            }
+        } catch (Exception $e) {
+            $this->warn('⚠️ OIDC Driver registered but configuration error: '.$e->getMessage());
+        }
+
+        $this->newLine();
+
+        return Command::SUCCESS;
+    }
+}

app/Console/Commands/ScreenGeneratorCommand.php

@@ -25,7 +25,7 @@ class ScreenGeneratorCommand extends Command
     /**
      * Execute the console command.
      */
-    public function handle()
+    public function handle(): int
     {
         $deviceId = $this->argument('deviceId');
         $view = $this->argument('view');

app/Enums/ImageFormat.php

@@ -8,6 +8,7 @@ enum ImageFormat: string
     case PNG_8BIT_GRAYSCALE = 'png_8bit_grayscale';
     case BMP3_1BIT_SRGB = 'bmp3_1bit_srgb';
     case PNG_8BIT_256C = 'png_8bit_256c';
+    case PNG_2BIT_4C = 'png_2bit_4c';
 
     public function label(): string
     {
@@ -16,6 +17,7 @@ enum ImageFormat: string
             self::PNG_8BIT_GRAYSCALE => 'PNG 8-bit Grayscale Gray 2c',
             self::BMP3_1BIT_SRGB => 'BMP3 1-bit sRGB 2c',
             self::PNG_8BIT_256C => 'PNG 8-bit Grayscale Gray 256c',
+            self::PNG_2BIT_4C => 'PNG 2-bit Grayscale 4c',
         };
     }
 }

app/Http/Controllers/Auth/OidcController.php

@@ -0,0 +1,123 @@
+<?php
+
+namespace App\Http\Controllers\Auth;
+
+use App\Http\Controllers\Controller;
+use App\Models\User;
+use Exception;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Auth;
+use Illuminate\Support\Facades\Log;
+use Illuminate\Support\Str;
+use Laravel\Socialite\Facades\Socialite;
+
+class OidcController extends Controller
+{
+    /**
+     * Redirect the user to the OIDC provider authentication page.
+     */
+    public function redirect()
+    {
+        if (! config('services.oidc.enabled')) {
+            return redirect()->route('login')->withErrors(['oidc' => 'OIDC authentication is not enabled.']);
+        }
+
+        // Check if all required OIDC configuration is present
+        $requiredConfig = ['endpoint', 'client_id', 'client_secret'];
+        foreach ($requiredConfig as $key) {
+            if (! config("services.oidc.{$key}")) {
+                Log::error("OIDC configuration missing: {$key}");
+
+                return redirect()->route('login')->withErrors(['oidc' => 'OIDC is not properly configured.']);
+            }
+        }
+
+        try {
+            return Socialite::driver('oidc')->redirect();
+        } catch (Exception $e) {
+            Log::error('OIDC redirect error: '.$e->getMessage());
+
+            return redirect()->route('login')->withErrors(['oidc' => 'Failed to initiate OIDC authentication.']);
+        }
+    }
+
+    /**
+     * Obtain the user information from the OIDC provider.
+     */
+    public function callback(Request $request)
+    {
+        if (! config('services.oidc.enabled')) {
+            return redirect()->route('login')->withErrors(['oidc' => 'OIDC authentication is not enabled.']);
+        }
+
+        // Check if all required OIDC configuration is present
+        $requiredConfig = ['endpoint', 'client_id', 'client_secret'];
+        foreach ($requiredConfig as $key) {
+            if (! config("services.oidc.{$key}")) {
+                Log::error("OIDC configuration missing: {$key}");
+
+                return redirect()->route('login')->withErrors(['oidc' => 'OIDC is not properly configured.']);
+            }
+        }
+
+        try {
+            $oidcUser = Socialite::driver('oidc')->user();
+
+            // Find or create the user
+            $user = $this->findOrCreateUser($oidcUser);
+
+            // Log the user in
+            Auth::login($user, true);
+
+            return redirect()->intended(route('dashboard', absolute: false));
+
+        } catch (Exception $e) {
+            Log::error('OIDC callback error: '.$e->getMessage());
+
+            return redirect()->route('login')->withErrors(['oidc' => 'Failed to authenticate with OIDC provider.']);
+        }
+    }
+
+    /**
+     * Find or create a user based on OIDC information.
+     */
+    protected function findOrCreateUser($oidcUser)
+    {
+        // First, try to find user by OIDC subject ID
+        $user = User::where('oidc_sub', $oidcUser->getId())->first();
+
+        if ($user) {
+            // Update user information from OIDC
+            $user->update([
+                'name' => $oidcUser->getName() ?: $user->name,
+                'email' => $oidcUser->getEmail() ?: $user->email,
+            ]);
+
+            return $user;
+        }
+
+        // If not found by OIDC sub, try to find by email
+        if ($oidcUser->getEmail()) {
+            $user = User::where('email', $oidcUser->getEmail())->first();
+
+            if ($user) {
+                // Link the existing user with OIDC
+                $user->update([
+                    'oidc_sub' => $oidcUser->getId(),
+                    'name' => $oidcUser->getName() ?: $user->name,
+                ]);
+
+                return $user;
+            }
+        }
+
+        // Create new user
+        return User::create([
+            'oidc_sub' => $oidcUser->getId(),
+            'name' => $oidcUser->getName() ?: 'OIDC User',
+            'email' => $oidcUser->getEmail() ?: $oidcUser->getId().'@oidc.local',
+            'password' => bcrypt(Str::random(32)), // Random password since we're using OIDC
+            'email_verified_at' => now(), // OIDC users are considered verified
+        ]);
+    }
+}

app/Jobs/CleanupDeviceLogsJob.php

@@ -18,7 +18,7 @@ class CleanupDeviceLogsJob implements ShouldQueue
      */
     public function handle(): void
     {
-        Device::each(function ($device) {
+        Device::each(function ($device): void {
             $keepIds = $device->logs()->latest('device_timestamp')->take(50)->pluck('id');
 
             // Delete all other logs for this device

app/Jobs/FetchDeviceModelsJob.php

@@ -0,0 +1,247 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Jobs;
+
+use App\Models\DeviceModel;
+use App\Models\DevicePalette;
+use Exception;
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Foundation\Bus\Dispatchable;
+use Illuminate\Queue\InteractsWithQueue;
+use Illuminate\Queue\SerializesModels;
+use Illuminate\Support\Facades\Http;
+use Illuminate\Support\Facades\Log;
+
+final class FetchDeviceModelsJob implements ShouldQueue
+{
+    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
+
+    private const API_URL = 'https://usetrmnl.com/api/models';
+
+    private const PALETTES_API_URL = 'http://usetrmnl.com/api/palettes';
+
+    /**
+     * Create a new job instance.
+     */
+    public function __construct()
+    {
+        //
+    }
+
+    /**
+     * Execute the job.
+     */
+    public function handle(): void
+    {
+        try {
+            $this->processPalettes();
+
+            $response = Http::timeout(30)->get(self::API_URL);
+
+            if (! $response->successful()) {
+                Log::error('Failed to fetch device models from API', [
+                    'status' => $response->status(),
+                    'body' => $response->body(),
+                ]);
+
+                return;
+            }
+
+            $data = $response->json('data', []);
+
+            if (! is_array($data)) {
+                Log::error('Invalid response format from device models API', [
+                    'response' => $response->json(),
+                ]);
+
+                return;
+            }
+
+            $this->processDeviceModels($data);
+
+            Log::info('Successfully fetched and updated device models', [
+                'count' => count($data),
+            ]);
+
+        } catch (Exception $e) {
+            Log::error('Exception occurred while fetching device models', [
+                'message' => $e->getMessage(),
+                'trace' => $e->getTraceAsString(),
+            ]);
+        }
+    }
+
+    /**
+     * Process palettes from API and update/create records.
+     */
+    private function processPalettes(): void
+    {
+        try {
+            $response = Http::timeout(30)->get(self::PALETTES_API_URL);
+
+            if (! $response->successful()) {
+                Log::error('Failed to fetch palettes from API', [
+                    'status' => $response->status(),
+                    'body' => $response->body(),
+                ]);
+
+                return;
+            }
+
+            $data = $response->json('data', []);
+
+            if (! is_array($data)) {
+                Log::error('Invalid response format from palettes API', [
+                    'response' => $response->json(),
+                ]);
+
+                return;
+            }
+
+            foreach ($data as $paletteData) {
+                try {
+                    $this->updateOrCreatePalette($paletteData);
+                } catch (Exception $e) {
+                    Log::error('Failed to process palette', [
+                        'palette_data' => $paletteData,
+                        'error' => $e->getMessage(),
+                    ]);
+                }
+            }
+
+            Log::info('Successfully fetched and updated palettes', [
+                'count' => count($data),
+            ]);
+
+        } catch (Exception $e) {
+            Log::error('Exception occurred while fetching palettes', [
+                'message' => $e->getMessage(),
+                'trace' => $e->getTraceAsString(),
+            ]);
+        }
+    }
+
+    /**
+     * Update or create a palette record.
+     */
+    private function updateOrCreatePalette(array $paletteData): void
+    {
+        $name = $paletteData['id'] ?? null;
+
+        if (! $name) {
+            Log::warning('Palette data missing id field', [
+                'palette_data' => $paletteData,
+            ]);
+
+            return;
+        }
+
+        $attributes = [
+            'name' => $name,
+            'description' => $paletteData['name'] ?? '',
+            'grays' => $paletteData['grays'] ?? 2,
+            'colors' => $paletteData['colors'] ?? null,
+            'framework_class' => $paletteData['framework_class'] ?? '',
+            'source' => 'api',
+        ];
+
+        DevicePalette::updateOrCreate(
+            ['name' => $name],
+            $attributes
+        );
+    }
+
+    /**
+     * Process the device models data and update/create records.
+     */
+    private function processDeviceModels(array $deviceModels): void
+    {
+        foreach ($deviceModels as $modelData) {
+            try {
+                $this->updateOrCreateDeviceModel($modelData);
+            } catch (Exception $e) {
+                Log::error('Failed to process device model', [
+                    'model_data' => $modelData,
+                    'error' => $e->getMessage(),
+                ]);
+            }
+        }
+    }
+
+    /**
+     * Update or create a device model record.
+     */
+    private function updateOrCreateDeviceModel(array $modelData): void
+    {
+        $name = $modelData['name'] ?? null;
+
+        if (! $name) {
+            Log::warning('Device model data missing name field', [
+                'model_data' => $modelData,
+            ]);
+
+            return;
+        }
+
+        $attributes = [
+            'label' => $modelData['label'] ?? '',
+            'description' => $modelData['description'] ?? '',
+            'width' => $modelData['width'] ?? 0,
+            'height' => $modelData['height'] ?? 0,
+            'colors' => $modelData['colors'] ?? 0,
+            'bit_depth' => $modelData['bit_depth'] ?? 0,
+            'scale_factor' => $modelData['scale_factor'] ?? 1,
+            'rotation' => $modelData['rotation'] ?? 0,
+            'mime_type' => $modelData['mime_type'] ?? '',
+            'offset_x' => $modelData['offset_x'] ?? 0,
+            'offset_y' => $modelData['offset_y'] ?? 0,
+            'published_at' => $modelData['published_at'] ?? null,
+            'kind' => $modelData['kind'] ?? null,
+            'source' => 'api',
+        ];
+
+        // Set palette_id to the first palette from the model's palettes array
+        $firstPaletteId = $this->getFirstPaletteId($modelData);
+        if ($firstPaletteId) {
+            $attributes['palette_id'] = $firstPaletteId;
+        }
+
+        DeviceModel::updateOrCreate(
+            ['name' => $name],
+            $attributes
+        );
+    }
+
+    /**
+     * Get the first palette ID from model data.
+     */
+    private function getFirstPaletteId(array $modelData): ?int
+    {
+        $paletteName = null;
+
+        // Check for palette_ids array
+        if (isset($modelData['palette_ids']) && is_array($modelData['palette_ids']) && $modelData['palette_ids'] !== []) {
+            $paletteName = $modelData['palette_ids'][0];
+        }
+
+        // Check for palettes array (array of objects with id)
+        if (! $paletteName && isset($modelData['palettes']) && is_array($modelData['palettes']) && $modelData['palettes'] !== []) {
+            $firstPalette = $modelData['palettes'][0];
+            if (is_array($firstPalette) && isset($firstPalette['id'])) {
+                $paletteName = $firstPalette['id'];
+            }
+        }
+
+        if (! $paletteName) {
+            return null;
+        }
+
+        // Look up palette by name to get the integer ID
+        $palette = DevicePalette::where('name', $paletteName)->first();
+
+        return $palette?->id;
+    }
+}

app/Jobs/FetchProxyCloudResponses.php

@@ -23,7 +23,7 @@ class FetchProxyCloudResponses implements ShouldQueue
      */
     public function handle(): void
     {
-        Device::where('proxy_cloud', true)->each(function ($device) {
+        Device::where('proxy_cloud', true)->each(function ($device): void {
             if (! $device->getNextPlaylistItem()) {
                 try {
                     $response = Http::withHeaders([
@@ -78,22 +78,30 @@ class FetchProxyCloudResponses implements ShouldQueue
                     Log::info("Successfully updated proxy cloud response for device: {$device->mac_address}");
 
                     if ($device->last_log_request) {
-                        Http::withHeaders([
-                            'id' => $device->mac_address,
-                            'access-token' => $device->api_key,
-                            'width' => 800,
-                            'height' => 480,
-                            'rssi' => $device->last_rssi_level,
-                            'battery_voltage' => $device->last_battery_voltage,
-                            'refresh-rate' => $device->default_refresh_interval,
-                            'fw-version' => $device->last_firmware_version,
-                            'accept-encoding' => 'identity;q=1,chunked;q=0.1,*;q=0',
-                            'user-agent' => 'ESP32HTTPClient',
-                        ])->post(config('services.trmnl.proxy_base_url').'/api/log', $device->last_log_request);
+                        try {
+                            Http::withHeaders([
+                                'id' => $device->mac_address,
+                                'access-token' => $device->api_key,
+                                'width' => 800,
+                                'height' => 480,
+                                'rssi' => $device->last_rssi_level,
+                                'battery_voltage' => $device->last_battery_voltage,
+                                'refresh-rate' => $device->default_refresh_interval,
+                                'fw-version' => $device->last_firmware_version,
+                                'accept-encoding' => 'identity;q=1,chunked;q=0.1,*;q=0',
+                                'user-agent' => 'ESP32HTTPClient',
+                            ])->post(config('services.trmnl.proxy_base_url').'/api/log', $device->last_log_request);
 
-                        $device->update([
-                            'last_log_request' => null,
-                        ]);
+                            // Only clear the pending log request if the POST succeeded
+                            $device->update([
+                                'last_log_request' => null,
+                            ]);
+                        } catch (Exception $e) {
+                            // Do not fail the entire proxy fetch if the log upload fails
+                            Log::error("Failed to upload device log for device: {$device->mac_address}", [
+                                'error' => $e->getMessage(),
+                            ]);
+                        }
                     }
 
                 } catch (Exception $e) {

app/Jobs/FirmwareDownloadJob.php

@@ -18,12 +18,7 @@ class FirmwareDownloadJob implements ShouldQueue
 {
     use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
 
-    private Firmware $firmware;
-
-    public function __construct(Firmware $firmware)
-    {
-        $this->firmware = $firmware;
-    }
+    public function __construct(private Firmware $firmware) {}
 
     public function handle(): void
     {
@@ -33,16 +28,25 @@ class FirmwareDownloadJob implements ShouldQueue
 
         try {
             $filename = "FW{$this->firmware->version_tag}.bin";
-            Http::sink(storage_path("app/public/firmwares/$filename"))
-                ->get($this->firmware->url);
+            $response = Http::get($this->firmware->url);
 
+            if (! $response->successful()) {
+                throw new Exception('HTTP request failed with status: '.$response->status());
+            }
+
+            // Save the response content to file
+            Storage::disk('public')->put("firmwares/$filename", $response->body());
+
+            // Only update storage location if download was successful
             $this->firmware->update([
                 'storage_location' => "firmwares/$filename",
             ]);
         } catch (ConnectionException $e) {
             Log::error('Firmware download failed: '.$e->getMessage());
+            // Don't update storage_location on failure
         } catch (Exception $e) {
             Log::error('An unexpected error occurred: '.$e->getMessage());
+            // Don't update storage_location on failure
         }
     }
 }

app/Jobs/FirmwarePollJob.php

@@ -17,12 +17,7 @@ class FirmwarePollJob implements ShouldQueue
 {
     use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
 
-    private bool $download;
-
-    public function __construct(bool $download = false)
-    {
-        $this->download = $download;
-    }
+    public function __construct(private bool $download = false) {}
 
     public function handle(): void
     {

app/Jobs/NotifyDeviceBatteryLowJob.php

@@ -15,8 +15,6 @@ class NotifyDeviceBatteryLowJob implements ShouldQueue
 {
     use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
 
-    public function __construct() {}
-
     public function handle(): void
     {
         $devices = Device::all();
@@ -32,9 +30,11 @@ class NotifyDeviceBatteryLowJob implements ShouldQueue
 
                 continue;
             }
-
             // Skip if battery is not low or notification was already sent
-            if ($batteryPercent > $batteryThreshold || $device->battery_notification_sent) {
+            if ($batteryPercent > $batteryThreshold) {
+                continue;
+            }
+            if ($device->battery_notification_sent) {
                 continue;
             }
 

app/Liquid/FileSystems/InlineTemplatesFileSystem.php

@@ -0,0 +1,62 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Liquid\FileSystems;
+
+use InvalidArgumentException;
+use Keepsuit\Liquid\Contracts\LiquidFileSystem;
+
+/**
+ * A file system that allows registering inline templates defined with the template tag
+ */
+class InlineTemplatesFileSystem implements LiquidFileSystem
+{
+    /**
+     * @var array<string, string>
+     */
+    protected array $templates = [];
+
+    /**
+     * Register a template with the given name and content
+     */
+    public function register(string $name, string $content): void
+    {
+        $this->templates[$name] = $content;
+    }
+
+    /**
+     * Check if a template exists
+     */
+    public function hasTemplate(string $templateName): bool
+    {
+        return isset($this->templates[$templateName]);
+    }
+
+    /**
+     * Get all registered template names
+     *
+     * @return array<string>
+     */
+    public function getTemplateNames(): array
+    {
+        return array_keys($this->templates);
+    }
+
+    /**
+     * Clear all registered templates
+     */
+    public function clear(): void
+    {
+        $this->templates = [];
+    }
+
+    public function readTemplateFile(string $templateName): string
+    {
+        if (! isset($this->templates[$templateName])) {
+            throw new InvalidArgumentException("Template '{$templateName}' not found in inline templates");
+        }
+
+        return $this->templates[$templateName];
+    }
+}

app/Liquid/Filters/Data.php

@@ -0,0 +1,136 @@
+<?php
+
+namespace App\Liquid\Filters;
+
+use App\Liquid\Utils\ExpressionUtils;
+use Keepsuit\Liquid\Filters\FiltersProvider;
+
+/**
+ * Data filters for Liquid templates
+ */
+class Data extends FiltersProvider
+{
+    /**
+     * Convert a variable to JSON
+     *
+     * @param  mixed  $value  The variable to convert
+     * @return string JSON representation of the variable
+     */
+    public function json(mixed $value): string
+    {
+        return json_encode($value, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
+    }
+
+    /**
+     * Find an object in a collection by a specific key-value pair
+     *
+     * @param  array  $collection  The collection to search in
+     * @param  string  $key  The key to search for
+     * @param  mixed  $value  The value to match
+     * @param  mixed  $fallback  Optional fallback value if no match is found
+     * @return mixed The matching object or fallback value
+     */
+    public function find_by(array $collection, string $key, mixed $value, mixed $fallback = null): mixed
+    {
+        foreach ($collection as $item) {
+            if (is_array($item) && isset($item[$key]) && $item[$key] === $value) {
+                return $item;
+            }
+        }
+
+        return $fallback;
+    }
+
+    /**
+     * Group a collection by a specific key
+     *
+     * @param  array  $collection  The collection to group
+     * @param  string  $key  The key to group by
+     * @return array The grouped collection
+     */
+    public function group_by(array $collection, string $key): array
+    {
+        $grouped = [];
+
+        foreach ($collection as $item) {
+            if (is_array($item) && array_key_exists($key, $item)) {
+                $groupKey = $item[$key];
+                if (! isset($grouped[$groupKey])) {
+                    $grouped[$groupKey] = [];
+                }
+                $grouped[$groupKey][] = $item;
+            }
+        }
+
+        return $grouped;
+    }
+
+    /**
+     * Return a random element from an array
+     *
+     * @param  array  $array  The array to sample from
+     * @return mixed A random element from the array
+     */
+    public function sample(array $array): mixed
+    {
+        if ($array === []) {
+            return null;
+        }
+
+        return $array[array_rand($array)];
+    }
+
+    /**
+     * Parse a JSON string into a PHP value
+     *
+     * @param  string  $json  The JSON string to parse
+     * @return mixed The parsed JSON value
+     */
+    public function parse_json(string $json): mixed
+    {
+        return json_decode($json, true);
+    }
+
+    /**
+     * Filter a collection using an expression
+     *
+     * @param  mixed  $input  The collection to filter
+     * @param  string  $variable  The variable name to use in the expression
+     * @param  string  $expression  The expression to evaluate
+     * @return array The filtered collection
+     */
+    public function where_exp(mixed $input, string $variable, string $expression): array
+    {
+        // Return input as-is if it's not an array or doesn't have values method
+        if (! is_array($input)) {
+            return is_string($input) ? [$input] : [];
+        }
+
+        // Convert hash to array of values if needed
+        if (ExpressionUtils::isAssociativeArray($input)) {
+            $input = array_values($input);
+        }
+
+        $condition = ExpressionUtils::parseCondition($expression);
+        $result = [];
+
+        foreach ($input as $object) {
+            if (ExpressionUtils::evaluateCondition($condition, $variable, $object)) {
+                $result[] = $object;
+            }
+        }
+
+        return $result;
+    }
+
+    /**
+     * Convert array of strings to integers
+     *
+     * @param  array  $input  Array of string numbers
+     * @return array Array of integers
+     */
+    public function map_to_i(array $input): array
+    {
+        return array_map(intval(...), $input);
+    }
+}

app/Liquid/Filters/Date.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace App\Liquid\Filters;
+
+use App\Liquid\Utils\ExpressionUtils;
+use Carbon\Carbon;
+use Keepsuit\Liquid\Filters\FiltersProvider;
+
+/**
+ * Data filters for Liquid templates
+ */
+class Date extends FiltersProvider
+{
+    /**
+     * Calculate a date that is a specified number of days in the past
+     *
+     * @param  int|string  $num  The number of days to subtract
+     * @return string The date in Y-m-d format
+     */
+    public function days_ago(int|string $num): string
+    {
+        $days = (int) $num;
+
+        return Carbon::now()->subDays($days)->toDateString();
+    }
+
+    /**
+     * Format a date string with ordinal day (1st, 2nd, 3rd, etc.)
+     *
+     * @param  string  $dateStr  The date string to parse
+     * @param  string  $strftimeExp  The strftime format string with <<ordinal_day>> placeholder
+     * @return string The formatted date with ordinal day
+     */
+    public function ordinalize(string $dateStr, string $strftimeExp): string
+    {
+        $date = Carbon::parse($dateStr);
+        $ordinalDay = $date->ordinal('day');
+
+        // Convert strftime format to PHP date format
+        $phpFormat = ExpressionUtils::strftimeToPhpFormat($strftimeExp);
+
+        // Split the format string by the ordinal day placeholder
+        $parts = explode('<<ordinal_day>>', $phpFormat);
+
+        if (count($parts) === 2) {
+            $before = $date->format($parts[0]);
+            $after = $date->format($parts[1]);
+
+            return $before.$ordinalDay.$after;
+        }
+
+        // Fallback: if no placeholder found, just format normally
+        return $date->format($phpFormat);
+    }
+}

app/Liquid/Filters/Localization.php

@@ -0,0 +1,52 @@
+<?php
+
+namespace App\Liquid\Filters;
+
+use DateTimeInterface;
+use Illuminate\Support\Carbon;
+use Keepsuit\Liquid\Filters\FiltersProvider;
+
+/**
+ * Localization filters for Liquid templates
+ *
+ * Uses Laravel's translator for word translations. Translation files are located in the
+ * lang/{locale}/custom_plugins.php files.
+ */
+class Localization extends FiltersProvider
+{
+    /**
+     * Localize a date with strftime syntax
+     *
+     * @param  mixed  $date  The date to localize (string or DateTime)
+     * @param  string  $format  The strftime format string
+     * @param  string|null  $locale  The locale to use for localization
+     * @return string The localized date string
+     */
+    public function l_date(mixed $date, string $format = 'Y-m-d', ?string $locale = null): string
+    {
+        $carbon = $date instanceof DateTimeInterface ? Carbon::instance($date) : Carbon::parse($date);
+        if ($locale) {
+            $carbon->locale($locale);
+        }
+
+        return $carbon->translatedFormat($format);
+    }
+
+    /**
+     * Translate a common word to another language
+     *
+     * @param  string  $word  The word to translate
+     * @param  string  $locale  The locale to translate to
+     * @return string The translated word
+     */
+    public function l_word(string $word, string $locale): string
+    {
+        $translation = trans('custom_plugins.'.mb_strtolower($word), locale: $locale);
+
+        if ($translation === 'custom_plugins.'.mb_strtolower($word)) {
+            return $word;
+        }
+
+        return $translation;
+    }
+}

app/Liquid/Filters/Numbers.php

@@ -0,0 +1,50 @@
+<?php
+
+namespace App\Liquid\Filters;
+
+use Illuminate\Support\Number;
+use Keepsuit\Liquid\Filters\FiltersProvider;
+
+class Numbers extends FiltersProvider
+{
+    /**
+     * Format a number with delimiters (default: comma)
+     *
+     * @param  mixed  $value  The number to format
+     * @param  string  $delimiter  The delimiter to use (default: comma)
+     * @param  string  $separator  The separator for decimal part (default: period)
+     */
+    public function number_with_delimiter(mixed $value, string $delimiter = ',', string $separator = '.'): string
+    {
+        // 2 decimal places for floats, 0 for integers
+        $decimal = is_float($value + 0) ? 2 : 0;
+
+        return number_format($value, decimals: $decimal, decimal_separator: $separator, thousands_separator: $delimiter);
+    }
+
+    /**
+     * Format a number as currency
+     *
+     * @param  mixed  $value  The number to format
+     * @param  string  $currency  Currency symbol or locale code
+     * @param  string  $delimiter  The delimiter to use (default: comma)
+     * @param  string  $separator  The separator for decimal part (default: period)
+     */
+    public function number_to_currency(mixed $value, string $currency = 'USD', string $delimiter = ',', string $separator = '.'): string
+    {
+        if ($currency === '$') {
+            $currency = 'USD';
+        } elseif ($currency === '€') {
+            $currency = 'EUR';
+        } elseif ($currency === '£') {
+            $currency = 'GBP';
+        }
+
+        $locale = $delimiter === '.' && $separator === ',' ? 'de' : 'en';
+
+        // 2 decimal places for floats, 0 for integers
+        $decimal = is_float($value + 0) ? 2 : 0;
+
+        return Number::currency($value, in: $currency, locale: $locale, precision: $decimal);
+    }
+}

app/Liquid/Filters/StandardFilters.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace App\Liquid\Filters;
+
+class StandardFilters extends \Keepsuit\Liquid\Filters\StandardFilters
+{
+    /**
+     * Converts any URL-unsafe characters in a string to the
+     * [percent-encoded](https://developer.mozilla.org/en-US/docs/Glossary/percent-encoding) equivalent.
+     */
+    public function urlEncode(string|int|float|array|null $input): string
+    {
+
+        if (is_array($input)) {
+            $input = json_encode($input);
+        }
+
+        return parent::urlEncode($input);
+    }
+}

app/Liquid/Filters/StringMarkup.php

@@ -0,0 +1,61 @@
+<?php
+
+namespace App\Liquid\Filters;
+
+use Illuminate\Support\Facades\Log;
+use Illuminate\Support\Str;
+use Keepsuit\Liquid\Filters\FiltersProvider;
+use League\CommonMark\CommonMarkConverter;
+use League\CommonMark\Exception\CommonMarkException;
+
+/**
+ * String, Markup, and HTML filters for Liquid templates
+ */
+class StringMarkup extends FiltersProvider
+{
+    /**
+     * Pluralize a word based on count
+     *
+     * @param  string  $word  The word to pluralize
+     * @param  int  $count  The count to determine pluralization
+     * @return string The pluralized word with count
+     */
+    public function pluralize(string $word, int $count = 2): string
+    {
+        if ($count === 1) {
+            return "{$count} {$word}";
+        }
+
+        return "{$count} ".Str::plural($word, $count);
+    }
+
+    /**
+     * Convert markdown to HTML
+     *
+     * @param  string  $markdown  The markdown text to convert
+     * @return string The HTML representation of the markdown
+     */
+    public function markdown_to_html(string $markdown): ?string
+    {
+        $converter = new CommonMarkConverter();
+
+        try {
+            return $converter->convert($markdown);
+        } catch (CommonMarkException $e) {
+            Log::error('Markdown conversion error: '.$e->getMessage());
+        }
+
+        return null;
+    }
+
+    /**
+     * Strip HTML tags from a string
+     *
+     * @param  string  $html  The HTML string to strip
+     * @return string The string without HTML tags
+     */
+    public function strip_html(string $html): string
+    {
+        return strip_tags($html);
+    }
+}

app/Liquid/Filters/Uniqueness.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace App\Liquid\Filters;
+
+use Keepsuit\Liquid\Concerns\ContextAware;
+use Keepsuit\Liquid\Filters\FiltersProvider;
+
+/**
+ * Uniqueness filters for Liquid templates
+ */
+class Uniqueness extends FiltersProvider
+{
+    use ContextAware;
+
+    /**
+     * Append a random string to ensure uniqueness within a template
+     *
+     * @param  string  $prefix  The prefix to append the random string to
+     * @return string The prefix with a random string appended
+     */
+    public function append_random(string $prefix): string
+    {
+        return $prefix.$this->generateRandomString();
+    }
+
+    /**
+     * Generate a random string
+     *
+     * @param  int  $length  The length of the random string
+     * @return string A random string
+     */
+    private function generateRandomString(int $length = 4): string
+    {
+        $characters = 'abcdefghijklmnopqrstuvwxyz0123456789';
+        $randomString = '';
+
+        for ($i = 0; $i < $length; ++$i) {
+            $randomString .= $characters[random_int(0, mb_strlen($characters) - 1)];
+        }
+
+        return $randomString;
+    }
+}

app/Liquid/Tags/TemplateTag.php

@@ -0,0 +1,100 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Liquid\Tags;
+
+use App\Liquid\FileSystems\InlineTemplatesFileSystem;
+use Keepsuit\Liquid\Exceptions\SyntaxException;
+use Keepsuit\Liquid\Nodes\BodyNode;
+use Keepsuit\Liquid\Nodes\Raw;
+use Keepsuit\Liquid\Nodes\VariableLookup;
+use Keepsuit\Liquid\Parse\TagParseContext;
+use Keepsuit\Liquid\Render\RenderContext;
+use Keepsuit\Liquid\TagBlock;
+
+/**
+ * The {% template [name] %} tag block is used to define custom templates within the context of the current Liquid template.
+ * These templates are registered with the InlineTemplatesFileSystem and can be rendered using the render tag.
+ */
+class TemplateTag extends TagBlock
+{
+    protected string $templateName;
+
+    protected Raw $body;
+
+    public static function tagName(): string
+    {
+        return 'template';
+    }
+
+    public static function hasRawBody(): bool
+    {
+        return true;
+    }
+
+    public function parse(TagParseContext $context): static
+    {
+        // Get the template name from the tag parameters
+        $templateNameExpression = $context->params->expression();
+
+        $this->templateName = match (true) {
+            is_string($templateNameExpression) => mb_trim($templateNameExpression),
+            is_numeric($templateNameExpression) => (string) $templateNameExpression,
+            $templateNameExpression instanceof VariableLookup => (string) $templateNameExpression,
+            default => throw new SyntaxException('Template name must be a string, number, or variable'),
+        };
+
+        // Validate template name (letters, numbers, underscores, and slashes only)
+        if (! preg_match('/^[a-zA-Z0-9_\/]+$/', $this->templateName)) {
+            throw new SyntaxException("Invalid template name '{$this->templateName}' - template names must contain only letters, numbers, underscores, and slashes");
+        }
+
+        $context->params->assertEnd();
+
+        assert($context->body instanceof BodyNode);
+
+        $body = $context->body->children()[0] ?? null;
+        $this->body = match (true) {
+            $body instanceof Raw => $body,
+            default => throw new SyntaxException('template tag must have a single raw body'),
+        };
+
+        // Register the template with the file system during parsing
+        $fileSystem = $context->getParseContext()->environment->fileSystem;
+        if ($fileSystem instanceof InlineTemplatesFileSystem) {
+            // Store the raw content for later rendering
+            $fileSystem->register($this->templateName, $this->body->value);
+        }
+
+        return $this;
+    }
+
+    public function render(RenderContext $context): string
+    {
+        // Get the file system from the environment
+        $fileSystem = $context->environment->fileSystem;
+
+        if (! $fileSystem instanceof InlineTemplatesFileSystem) {
+            // If no inline file system is available, just return empty string
+            // This allows the template to be used in contexts where inline templates aren't supported
+            return '';
+        }
+
+        // Register the template with the file system
+        $fileSystem->register($this->templateName, $this->body->render($context));
+
+        // Return empty string as template tags don't output anything
+        return '';
+    }
+
+    public function getTemplateName(): string
+    {
+        return $this->templateName;
+    }
+
+    public function getBody(): Raw
+    {
+        return $this->body;
+    }
+}

app/Liquid/Utils/ExpressionUtils.php

@@ -0,0 +1,210 @@
+<?php
+
+namespace App\Liquid\Utils;
+
+/**
+ * Utility class for parsing and evaluating expressions in Liquid filters
+ */
+class ExpressionUtils
+{
+    /**
+     * Check if an array is associative
+     */
+    public static function isAssociativeArray(array $array): bool
+    {
+        if ($array === []) {
+            return false;
+        }
+
+        return array_keys($array) !== range(0, count($array) - 1);
+    }
+
+    /**
+     * Parse a condition expression into a structured format
+     */
+    public static function parseCondition(string $expression): array
+    {
+        $expression = mb_trim($expression);
+
+        // Handle logical operators (and, or)
+        if (str_contains($expression, ' and ')) {
+            $parts = explode(' and ', $expression, 2);
+
+            return [
+                'type' => 'and',
+                'left' => self::parseCondition(mb_trim($parts[0])),
+                'right' => self::parseCondition(mb_trim($parts[1])),
+            ];
+        }
+
+        if (str_contains($expression, ' or ')) {
+            $parts = explode(' or ', $expression, 2);
+
+            return [
+                'type' => 'or',
+                'left' => self::parseCondition(mb_trim($parts[0])),
+                'right' => self::parseCondition(mb_trim($parts[1])),
+            ];
+        }
+
+        // Handle comparison operators
+        $operators = ['>=', '<=', '!=', '==', '>', '<', '='];
+
+        foreach ($operators as $operator) {
+            if (str_contains($expression, $operator)) {
+                $parts = explode($operator, $expression, 2);
+
+                return [
+                    'type' => 'comparison',
+                    'left' => mb_trim($parts[0]),
+                    'operator' => $operator === '=' ? '==' : $operator,
+                    'right' => mb_trim($parts[1]),
+                ];
+            }
+        }
+
+        // If no operator found, treat as a simple expression
+        return [
+            'type' => 'simple',
+            'expression' => $expression,
+        ];
+    }
+
+    /**
+     * Evaluate a condition against an object
+     */
+    public static function evaluateCondition(array $condition, string $variable, mixed $object): bool
+    {
+        switch ($condition['type']) {
+            case 'and':
+                return self::evaluateCondition($condition['left'], $variable, $object) &&
+                       self::evaluateCondition($condition['right'], $variable, $object);
+
+            case 'or':
+                if (self::evaluateCondition($condition['left'], $variable, $object)) {
+                    return true;
+                }
+
+                return self::evaluateCondition($condition['right'], $variable, $object);
+
+            case 'comparison':
+                $leftValue = self::resolveValue($condition['left'], $variable, $object);
+                $rightValue = self::resolveValue($condition['right'], $variable, $object);
+
+                return match ($condition['operator']) {
+                    '==' => $leftValue === $rightValue,
+                    '!=' => $leftValue !== $rightValue,
+                    '>' => $leftValue > $rightValue,
+                    '<' => $leftValue < $rightValue,
+                    '>=' => $leftValue >= $rightValue,
+                    '<=' => $leftValue <= $rightValue,
+                    default => false,
+                };
+
+            case 'simple':
+                $value = self::resolveValue($condition['expression'], $variable, $object);
+
+                return (bool) $value;
+
+            default:
+                return false;
+        }
+    }
+
+    /**
+     * Resolve a value from an expression, variable, or literal
+     */
+    public static function resolveValue(string $expression, string $variable, mixed $object): mixed
+    {
+        $expression = mb_trim($expression);
+
+        // If it's the variable name, return the object
+        if ($expression === $variable) {
+            return $object;
+        }
+
+        // If it's a property access (e.g., "n.age"), resolve it
+        if (str_starts_with($expression, $variable.'.')) {
+            $property = mb_substr($expression, mb_strlen($variable) + 1);
+            if (is_array($object) && array_key_exists($property, $object)) {
+                return $object[$property];
+            }
+            if (is_object($object) && property_exists($object, $property)) {
+                return $object->$property;
+            }
+
+            return null;
+        }
+
+        // Try to parse as a number
+        if (is_numeric($expression)) {
+            return str_contains($expression, '.') ? (float) $expression : (int) $expression;
+        }
+
+        // Try to parse as boolean
+        if (in_array(mb_strtolower($expression), ['true', 'false'])) {
+            return mb_strtolower($expression) === 'true';
+        }
+
+        // Try to parse as null
+        if (mb_strtolower($expression) === 'null') {
+            return null;
+        }
+
+        // Return as string (remove quotes if present)
+        if ((str_starts_with($expression, '"') && str_ends_with($expression, '"')) ||
+            (str_starts_with($expression, "'") && str_ends_with($expression, "'"))) {
+            return mb_substr($expression, 1, -1);
+        }
+
+        return $expression;
+    }
+
+    /**
+     * Convert strftime format string to PHP date format string
+     *
+     * @param  string  $strftimeFormat  The strftime format string
+     * @return string The PHP date format string
+     */
+    public static function strftimeToPhpFormat(string $strftimeFormat): string
+    {
+        $conversions = [
+            // Special Ruby format cases
+            '%N' => 'u',        // Microseconds (Ruby) -> microseconds (PHP)
+            '%u' => 'u',        // Microseconds (Ruby) -> microseconds (PHP)
+            '%-m' => 'n',       // Month without leading zero (Ruby) -> month without leading zero (PHP)
+            '%-d' => 'j',       // Day without leading zero (Ruby) -> day without leading zero (PHP)
+            '%-H' => 'G',       // Hour without leading zero (Ruby) -> hour without leading zero (PHP)
+            '%-I' => 'g',       // Hour 12h without leading zero (Ruby) -> hour 12h without leading zero (PHP)
+            '%-M' => 'i',       // Minute without leading zero (Ruby) -> minute without leading zero (PHP)
+            '%-S' => 's',       // Second without leading zero (Ruby) -> second without leading zero (PHP)
+            '%z' => 'O',        // Timezone offset (Ruby) -> timezone offset (PHP)
+            '%Z' => 'T',        // Timezone name (Ruby) -> timezone name (PHP)
+
+            // Standard strftime conversions
+            '%A' => 'l',     // Full weekday name
+            '%a' => 'D',     // Abbreviated weekday name
+            '%B' => 'F',     // Full month name
+            '%b' => 'M',     // Abbreviated month name
+            '%Y' => 'Y',     // Full year (4 digits)
+            '%y' => 'y',     // Year without century (2 digits)
+            '%m' => 'm',     // Month as decimal number (01-12)
+            '%d' => 'd',     // Day of month as decimal number (01-31)
+            '%H' => 'H',     // Hour in 24-hour format (00-23)
+            '%I' => 'h',     // Hour in 12-hour format (01-12)
+            '%M' => 'i',     // Minute as decimal number (00-59)
+            '%S' => 's',     // Second as decimal number (00-59)
+            '%p' => 'A',     // AM/PM
+            '%P' => 'a',     // am/pm
+            '%j' => 'z',     // Day of year as decimal number (001-366)
+            '%w' => 'w',     // Weekday as decimal number (0-6, Sunday is 0)
+            '%U' => 'W',     // Week number of year (00-53, Sunday is first day)
+            '%W' => 'W',     // Week number of year (00-53, Monday is first day)
+            '%c' => 'D M j H:i:s Y', // Date and time representation
+            '%x' => 'm/d/Y', // Date representation
+            '%X' => 'H:i:s', // Time representation
+        ];
+
+        return str_replace(array_keys($conversions), array_values($conversions), $strftimeFormat);
+    }
+}

app/Livewire/Actions/DeviceAutoJoin.php

@@ -10,14 +10,14 @@ class DeviceAutoJoin extends Component
 
     public bool $isFirstUser = false;
 
-    public function mount()
+    public function mount(): void
     {
         $this->deviceAutojoin = auth()->user()->assign_new_devices;
         $this->isFirstUser = auth()->user()->id === 1;
 
     }
 
-    public function updating($name, $value)
+    public function updating($name, $value): void
     {
         $this->validate([
             'deviceAutojoin' => 'boolean',
@@ -30,7 +30,7 @@ class DeviceAutoJoin extends Component
         }
     }
 
-    public function render()
+    public function render(): \Illuminate\Contracts\View\View|\Illuminate\Contracts\View\Factory
     {
         return view('livewire.actions.device-auto-join');
     }

app/Livewire/Actions/Logout.php

@@ -10,7 +10,7 @@ class Logout
     /**
      * Log the current user out of the application.
      */
-    public function __invoke()
+    public function __invoke(): \Illuminate\Routing\Redirector|\Illuminate\Http\RedirectResponse
     {
         Auth::guard('web')->logout();
 

app/Livewire/DeviceDashboard.php

@@ -6,7 +6,7 @@ use Livewire\Component;
 
 class DeviceDashboard extends Component
 {
-    public function render()
+    public function render(): \Illuminate\Contracts\View\View|\Illuminate\Contracts\View\Factory
     {
         return view('livewire.device-dashboard', ['devices' => auth()->user()->devices()->paginate(10)]);
     }

app/Models/Device.php

@@ -2,18 +2,32 @@
 
 namespace App\Models;
 
+use Carbon\Carbon;
+use DateTimeInterface;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 use Illuminate\Support\Facades\Storage;
 
+/**
+ * @property-read DeviceModel|null $deviceModel
+ * @property-read DevicePalette|null $palette
+ */
 class Device extends Model
 {
     use HasFactory;
 
     protected $guarded = ['id'];
 
+    /**
+     * Set the MAC address attribute, normalizing to uppercase.
+     */
+    public function setMacAddressAttribute(?string $value): void
+    {
+        $this->attributes['mac_address'] = $value ? mb_strtoupper($value) : null;
+    }
+
     protected $casts = [
         'battery_notification_sent' => 'boolean',
         'proxy_cloud' => 'boolean',
@@ -23,9 +37,14 @@ class Device extends Model
         'height' => 'integer',
         'rotate' => 'integer',
         'last_refreshed_at' => 'datetime',
+        'sleep_mode_enabled' => 'boolean',
+        'sleep_mode_from' => 'datetime:H:i',
+        'sleep_mode_to' => 'datetime:H:i',
+        'special_function' => 'string',
+        'pause_until' => 'datetime',
     ];
 
-    public function getBatteryPercentAttribute()
+    public function getBatteryPercentAttribute(): int|float
     {
         $volts = $this->last_battery_voltage;
 
@@ -73,7 +92,7 @@ class Device extends Model
         return round($voltage, 2);
     }
 
-    public function getWifiStrengthAttribute()
+    public function getWifiStrengthAttribute(): int
     {
         $rssi = $this->last_rssi_level;
         if ($rssi >= 0) {
@@ -96,11 +115,7 @@ class Device extends Model
             return true;
         }
 
-        if ($this->proxy_cloud_response && $this->proxy_cloud_response['update_firmware']) {
-            return true;
-        }
-
-        return false;
+        return $this->proxy_cloud_response && $this->proxy_cloud_response['update_firmware'];
     }
 
     public function getFirmwareUrlAttribute(): ?string
@@ -176,6 +191,40 @@ class Device extends Model
         return $this->belongsTo(Firmware::class, 'update_firmware_id');
     }
 
+    public function deviceModel(): BelongsTo
+    {
+        return $this->belongsTo(DeviceModel::class);
+    }
+
+    public function palette(): BelongsTo
+    {
+        return $this->belongsTo(DevicePalette::class, 'palette_id');
+    }
+
+    /**
+     * Get the color depth string (e.g., "4bit") for the associated device model.
+     */
+    public function colorDepth(): ?string
+    {
+        return $this->deviceModel?->color_depth;
+    }
+
+    /**
+     * Get the scale level (e.g., large/xlarge/xxlarge) for the associated device model.
+     */
+    public function scaleLevel(): ?string
+    {
+        return $this->deviceModel?->scale_level;
+    }
+
+    /**
+     * Get the device variant name, defaulting to 'og' if not available.
+     */
+    public function deviceVariant(): string
+    {
+        return $this->deviceModel->name ?? 'og';
+    }
+
     public function logs(): HasMany
     {
         return $this->hasMany(DeviceLog::class);
@@ -185,4 +234,53 @@ class Device extends Model
     {
         return $this->belongsTo(User::class);
     }
+
+    public function isSleepModeActive(?DateTimeInterface $now = null): bool
+    {
+        if (! $this->sleep_mode_enabled || ! $this->sleep_mode_from || ! $this->sleep_mode_to) {
+            return false;
+        }
+
+        $now = $now instanceof DateTimeInterface ? Carbon::instance($now) : now();
+
+        // Handle overnight ranges (e.g. 22:00 to 06:00)
+        return $this->sleep_mode_from < $this->sleep_mode_to
+            ? $now->between($this->sleep_mode_from, $this->sleep_mode_to)
+            : ($now->gte($this->sleep_mode_from) || $now->lte($this->sleep_mode_to));
+    }
+
+    public function getSleepModeEndsInSeconds(?DateTimeInterface $now = null): ?int
+    {
+        if (! $this->sleep_mode_enabled || ! $this->sleep_mode_from || ! $this->sleep_mode_to) {
+            return null;
+        }
+
+        $now = $now instanceof DateTimeInterface ? Carbon::instance($now) : now();
+        $from = $this->sleep_mode_from;
+        $to = $this->sleep_mode_to;
+
+        // Handle overnight ranges (e.g. 22:00 to 06:00)
+        if ($from < $to) {
+            // Normal range, same day
+            return $now->between($from, $to) ? (int) $now->diffInSeconds($to, false) : null;
+        }
+        // Overnight range
+        if ($now->gte($from)) {
+            // After 'from', before midnight
+            return (int) $now->diffInSeconds($to->copy()->addDay(), false);
+        }
+        if ($now->lt($to)) {
+            // After midnight, before 'to'
+            return (int) $now->diffInSeconds($to, false);
+        }
+
+        // Not in sleep window
+        return null;
+
+    }
+
+    public function isPauseActive(): bool
+    {
+        return $this->pause_until && $this->pause_until->isFuture();
+    }
 }

app/Models/DeviceModel.php

@@ -0,0 +1,78 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+/**
+ * @property-read DevicePalette|null $palette
+ */
+final class DeviceModel extends Model
+{
+    use HasFactory;
+
+    protected $guarded = ['id'];
+
+    protected $casts = [
+        'width' => 'integer',
+        'height' => 'integer',
+        'colors' => 'integer',
+        'bit_depth' => 'integer',
+        'scale_factor' => 'float',
+        'rotation' => 'integer',
+        'offset_x' => 'integer',
+        'offset_y' => 'integer',
+        'published_at' => 'datetime',
+    ];
+
+    public function getColorDepthAttribute(): ?string
+    {
+        if (! $this->bit_depth) {
+            return null;
+        }
+
+        if ($this->bit_depth === 3) {
+            return '2bit';
+        }
+
+        // if higher than 4 return 4bit
+        if ($this->bit_depth > 4) {
+            return '4bit';
+        }
+
+        return $this->bit_depth.'bit';
+    }
+
+    /**
+     * Returns the scale level based on the device width.
+     */
+    public function getScaleLevelAttribute(): ?string
+    {
+        if (! $this->width) {
+            return null;
+        }
+
+        if ($this->width > 800 && $this->width <= 1000) {
+            return 'large';
+        }
+
+        if ($this->width > 1000 && $this->width <= 1400) {
+            return 'xlarge';
+        }
+
+        if ($this->width > 1400) {
+            return 'xxlarge';
+        }
+
+        return null;
+    }
+
+    public function palette(): BelongsTo
+    {
+        return $this->belongsTo(DevicePalette::class, 'palette_id');
+    }
+}

app/Models/DevicePalette.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+
+/**
+ * @property array|null $colors
+ */
+final class DevicePalette extends Model
+{
+    use HasFactory;
+
+    protected $guarded = [];
+
+    protected $casts = [
+        'grays' => 'integer',
+        'colors' => 'array',
+    ];
+}

app/Models/Playlist.php

@@ -37,17 +37,36 @@ class Playlist extends Model
             return false;
         }
 
-        // Check weekday
-        if ($this->weekdays !== null) {
-            if (! in_array(now()->dayOfWeek, $this->weekdays)) {
-                return false;
-            }
+        // Get user's timezone or fall back to app timezone
+        $timezone = $this->device->user->timezone ?? config('app.timezone');
+        $now = now($timezone);
+
+        // Check weekday (using timezone-aware time)
+        if ($this->weekdays !== null && ! in_array($now->dayOfWeek, $this->weekdays)) {
+            return false;
         }
-        // Check time range
+
         if ($this->active_from !== null && $this->active_until !== null) {
-            if (! now()->between($this->active_from, $this->active_until)) {
-                return false;
+            // Create timezone-aware datetime objects for active_from and active_until
+            $activeFrom = $now->copy()
+                ->setTimeFrom($this->active_from)
+                ->timezone($timezone);
+
+            $activeUntil = $now->copy()
+                ->setTimeFrom($this->active_until)
+                ->timezone($timezone);
+
+            // Handle time ranges that span across midnight
+            if ($activeFrom > $activeUntil) {
+                // Time range spans midnight (e.g., 09:01 to 03:58)
+                if ($now >= $activeFrom || $now <= $activeUntil) {
+                    return true;
+                }
+            } elseif ($now >= $activeFrom && $now <= $activeUntil) {
+                return true;
             }
+
+            return false;
         }
 
         return true;

app/Models/PlaylistItem.php

@@ -135,10 +135,13 @@ class PlaylistItem extends Model
     /**
      * Render all plugins with appropriate layout
      */
-    public function render(): string
+    public function render(?Device $device = null): string
     {
         if (! $this->isMashup()) {
             return view('trmnl-layouts.single', [
+                'colorDepth' => $device?->colorDepth(),
+                'deviceVariant' => $device?->deviceVariant() ?? 'og',
+                'scaleLevel' => $device?->scaleLevel(),
                 'slot' => $this->plugin instanceof Plugin
                     ? $this->plugin->render('full', false)
                     : throw new Exception('Invalid plugin instance'),
@@ -150,9 +153,7 @@ class PlaylistItem extends Model
         $plugins = Plugin::whereIn('id', $pluginIds)->get();
 
         // Sort the collection to match plugin_ids order
-        $plugins = $plugins->sortBy(function ($plugin) use ($pluginIds) {
-            return array_search($plugin->id, $pluginIds);
-        })->values();
+        $plugins = $plugins->sortBy(fn ($plugin): int|string|false => array_search($plugin->id, $pluginIds))->values();
 
         foreach ($plugins as $index => $plugin) {
             $size = $this->getLayoutSize($index);
@@ -160,6 +161,9 @@ class PlaylistItem extends Model
         }
 
         return view('trmnl-layouts.mashup', [
+            'colorDepth' => $device?->colorDepth(),
+            'deviceVariant' => $device?->deviceVariant() ?? 'og',
+            'scaleLevel' => $device?->scaleLevel(),
             'mashupLayout' => $this->getMashupLayoutType(),
             'slot' => implode('', $pluginMarkups),
         ])->render();

app/Models/Plugin.php

@@ -2,14 +2,32 @@
 
 namespace App\Models;
 
+use App\Liquid\FileSystems\InlineTemplatesFileSystem;
+use App\Liquid\Filters\Data;
+use App\Liquid\Filters\Date;
+use App\Liquid\Filters\Localization;
+use App\Liquid\Filters\Numbers;
+use App\Liquid\Filters\StandardFilters;
+use App\Liquid\Filters\StringMarkup;
+use App\Liquid\Filters\Uniqueness;
+use App\Liquid\Tags\TemplateTag;
+use App\Services\Plugin\Parsers\ResponseParserRegistry;
+use App\Services\PluginImportService;
+use Carbon\Carbon;
+use Exception;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
+use Illuminate\Http\Client\Response;
+use Illuminate\Support\Facades\App;
 use Illuminate\Support\Facades\Blade;
 use Illuminate\Support\Facades\Http;
+use Illuminate\Support\Facades\Log;
+use Illuminate\Support\Facades\Process;
 use Illuminate\Support\Str;
-use Keepsuit\LaravelLiquid\Facades\Liquid;
-use Illuminate\Support\Facades\App;
+use InvalidArgumentException;
+use Keepsuit\LaravelLiquid\LaravelLiquidExtension;
 use Keepsuit\Liquid\Exceptions\LiquidException;
+use Keepsuit\Liquid\Extensions\StandardExtension;
 
 class Plugin extends Model
 {
@@ -22,21 +40,111 @@ class Plugin extends Model
         'data_payload_updated_at' => 'datetime',
         'is_native' => 'boolean',
         'markup_language' => 'string',
+        'configuration' => 'json',
+        'configuration_template' => 'json',
+        'no_bleed' => 'boolean',
+        'dark_mode' => 'boolean',
+        'preferred_renderer' => 'string',
+        'plugin_type' => 'string',
+        'alias' => 'boolean',
     ];
 
     protected static function boot()
     {
         parent::boot();
 
-        static::creating(function ($model) {
+        static::creating(function ($model): void {
             if (empty($model->uuid)) {
                 $model->uuid = Str::uuid();
             }
         });
+
+        static::updating(function ($model): void {
+            // Reset image cache when markup changes
+            if ($model->isDirty('render_markup')) {
+                $model->current_image = null;
+            }
+        });
+
+        // Sanitize configuration template on save
+        static::saving(function ($model): void {
+            $model->sanitizeTemplate();
+        });
+    }
+
+    public function user()
+    {
+        return $this->belongsTo(User::class);
+    }
+
+    // sanitize configuration template descriptions and help texts (since they allow HTML rendering)
+    protected function sanitizeTemplate(): void
+    {
+        $template = $this->configuration_template;
+
+        if (isset($template['custom_fields']) && is_array($template['custom_fields'])) {
+            foreach ($template['custom_fields'] as &$field) {
+                if (isset($field['description'])) {
+                    $field['description'] = \Stevebauman\Purify\Facades\Purify::clean($field['description']);
+                }
+                if (isset($field['help_text'])) {
+                    $field['help_text'] = \Stevebauman\Purify\Facades\Purify::clean($field['help_text']);
+                }
+            }
+
+            $this->configuration_template = $template;
+        }
+    }
+
+    public function hasMissingRequiredConfigurationFields(): bool
+    {
+        if (! isset($this->configuration_template['custom_fields']) || empty($this->configuration_template['custom_fields'])) {
+            return false;
+        }
+
+        foreach ($this->configuration_template['custom_fields'] as $field) {
+            // Skip fields as they are informational only
+            if ($field['field_type'] === 'author_bio') {
+                continue;
+            }
+
+            if ($field['field_type'] === 'copyable') {
+                continue;
+            }
+
+            if ($field['field_type'] === 'copyable_webhook_url') {
+                continue;
+            }
+
+            $fieldKey = $field['keyname'] ?? $field['key'] ?? $field['name'];
+
+            // Check if field is required (not marked as optional)
+            $isRequired = ! isset($field['optional']) || $field['optional'] !== true;
+
+            if ($isRequired) {
+                $currentValue = $this->configuration[$fieldKey] ?? null;
+
+                // If the field has a default value and no current value is set, it's not missing
+                if ((in_array($currentValue, [null, '', []], true)) && ! isset($field['default'])) {
+                    return true; // Found a required field that is not set and has no default
+                }
+            }
+        }
+
+        return false; // All required fields are set
     }
 
     public function isDataStale(): bool
     {
+        // Image webhook plugins don't use data staleness - images are pushed directly
+        if ($this->plugin_type === 'image_webhook') {
+            return false;
+        }
+
+        if ($this->data_strategy === 'webhook') {
+            // Treat as stale if any webhook event has occurred in the past hour
+            return $this->data_payload_updated_at && $this->data_payload_updated_at->gt(now()->subHour());
+        }
         if (! $this->data_payload_updated_at || ! $this->data_stale_minutes) {
             return true;
         }
@@ -46,62 +154,373 @@ class Plugin extends Model
 
     public function updateDataPayload(): void
     {
-        if ($this->data_strategy === 'polling' && $this->polling_url) {
+        if ($this->data_strategy !== 'polling' || ! $this->polling_url) {
+            return;
+        }
+        $headers = ['User-Agent' => 'usetrmnl/byos_laravel', 'Accept' => 'application/json'];
 
-            $headers = ['User-Agent' => 'usetrmnl/byos_laravel', 'Accept' => 'application/json'];
-
-            if ($this->polling_header) {
-                $headerLines = explode("\n", trim($this->polling_header));
-                foreach ($headerLines as $line) {
-                    $parts = explode(':', $line, 2);
-                    if (count($parts) === 2) {
-                        $headers[trim($parts[0])] = trim($parts[1]);
-                    }
+        // resolve headers
+        if ($this->polling_header) {
+            $resolvedHeader = $this->resolveLiquidVariables($this->polling_header);
+            $headerLines = explode("\n", mb_trim($resolvedHeader));
+            foreach ($headerLines as $line) {
+                $parts = explode(':', $line, 2);
+                if (count($parts) === 2) {
+                    $headers[mb_trim($parts[0])] = mb_trim($parts[1]);
                 }
             }
+        }
 
+        // resolve and clean URLs
+        $resolvedPollingUrls = $this->resolveLiquidVariables($this->polling_url);
+        $urls = array_values(array_filter( // array_values ensures 0, 1, 2...
+            array_map('trim', explode("\n", $resolvedPollingUrls)),
+            fn ($url): bool => filled($url)
+        ));
+
+        $combinedResponse = [];
+
+        // Loop through all URLs (Handles 1 or many)
+        foreach ($urls as $index => $url) {
             $httpRequest = Http::withHeaders($headers);
 
             if ($this->polling_verb === 'post' && $this->polling_body) {
-                $httpRequest = $httpRequest->withBody($this->polling_body);
+                $resolvedBody = $this->resolveLiquidVariables($this->polling_body);
+                $httpRequest = $httpRequest->withBody($resolvedBody);
             }
 
-            // Make the request based on the verb
-            if ($this->polling_verb === 'post') {
-                $response = $httpRequest->post($this->polling_url)->json();
-            } else {
-                $response = $httpRequest->get($this->polling_url)->json();
-            }
+            try {
+                $httpResponse = ($this->polling_verb === 'post')
+                    ? $httpRequest->post($url)
+                    : $httpRequest->get($url);
 
-            $this->update([
-                'data_payload' => $response,
-                'data_payload_updated_at' => now(),
-            ]);
+                $response = $this->parseResponse($httpResponse);
+
+                // Nest if it's a sequential array
+                if (array_keys($response) === range(0, count($response) - 1)) {
+                    $combinedResponse["IDX_{$index}"] = ['data' => $response];
+                } else {
+                    $combinedResponse["IDX_{$index}"] = $response;
+                }
+            } catch (Exception $e) {
+                Log::warning("Failed to fetch data from URL {$url}: ".$e->getMessage());
+                $combinedResponse["IDX_{$index}"] = ['error' => 'Failed to fetch data'];
+            }
         }
+
+        // unwrap IDX_0 if only one URL
+        $finalPayload = (count($urls) === 1) ? reset($combinedResponse) : $combinedResponse;
+
+        $this->update([
+            'data_payload' => $finalPayload,
+            'data_payload_updated_at' => now(),
+        ]);
+    }
+
+    private function parseResponse(Response $httpResponse): array
+    {
+        $parsers = app(ResponseParserRegistry::class)->getParsers();
+
+        foreach ($parsers as $parser) {
+            $parserName = class_basename($parser);
+
+            try {
+                $result = $parser->parse($httpResponse);
+
+                if ($result !== null) {
+                    return $result;
+                }
+            } catch (Exception $e) {
+                Log::warning("Failed to parse {$parserName} response: ".$e->getMessage());
+            }
+        }
+
+        return ['error' => 'Failed to parse response'];
+    }
+
+    /**
+     * Apply Liquid template replacements (converts 'with' syntax to comma syntax)
+     */
+    private function applyLiquidReplacements(string $template): string
+    {
+
+        $replacements = [];
+
+        // Apply basic replacements
+        $template = str_replace(array_keys($replacements), array_values($replacements), $template);
+
+        // Convert Ruby/strftime date formats to PHP date formats
+        $template = $this->convertDateFormats($template);
+
+        // Convert {% render "template" with %} syntax to {% render "template", %} syntax
+        $template = preg_replace(
+            '/{%\s*render\s+([^}]+?)\s+with\s+/i',
+            '{% render $1, ',
+            $template
+        );
+
+        // Convert for loops with filters to use temporary variables
+        // This handles: {% for item in collection | filter: "key", "value" %}
+        // Converts to: {% assign temp_filtered = collection | filter: "key", "value" %}{% for item in temp_filtered %}
+        $template = preg_replace_callback(
+            '/{%\s*for\s+(\w+)\s+in\s+([^|%}]+)\s*\|\s*([^%}]+)%}/',
+            function (array $matches): string {
+                $variableName = mb_trim($matches[1]);
+                $collection = mb_trim($matches[2]);
+                $filter = mb_trim($matches[3]);
+                $tempVarName = '_temp_'.uniqid();
+
+                return "{% assign {$tempVarName} = {$collection} | {$filter} %}{% for {$variableName} in {$tempVarName} %}";
+            },
+            (string) $template
+        );
+
+        return $template;
+    }
+
+    /**
+     * Convert Ruby/strftime date formats to PHP date formats in Liquid templates
+     */
+    private function convertDateFormats(string $template): string
+    {
+        // Handle date filter formats: date: "format" or date: 'format'
+        $template = preg_replace_callback(
+            '/date:\s*(["\'])([^"\']+)\1/',
+            function (array $matches): string {
+                $quote = $matches[1];
+                $format = $matches[2];
+                $convertedFormat = \App\Liquid\Utils\ExpressionUtils::strftimeToPhpFormat($format);
+
+                return 'date: '.$quote.$convertedFormat.$quote;
+            },
+            $template
+        );
+
+        // Handle l_date filter formats: l_date: "format" or l_date: 'format'
+        $template = preg_replace_callback(
+            '/l_date:\s*(["\'])([^"\']+)\1/',
+            function (array $matches): string {
+                $quote = $matches[1];
+                $format = $matches[2];
+                $convertedFormat = \App\Liquid\Utils\ExpressionUtils::strftimeToPhpFormat($format);
+
+                return 'l_date: '.$quote.$convertedFormat.$quote;
+            },
+            (string) $template
+        );
+
+        return $template;
+    }
+
+    /**
+     * Check if a template contains a Liquid for loop pattern
+     *
+     * @param  string  $template  The template string to check
+     * @return bool True if the template contains a for loop pattern
+     */
+    private function containsLiquidForLoop(string $template): bool
+    {
+        return preg_match('/{%-?\s*for\s+/i', $template) === 1;
+    }
+
+    /**
+     * Resolve Liquid variables in a template string using the Liquid template engine
+     *
+     * Uses the external trmnl-liquid renderer when:
+     * - preferred_renderer is 'trmnl-liquid'
+     * - External renderer is enabled in config
+     * - Template contains a Liquid for loop pattern
+     *
+     * Otherwise uses the internal PHP-based Liquid renderer.
+     *
+     * @param  string  $template  The template string containing Liquid variables
+     * @return string The resolved template with variables replaced with their values
+     *
+     * @throws LiquidException
+     * @throws Exception
+     */
+    public function resolveLiquidVariables(string $template): string
+    {
+        // Get configuration variables - make them available at root level
+        $variables = $this->configuration ?? [];
+
+        // Check if external renderer should be used
+        $useExternalRenderer = $this->preferred_renderer === 'trmnl-liquid'
+            && config('services.trmnl.liquid_enabled')
+            && $this->containsLiquidForLoop($template);
+
+        if ($useExternalRenderer) {
+            // Use external Ruby liquid renderer
+            return $this->renderWithExternalLiquidRenderer($template, $variables);
+        }
+
+        // Use the Liquid template engine to resolve variables
+        $environment = App::make('liquid.environment');
+        $environment->filterRegistry->register(StandardFilters::class);
+        $liquidTemplate = $environment->parseString($template);
+        $context = $environment->newRenderContext(data: $variables);
+
+        return $liquidTemplate->render($context);
+    }
+
+    /**
+     * Render template using external Ruby liquid renderer
+     *
+     * @param  string  $template  The liquid template string
+     * @param  array  $context  The render context data
+     * @return string The rendered HTML
+     *
+     * @throws Exception
+     */
+    private function renderWithExternalLiquidRenderer(string $template, array $context): string
+    {
+        $liquidPath = config('services.trmnl.liquid_path');
+
+        if (empty($liquidPath)) {
+            throw new Exception('External liquid renderer path is not configured');
+        }
+
+        // HTML encode the template
+        $encodedTemplate = htmlspecialchars($template, ENT_QUOTES, 'UTF-8');
+
+        // Encode context as JSON
+        $jsonContext = json_encode($context, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
+
+        if ($jsonContext === false) {
+            throw new Exception('Failed to encode render context as JSON: '.json_last_error_msg());
+        }
+
+        // Validate argument sizes
+        app(PluginImportService::class)->validateExternalRendererArguments($encodedTemplate, $jsonContext, $liquidPath);
+
+        // Execute the external renderer
+        $process = Process::run([
+            $liquidPath,
+            '--template',
+            $encodedTemplate,
+            '--context',
+            $jsonContext,
+        ]);
+
+        if (! $process->successful()) {
+            $errorOutput = $process->errorOutput() ?: $process->output();
+            throw new Exception('External liquid renderer failed: '.$errorOutput);
+        }
+
+        return $process->output();
     }
 
     /**
      * Render the plugin's markup
+     *
      * @throws LiquidException
      */
-    public function render(string $size = 'full', bool $standalone = true): string
+    public function render(string $size = 'full', bool $standalone = true, ?Device $device = null): string
     {
+        if ($this->plugin_type !== 'recipe') {
+            throw new InvalidArgumentException('Render method is only applicable for recipe plugins.');
+        }
+
         if ($this->render_markup) {
             $renderedContent = '';
 
             if ($this->markup_language === 'liquid') {
-                $environment = App::make('liquid.environment');
-                $template = $environment->parseString($this->render_markup);
-                $context = $environment->newRenderContext(data: ['size' => $size, 'data' => $this->data_payload]);
-                $renderedContent = $template->render($context);
+                // Get timezone from user or fall back to app timezone
+                $timezone = $this->user->timezone ?? config('app.timezone');
+
+                // Calculate UTC offset in seconds
+                $utcOffset = (string) Carbon::now($timezone)->getOffset();
+
+                // Build render context
+                $context = [
+                    'size' => $size,
+                    'data' => $this->data_payload,
+                    'config' => $this->configuration ?? [],
+                    ...(is_array($this->data_payload) ? $this->data_payload : []),
+                    'trmnl' => [
+                        'system' => [
+                            'timestamp_utc' => now()->utc()->timestamp,
+                        ],
+                        'user' => [
+                            'utc_offset' => $utcOffset,
+                            'name' => $this->user->name ?? 'Unknown User',
+                            'locale' => 'en',
+                            'time_zone_iana' => $timezone,
+                        ],
+                        'plugin_settings' => [
+                            'instance_name' => $this->name,
+                            'strategy' => $this->data_strategy,
+                            'dark_mode' => $this->dark_mode ? 'yes' : 'no',
+                            'no_screen_padding' => $this->no_bleed ? 'yes' : 'no',
+                            'polling_headers' => $this->polling_header,
+                            'polling_url' => $this->polling_url,
+                            'custom_fields_values' => [
+                                ...(is_array($this->configuration) ? $this->configuration : []),
+                            ],
+                        ],
+                    ],
+                ];
+
+                // Check if external renderer should be used
+                if ($this->preferred_renderer === 'trmnl-liquid' && config('services.trmnl.liquid_enabled')) {
+                    // Use external Ruby renderer - pass raw template without preprocessing
+                    $renderedContent = $this->renderWithExternalLiquidRenderer($this->render_markup, $context);
+                } else {
+                    // Use PHP keepsuit/liquid renderer
+                    // Create a custom environment with inline templates support
+                    $inlineFileSystem = new InlineTemplatesFileSystem();
+                    $environment = new \Keepsuit\Liquid\Environment(
+                        fileSystem: $inlineFileSystem,
+                        extensions: [new StandardExtension(), new LaravelLiquidExtension()]
+                    );
+
+                    // Register all custom filters
+                    $environment->filterRegistry->register(Data::class);
+                    $environment->filterRegistry->register(Date::class);
+                    $environment->filterRegistry->register(Localization::class);
+                    $environment->filterRegistry->register(Numbers::class);
+                    $environment->filterRegistry->register(StringMarkup::class);
+                    $environment->filterRegistry->register(Uniqueness::class);
+
+                    // Register the template tag for inline templates
+                    $environment->tagRegistry->register(TemplateTag::class);
+
+                    // Apply Liquid replacements (including 'with' syntax conversion)
+                    $processedMarkup = $this->applyLiquidReplacements($this->render_markup);
+
+                    $template = $environment->parseString($processedMarkup);
+                    $liquidContext = $environment->newRenderContext(data: $context);
+                    $renderedContent = $template->render($liquidContext);
+                }
             } else {
-                $renderedContent = Blade::render($this->render_markup, ['size' => $size, 'data' => $this->data_payload]);
+                $renderedContent = Blade::render($this->render_markup, [
+                    'size' => $size,
+                    'data' => $this->data_payload,
+                    'config' => $this->configuration ?? [],
+                ]);
             }
 
             if ($standalone) {
-                return view('trmnl-layouts.single', [
+                if ($size === 'full') {
+                    return view('trmnl-layouts.single', [
+                        'colorDepth' => $device?->colorDepth(),
+                        'deviceVariant' => $device?->deviceVariant() ?? 'og',
+                        'noBleed' => $this->no_bleed,
+                        'darkMode' => $this->dark_mode,
+                        'scaleLevel' => $device?->scaleLevel(),
+                        'slot' => $renderedContent,
+                    ])->render();
+                }
+
+                return view('trmnl-layouts.mashup', [
+                    'mashupLayout' => $this->getPreviewMashupLayoutForSize($size),
+                    'colorDepth' => $device?->colorDepth(),
+                    'deviceVariant' => $device?->deviceVariant() ?? 'og',
+                    'darkMode' => $this->dark_mode,
+                    'scaleLevel' => $device?->scaleLevel(),
                     'slot' => $renderedContent,
                 ])->render();
+
             }
 
             return $renderedContent;
@@ -109,21 +528,115 @@ class Plugin extends Model
 
         if ($this->render_markup_view) {
             if ($standalone) {
-                return view('trmnl-layouts.single', [
-                    'slot' => view($this->render_markup_view, [
-                        'size' => $size,
-                        'data' => $this->data_payload,
-                    ])->render(),
+                $renderedView = view($this->render_markup_view, [
+                    'size' => $size,
+                    'data' => $this->data_payload,
+                    'config' => $this->configuration ?? [],
+                ])->render();
+
+                if ($size === 'full') {
+                    return view('trmnl-layouts.single', [
+                        'colorDepth' => $device?->colorDepth(),
+                        'deviceVariant' => $device?->deviceVariant() ?? 'og',
+                        'noBleed' => $this->no_bleed,
+                        'darkMode' => $this->dark_mode,
+                        'scaleLevel' => $device?->scaleLevel(),
+                        'slot' => $renderedView,
+                    ])->render();
+                }
+
+                return view('trmnl-layouts.mashup', [
+                    'mashupLayout' => $this->getPreviewMashupLayoutForSize($size),
+                    'colorDepth' => $device?->colorDepth(),
+                    'deviceVariant' => $device?->deviceVariant() ?? 'og',
+                    'darkMode' => $this->dark_mode,
+                    'scaleLevel' => $device?->scaleLevel(),
+                    'slot' => $renderedView,
                 ])->render();
             }
 
             return view($this->render_markup_view, [
                 'size' => $size,
                 'data' => $this->data_payload,
+                'config' => $this->configuration ?? [],
             ])->render();
 
         }
 
         return '<p>No render markup yet defined for this plugin.</p>';
     }
+
+    /**
+     * Get a configuration value by key
+     */
+    public function getConfiguration(string $key, $default = null)
+    {
+        return $this->configuration[$key] ?? $default;
+    }
+
+    public function getPreviewMashupLayoutForSize(string $size): string
+    {
+        return match ($size) {
+            'half_vertical' => '1Lx1R',
+            'quadrant' => '2x2',
+            default => '1Tx1B',
+        };
+    }
+
+    /**
+     * Duplicate the plugin, copying all attributes and handling render_markup_view
+     *
+     * @param  int|null  $userId  Optional user ID for the duplicate. If not provided, uses the original plugin's user_id.
+     * @return Plugin The newly created duplicate plugin
+     */
+    public function duplicate(?int $userId = null): self
+    {
+        // Get all attributes except id and uuid
+        // Use toArray() to get cast values (respects JSON casts)
+        $attributes = $this->toArray();
+        unset($attributes['id'], $attributes['uuid']);
+
+        // Handle render_markup_view - copy file content to render_markup
+        if ($this->render_markup_view) {
+            try {
+                $basePath = resource_path('views/'.str_replace('.', '/', $this->render_markup_view));
+                $paths = [
+                    $basePath.'.blade.php',
+                    $basePath.'.liquid',
+                ];
+
+                $fileContent = null;
+                $markupLanguage = null;
+                foreach ($paths as $path) {
+                    if (file_exists($path)) {
+                        $fileContent = file_get_contents($path);
+                        // Determine markup language based on file extension
+                        $markupLanguage = str_ends_with($path, '.liquid') ? 'liquid' : 'blade';
+                        break;
+                    }
+                }
+
+                if ($fileContent !== null) {
+                    $attributes['render_markup'] = $fileContent;
+                    $attributes['markup_language'] = $markupLanguage;
+                    $attributes['render_markup_view'] = null;
+                } else {
+                    // File doesn't exist, remove the view reference
+                    $attributes['render_markup_view'] = null;
+                }
+            } catch (Exception $e) {
+                // If file reading fails, remove the view reference
+                $attributes['render_markup_view'] = null;
+            }
+        }
+
+        // Append " (Copy)" to the name
+        $attributes['name'] = $this->name.' (Copy)';
+
+        // Set user_id - use provided userId or fall back to original plugin's user_id
+        $attributes['user_id'] = $userId ?? $this->user_id;
+
+        // Create and return the new plugin
+        return self::create($attributes);
+    }
 }

app/Models/User.php

@@ -26,6 +26,8 @@ class User extends Authenticatable // implements MustVerifyEmail
         'password',
         'assign_new_devices',
         'assign_new_device_id',
+        'oidc_sub',
+        'timezone',
     ];
 
     /**

app/Notifications/BatteryLow.php

@@ -13,15 +13,10 @@ class BatteryLow extends Notification
 {
     use Queueable;
 
-    private Device $device;
-
     /**
      * Create a new notification instance.
      */
-    public function __construct(Device $device)
-    {
-        $this->device = $device;
-    }
+    public function __construct(private Device $device) {}
 
     /**
      * Get the notification's delivery channels.
@@ -41,7 +36,7 @@ class BatteryLow extends Notification
         return (new MailMessage)->markdown('mail.battery-low', ['device' => $this->device]);
     }
 
-    public function toWebhook(object $notifiable)
+    public function toWebhook(object $notifiable): WebhookMessage
     {
         return WebhookMessage::create()
             ->data([

app/Notifications/Channels/WebhookChannel.php

@@ -9,15 +9,9 @@ use GuzzleHttp\Psr7\Response;
 use Illuminate\Notifications\Notification;
 use Illuminate\Support\Arr;
 
-class WebhookChannel
+class WebhookChannel extends Notification
 {
-    /** @var Client */
-    protected $client;
-
-    public function __construct(Client $client)
-    {
-        $this->client = $client;
-    }
+    public function __construct(protected Client $client) {}
 
     /**
      * Send the given notification.

app/Notifications/Messages/WebhookMessage.php

@@ -2,7 +2,9 @@
 
 namespace App\Notifications\Messages;
 
-final class WebhookMessage
+use Illuminate\Notifications\Notification;
+
+final class WebhookMessage extends Notification
 {
     /**
      * The GET parameters of the request.
@@ -11,13 +13,6 @@ final class WebhookMessage
      */
     private $query;
 
-    /**
-     * The POST data of the Webhook request.
-     *
-     * @var mixed
-     */
-    private $data;
-
     /**
      * The headers to send with the request.
      *
@@ -34,9 +29,8 @@ final class WebhookMessage
 
     /**
      * @param  mixed  $data
-     * @return static
      */
-    public static function create($data = '')
+    public static function create($data = ''): self
     {
         return new self($data);
     }
@@ -44,10 +38,12 @@ final class WebhookMessage
     /**
      * @param  mixed  $data
      */
-    public function __construct($data = '')
-    {
-        $this->data = $data;
-    }
+    public function __construct(
+        /**
+         * The POST data of the Webhook request.
+         */
+        private $data = ''
+    ) {}
 
     /**
      * Set the Webhook parameters to be URL encoded.
@@ -55,7 +51,7 @@ final class WebhookMessage
      * @param  mixed  $query
      * @return $this
      */
-    public function query($query)
+    public function query($query): self
     {
         $this->query = $query;
 
@@ -68,7 +64,7 @@ final class WebhookMessage
      * @param  mixed  $data
      * @return $this
      */
-    public function data($data)
+    public function data($data): self
     {
         $this->data = $data;
 
@@ -82,7 +78,7 @@ final class WebhookMessage
      * @param  string  $value
      * @return $this
      */
-    public function header($name, $value)
+    public function header($name, $value): self
     {
         $this->headers[$name] = $value;
 
@@ -95,7 +91,7 @@ final class WebhookMessage
      * @param  string  $userAgent
      * @return $this
      */
-    public function userAgent($userAgent)
+    public function userAgent($userAgent): self
     {
         $this->headers['User-Agent'] = $userAgent;
 
@@ -107,17 +103,14 @@ final class WebhookMessage
      *
      * @return $this
      */
-    public function verify($value = true)
+    public function verify($value = true): self
     {
         $this->verify = $value;
 
         return $this;
     }
 
-    /**
-     * @return array
-     */
-    public function toArray()
+    public function toArray(): array
     {
         return [
             'query' => $this->query,

app/Providers/AppServiceProvider.php

@@ -2,8 +2,11 @@
 
 namespace App\Providers;
 
+use App\Services\OidcProvider;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\URL;
 use Illuminate\Support\ServiceProvider;
-use URL;
+use Laravel\Socialite\Facades\Socialite;
 
 class AppServiceProvider extends ServiceProvider
 {
@@ -23,5 +26,31 @@ class AppServiceProvider extends ServiceProvider
         if (app()->isProduction() && config('app.force_https')) {
             URL::forceScheme('https');
         }
+
+        Request::macro('hasValidSignature', function ($absolute = true, array $ignoreQuery = []) {
+            $https = clone $this;
+            $https->server->set('HTTPS', 'on');
+
+            $http = clone $this;
+            $http->server->set('HTTPS', 'off');
+            if (URL::hasValidSignature($https, $absolute, $ignoreQuery)) {
+                return true;
+            }
+
+            return URL::hasValidSignature($http, $absolute, $ignoreQuery);
+        });
+
+        // Register OIDC provider with Socialite
+        Socialite::extend('oidc', function (\Illuminate\Contracts\Foundation\Application $app): OidcProvider {
+            $config = $app->make('config')->get('services.oidc', []);
+
+            return new OidcProvider(
+                $app->make(Request::class),
+                $config['client_id'] ?? null,
+                $config['client_secret'] ?? null,
+                $config['redirect'] ?? null,
+                $config['scopes'] ?? ['openid', 'profile', 'email']
+            );
+        });
     }
 }

app/Services/ImageGenerationService.php

@@ -4,81 +4,35 @@ namespace App\Services;
 
 use App\Enums\ImageFormat;
 use App\Models\Device;
+use App\Models\DeviceModel;
 use App\Models\Plugin;
+use Bnussbau\TrmnlPipeline\Stages\BrowserStage;
+use Bnussbau\TrmnlPipeline\Stages\ImageStage;
+use Bnussbau\TrmnlPipeline\TrmnlPipeline;
 use Exception;
+use Illuminate\Support\Facades\Log;
 use Illuminate\Support\Facades\Storage;
-use Imagick;
-use ImagickException;
-use ImagickPixel;
-use Log;
+use InvalidArgumentException;
 use Ramsey\Uuid\Uuid;
 use RuntimeException;
-use Spatie\Browsershot\Browsershot;
 use Wnx\SidecarBrowsershot\BrowsershotLambda;
 
+use function config;
+use function file_exists;
+use function filesize;
+
 class ImageGenerationService
 {
     public static function generateImage(string $markup, $deviceId): string
     {
-        $device = Device::find($deviceId);
-        $uuid = Uuid::uuid4()->toString();
-        $pngPath = Storage::disk('public')->path('/images/generated/'.$uuid.'.png');
-        $bmpPath = Storage::disk('public')->path('/images/generated/'.$uuid.'.bmp');
-
-        // Generate PNG
-        if (config('app.puppeteer_mode') === 'sidecar-aws') {
-            try {
-                BrowsershotLambda::html($markup)
-                    ->windowSize(800, 480)
-                    ->save($pngPath);
-            } catch (Exception $e) {
-                Log::error('Failed to generate PNG: '.$e->getMessage());
-                throw new RuntimeException('Failed to generate PNG: '.$e->getMessage(), 0, $e);
-            }
-        } else {
-            try {
-                Browsershot::html($markup)
-                    ->setOption('args', config('app.puppeteer_docker') ? ['--no-sandbox', '--disable-setuid-sandbox', '--disable-gpu'] : [])
-                    ->windowSize(800, 480)
-                    ->save($pngPath);
-            } catch (Exception $e) {
-                Log::error('Failed to generate PNG: '.$e->getMessage());
-                throw new RuntimeException('Failed to generate PNG: '.$e->getMessage(), 0, $e);
-            }
-        }
-        switch ($device->image_format) {
-            case ImageFormat::BMP3_1BIT_SRGB->value:
-                try {
-                    self::convertToBmpImageMagick($pngPath, $bmpPath);
-                } catch (ImagickException $e) {
-                    throw new RuntimeException('Failed to convert image to BMP: '.$e->getMessage(), 0, $e);
-                }
-                break;
-            case ImageFormat::PNG_8BIT_GRAYSCALE->value:
-            case ImageFormat::PNG_8BIT_256C->value:
-                try {
-                    self::convertToPngImageMagick($pngPath, $device->width, $device->height, $device->rotate, quantize: $device->image_format === ImageFormat::PNG_8BIT_GRAYSCALE->value);
-                } catch (ImagickException $e) {
-                    throw new RuntimeException('Failed to convert image to PNG: '.$e->getMessage(), 0, $e);
-                }
-                break;
-            case ImageFormat::AUTO->value:
-            default:
-                if (isset($device->last_firmware_version)
-                    && version_compare($device->last_firmware_version, '1.5.2', '<')) {
-                    try {
-                        self::convertToBmpImageMagick($pngPath, $bmpPath);
-                    } catch (ImagickException $e) {
-                        throw new RuntimeException('Failed to convert image to BMP: '.$e->getMessage(), 0, $e);
-                    }
-                } else {
-                    try {
-                        self::convertToPngImageMagick($pngPath, $device->width, $device->height, $device->rotate);
-                    } catch (ImagickException $e) {
-                        throw new RuntimeException('Failed to convert image to PNG: '.$e->getMessage(), 0, $e);
-                    }
-                }
-        }
+        $device = Device::with(['deviceModel', 'palette', 'deviceModel.palette', 'user'])->find($deviceId);
+        $uuid = self::generateImageFromModel(
+            markup: $markup,
+            deviceModel: $device->deviceModel,
+            user: $device->user,
+            palette: $device->palette ?? $device->deviceModel?->palette,
+            device: $device
+        );
 
         $device->update(['current_screen_image' => $uuid]);
         Log::info("Device $device->id: updated with new image: $uuid");
@@ -87,42 +41,274 @@ class ImageGenerationService
     }
 
     /**
-     * @throws ImagickException
+     * Generate an image from markup using a DeviceModel
+     *
+     * @param  string  $markup  The HTML markup to render
+     * @param  DeviceModel|null  $deviceModel  The device model to use for image generation
+     * @param  \App\Models\User|null  $user  Optional user for timezone settings
+     * @param  \App\Models\DevicePalette|null  $palette  Optional palette, falls back to device model's palette
+     * @param  Device|null  $device  Optional device for legacy devices without DeviceModel
+     * @return string The UUID of the generated image
      */
-    private static function convertToBmpImageMagick(string $pngPath, string $bmpPath): void
-    {
-        $imagick = new Imagick($pngPath);
-        $imagick->setImageType(Imagick::IMGTYPE_GRAYSCALE);
-        $imagick->quantizeImage(2, Imagick::COLORSPACE_GRAY, 0, true, false);
-        $imagick->setImageDepth(1);
-        $imagick->stripImage();
-        $imagick->setFormat('BMP3');
-        $imagick->writeImage($bmpPath);
-        $imagick->clear();
+    public static function generateImageFromModel(
+        string $markup,
+        ?DeviceModel $deviceModel = null,
+        ?\App\Models\User $user = null,
+        ?\App\Models\DevicePalette $palette = null,
+        ?Device $device = null
+    ): string {
+        $uuid = Uuid::uuid4()->toString();
+
+        try {
+            // Get image generation settings from DeviceModel or Device (for legacy devices)
+            $imageSettings = $deviceModel
+                ? self::getImageSettingsFromModel($deviceModel)
+                : ($device ? self::getImageSettings($device) : self::getImageSettingsFromModel(null));
+
+            $fileExtension = $imageSettings['mime_type'] === 'image/bmp' ? 'bmp' : 'png';
+            $outputPath = Storage::disk('public')->path('/images/generated/'.$uuid.'.'.$fileExtension);
+
+            // Create custom Browsershot instance if using AWS Lambda
+            $browsershotInstance = null;
+            if (config('app.puppeteer_mode') === 'sidecar-aws') {
+                $browsershotInstance = new BrowsershotLambda();
+            }
+
+            $browserStage = new BrowserStage($browsershotInstance);
+            $browserStage->html($markup);
+
+            // Set timezone from user or fall back to app timezone
+            $timezone = $user?->timezone ?? config('app.timezone');
+            $browserStage->timezone($timezone);
+
+            if (config('app.puppeteer_window_size_strategy') === 'v2') {
+                $browserStage
+                    ->width($imageSettings['width'])
+                    ->height($imageSettings['height']);
+            } else {
+                // default behaviour for Framework v1
+                $browserStage->useDefaultDimensions();
+            }
+
+            if (config('app.puppeteer_wait_for_network_idle')) {
+                $browserStage->setBrowsershotOption('waitUntil', 'networkidle0');
+            }
+
+            if (config('app.puppeteer_docker')) {
+                $browserStage->setBrowsershotOption('args', ['--no-sandbox', '--disable-setuid-sandbox', '--disable-gpu']);
+            }
+
+            // Get palette from parameter or fallback to device model's default palette
+            $colorPalette = null;
+            if ($palette && $palette->colors) {
+                $colorPalette = $palette->colors;
+            } elseif ($deviceModel?->palette && $deviceModel->palette->colors) {
+                $colorPalette = $deviceModel->palette->colors;
+            }
+
+            $imageStage = new ImageStage();
+            $imageStage->format($fileExtension)
+                ->width($imageSettings['width'])
+                ->height($imageSettings['height'])
+                ->colors($imageSettings['colors'])
+                ->bitDepth($imageSettings['bit_depth'])
+                ->rotation($imageSettings['rotation'])
+                ->offsetX($imageSettings['offset_x'])
+                ->offsetY($imageSettings['offset_y'])
+                ->outputPath($outputPath);
+
+            // Apply color palette if available
+            if ($colorPalette) {
+                $imageStage->colormap($colorPalette);
+            }
+
+            // Apply dithering if requested by markup
+            $shouldDither = self::markupContainsDitherImage($markup);
+            if ($shouldDither) {
+                $imageStage->dither();
+            }
+
+            (new TrmnlPipeline())->pipe($browserStage)
+                ->pipe($imageStage)
+                ->process();
+
+            if (! file_exists($outputPath)) {
+                throw new RuntimeException('Image file was not created: '.$outputPath);
+            }
+
+            if (filesize($outputPath) === 0) {
+                throw new RuntimeException('Image file is empty: '.$outputPath);
+            }
+
+            Log::info("Generated image: $uuid");
+
+            return $uuid;
+
+        } catch (Exception $e) {
+            Log::error('Failed to generate image: '.$e->getMessage());
+            throw new RuntimeException('Failed to generate image: '.$e->getMessage(), 0, $e);
+        }
     }
 
     /**
-     * @throws ImagickException
+     * Get image generation settings from DeviceModel if available, otherwise use device settings
      */
-    private static function convertToPngImageMagick(string $pngPath, ?int $width, ?int $height, ?int $rotate, $quantize = true): void
+    private static function getImageSettings(Device $device): array
     {
-        $imagick = new Imagick($pngPath);
-        if ($width !== 800 || $height !== 480) {
-            $imagick->resizeImage($width, $height, Imagick::FILTER_LANCZOS, 1, true);
+        // If device has a DeviceModel, use its settings
+        if ($device->deviceModel) {
+            return self::getImageSettingsFromModel($device->deviceModel);
         }
-        if ($rotate !== null && $rotate !== 0) {
-            $imagick->rotateImage(new ImagickPixel('black'), $rotate);
-        }
-        $imagick->setImageType(Imagick::IMGTYPE_GRAYSCALE);
-        if ($quantize) {
-            $imagick->quantizeImage(2, Imagick::COLORSPACE_GRAY, 0, true, false);
-        }
-        $imagick->setImageDepth(8);
-        $imagick->stripImage();
 
-        $imagick->setFormat('png');
-        $imagick->writeImage($pngPath);
-        $imagick->clear();
+        // Fallback to device settings
+        $imageFormat = $device->image_format ?? ImageFormat::AUTO->value;
+        $mimeType = self::getMimeTypeFromImageFormat($imageFormat);
+        $colors = self::getColorsFromImageFormat($imageFormat);
+        $bitDepth = self::getBitDepthFromImageFormat($imageFormat);
+
+        return [
+            'width' => $device->width ?? 800,
+            'height' => $device->height ?? 480,
+            'colors' => $colors,
+            'bit_depth' => $bitDepth,
+            'scale_factor' => 1.0,
+            'rotation' => $device->rotate ?? 0,
+            'mime_type' => $mimeType,
+            'offset_x' => 0,
+            'offset_y' => 0,
+            'image_format' => $imageFormat,
+            'use_model_settings' => false,
+        ];
+    }
+
+    /**
+     * Get image generation settings from a DeviceModel
+     */
+    private static function getImageSettingsFromModel(?DeviceModel $deviceModel): array
+    {
+        if ($deviceModel) {
+            return [
+                'width' => $deviceModel->width,
+                'height' => $deviceModel->height,
+                'colors' => $deviceModel->colors,
+                'bit_depth' => $deviceModel->bit_depth,
+                'scale_factor' => $deviceModel->scale_factor,
+                'rotation' => $deviceModel->rotation,
+                'mime_type' => $deviceModel->mime_type,
+                'offset_x' => $deviceModel->offset_x,
+                'offset_y' => $deviceModel->offset_y,
+                'image_format' => self::determineImageFormatFromModel($deviceModel),
+                'use_model_settings' => true,
+            ];
+        }
+
+        // Default settings if no device model provided
+        return [
+            'width' => 800,
+            'height' => 480,
+            'colors' => 2,
+            'bit_depth' => 1,
+            'scale_factor' => 1.0,
+            'rotation' => 0,
+            'mime_type' => 'image/png',
+            'offset_x' => 0,
+            'offset_y' => 0,
+            'image_format' => ImageFormat::AUTO->value,
+            'use_model_settings' => false,
+        ];
+    }
+
+    /**
+     * Determine the appropriate ImageFormat based on DeviceModel settings
+     */
+    private static function determineImageFormatFromModel(DeviceModel $model): string
+    {
+        // Map DeviceModel settings to ImageFormat
+        if ($model->mime_type === 'image/bmp' && $model->bit_depth === 1) {
+            return ImageFormat::BMP3_1BIT_SRGB->value;
+        }
+        if ($model->mime_type === 'image/png' && $model->bit_depth === 8 && $model->colors === 2) {
+            return ImageFormat::PNG_8BIT_GRAYSCALE->value;
+        }
+        if ($model->mime_type === 'image/png' && $model->bit_depth === 8 && $model->colors === 256) {
+            return ImageFormat::PNG_8BIT_256C->value;
+        }
+        if ($model->mime_type === 'image/png' && $model->bit_depth === 2 && $model->colors === 4) {
+            return ImageFormat::PNG_2BIT_4C->value;
+        }
+
+        // Default to AUTO for unknown combinations
+        return ImageFormat::AUTO->value;
+    }
+
+    /**
+     * Get MIME type from ImageFormat
+     */
+    private static function getMimeTypeFromImageFormat(string $imageFormat): string
+    {
+        return match ($imageFormat) {
+            ImageFormat::BMP3_1BIT_SRGB->value => 'image/bmp',
+            ImageFormat::PNG_8BIT_GRAYSCALE->value,
+            ImageFormat::PNG_8BIT_256C->value,
+            ImageFormat::PNG_2BIT_4C->value => 'image/png',
+            ImageFormat::AUTO->value => 'image/png', // Default for AUTO
+            default => 'image/png',
+        };
+    }
+
+    /**
+     * Get colors from ImageFormat
+     */
+    private static function getColorsFromImageFormat(string $imageFormat): int
+    {
+        return match ($imageFormat) {
+            ImageFormat::BMP3_1BIT_SRGB->value,
+            ImageFormat::PNG_8BIT_GRAYSCALE->value => 2,
+            ImageFormat::PNG_8BIT_256C->value => 256,
+            ImageFormat::PNG_2BIT_4C->value => 4,
+            ImageFormat::AUTO->value => 2, // Default for AUTO
+            default => 2,
+        };
+    }
+
+    /**
+     * Get bit depth from ImageFormat
+     */
+    private static function getBitDepthFromImageFormat(string $imageFormat): int
+    {
+        return match ($imageFormat) {
+            ImageFormat::BMP3_1BIT_SRGB->value,
+            ImageFormat::PNG_8BIT_GRAYSCALE->value => 1,
+            ImageFormat::PNG_8BIT_256C->value => 8,
+            ImageFormat::PNG_2BIT_4C->value => 2,
+            ImageFormat::AUTO->value => 1, // Default for AUTO
+            default => 1,
+        };
+    }
+
+    /**
+     * Detect whether the provided HTML markup contains an <img> tag with class "image-dither".
+     */
+    private static function markupContainsDitherImage(string $markup): bool
+    {
+        if (mb_trim($markup) === '') {
+            return false;
+        }
+
+        // Find <img ... class="..."> (or with single quotes) and inspect class tokens
+        $imgWithClassPattern = '/<img\b[^>]*\bclass\s*=\s*(["\'])(.*?)\1[^>]*>/i';
+        if (! preg_match_all($imgWithClassPattern, $markup, $matches)) {
+            return false;
+        }
+
+        foreach ($matches[2] as $classValue) {
+            // Look for class token 'image-dither' or 'image--dither'
+            if (preg_match('/(?:^|\s)image--?dither(?:\s|$)/', $classValue)) {
+                return true;
+            }
+        }
+
+        return false;
     }
 
     public static function cleanupFolder(): void
@@ -148,17 +334,208 @@ class ImageGenerationService
     public static function resetIfNotCacheable(?Plugin $plugin): void
     {
         if ($plugin?->id) {
-            if (
-                Device::query()
-                    ->where('width', '!=', 800)
-                    ->orWhere('height', '!=', 480)
-                    ->orWhere('rotate', '!=', 0)
-                    ->exists()
-            ) {
+            // Image webhook plugins have finalized images that shouldn't be reset
+            if ($plugin->plugin_type === 'image_webhook') {
+                return;
+            }
+            // Check if any devices have custom dimensions or use non-standard DeviceModels
+            $hasCustomDimensions = Device::query()
+                ->where(function ($query): void {
+                    $query->where('width', '!=', 800)
+                        ->orWhere('height', '!=', 480)
+                        ->orWhere('rotate', '!=', 0);
+                })
+                ->orWhereHas('deviceModel', function ($query): void {
+                    // Only allow caching if all device models have standard dimensions (800x480, rotation=0)
+                    $query->where(function ($subQuery): void {
+                        $subQuery->where('width', '!=', 800)
+                            ->orWhere('height', '!=', 480)
+                            ->orWhere('rotation', '!=', 0);
+                    });
+                })
+                ->exists();
+
+            if ($hasCustomDimensions) {
                 // TODO cache image per device
                 $plugin->update(['current_image' => null]);
-                Log::debug('Skip cache as devices with other dimensions exist');
+                Log::debug('Skip cache as devices with custom dimensions or non-standard DeviceModels exist');
             }
         }
     }
+
+    /**
+     * Get device-specific default image path for setup or sleep mode
+     */
+    public static function getDeviceSpecificDefaultImage(Device $device, string $imageType): ?string
+    {
+        // Validate image type
+        if (! in_array($imageType, ['setup-logo', 'sleep', 'error'])) {
+            return null;
+        }
+
+        // If device has a DeviceModel, try to find device-specific image
+        if ($device->deviceModel) {
+            $model = $device->deviceModel;
+            $extension = $model->mime_type === 'image/bmp' ? 'bmp' : 'png';
+            $filename = "{$model->width}_{$model->height}_{$model->bit_depth}_{$model->rotation}.{$extension}";
+            $deviceSpecificPath = "images/default-screens/{$imageType}_{$filename}";
+
+            if (Storage::disk('public')->exists($deviceSpecificPath)) {
+                return $deviceSpecificPath;
+            }
+        }
+
+        // Fallback to original hardcoded images
+        $fallbackPath = "images/{$imageType}.bmp";
+        if (Storage::disk('public')->exists($fallbackPath)) {
+            return $fallbackPath;
+        }
+
+        // Try PNG fallback
+        $fallbackPathPng = "images/{$imageType}.png";
+        if (Storage::disk('public')->exists($fallbackPathPng)) {
+            return $fallbackPathPng;
+        }
+
+        return null;
+    }
+
+    /**
+     * Generate a default screen image from Blade template
+     */
+    public static function generateDefaultScreenImage(Device $device, string $imageType, ?string $pluginName = null): string
+    {
+        // Validate image type
+        if (! in_array($imageType, ['setup-logo', 'sleep', 'error'])) {
+            throw new InvalidArgumentException("Invalid image type: {$imageType}");
+        }
+
+        $uuid = Uuid::uuid4()->toString();
+
+        try {
+            // Load device with relationships
+            $device->load(['palette', 'deviceModel.palette', 'user']);
+
+            // Get image generation settings from DeviceModel if available, otherwise use device settings
+            $imageSettings = self::getImageSettings($device);
+
+            $fileExtension = $imageSettings['mime_type'] === 'image/bmp' ? 'bmp' : 'png';
+            $outputPath = Storage::disk('public')->path('/images/generated/'.$uuid.'.'.$fileExtension);
+
+            // Generate HTML from Blade template
+            $html = self::generateDefaultScreenHtml($device, $imageType, $pluginName);
+
+            // Create custom Browsershot instance if using AWS Lambda
+            $browsershotInstance = null;
+            if (config('app.puppeteer_mode') === 'sidecar-aws') {
+                $browsershotInstance = new BrowsershotLambda();
+            }
+
+            $browserStage = new BrowserStage($browsershotInstance);
+            $browserStage->html($html);
+
+            // Set timezone from user or fall back to app timezone
+            $timezone = $device->user->timezone ?? config('app.timezone');
+            $browserStage->timezone($timezone);
+
+            if (config('app.puppeteer_window_size_strategy') === 'v2') {
+                $browserStage
+                    ->width($imageSettings['width'])
+                    ->height($imageSettings['height']);
+            } else {
+                $browserStage->useDefaultDimensions();
+            }
+
+            if (config('app.puppeteer_wait_for_network_idle')) {
+                $browserStage->setBrowsershotOption('waitUntil', 'networkidle0');
+            }
+
+            if (config('app.puppeteer_docker')) {
+                $browserStage->setBrowsershotOption('args', ['--no-sandbox', '--disable-setuid-sandbox', '--disable-gpu']);
+            }
+
+            // Get palette from device or fallback to device model's default palette
+            $palette = $device->palette ?? $device->deviceModel?->palette;
+            $colorPalette = null;
+
+            if ($palette && $palette->colors) {
+                $colorPalette = $palette->colors;
+            }
+
+            $imageStage = new ImageStage();
+            $imageStage->format($fileExtension)
+                ->width($imageSettings['width'])
+                ->height($imageSettings['height'])
+                ->colors($imageSettings['colors'])
+                ->bitDepth($imageSettings['bit_depth'])
+                ->rotation($imageSettings['rotation'])
+                ->offsetX($imageSettings['offset_x'])
+                ->offsetY($imageSettings['offset_y'])
+                ->outputPath($outputPath);
+
+            // Apply color palette if available
+            if ($colorPalette) {
+                $imageStage->colormap($colorPalette);
+            }
+
+            (new TrmnlPipeline())->pipe($browserStage)
+                ->pipe($imageStage)
+                ->process();
+
+            if (! file_exists($outputPath)) {
+                throw new RuntimeException('Image file was not created: '.$outputPath);
+            }
+
+            if (filesize($outputPath) === 0) {
+                throw new RuntimeException('Image file is empty: '.$outputPath);
+            }
+
+            Log::info("Device $device->id: generated default screen image: $uuid for type: $imageType");
+
+            return $uuid;
+
+        } catch (Exception $e) {
+            Log::error('Failed to generate default screen image: '.$e->getMessage());
+            throw new RuntimeException('Failed to generate default screen image: '.$e->getMessage(), 0, $e);
+        }
+    }
+
+    /**
+     * Generate HTML from Blade template for default screens
+     */
+    private static function generateDefaultScreenHtml(Device $device, string $imageType, ?string $pluginName = null): string
+    {
+        // Map image type to template name
+        $templateName = match ($imageType) {
+            'setup-logo' => 'default-screens.setup',
+            'sleep' => 'default-screens.sleep',
+            'error' => 'default-screens.error',
+            default => throw new InvalidArgumentException("Invalid image type: {$imageType}")
+        };
+
+        // Determine device properties from DeviceModel or device settings
+        $deviceVariant = $device->deviceVariant();
+        $deviceOrientation = $device->rotate > 0 ? 'portrait' : 'landscape';
+        $colorDepth = $device->colorDepth() ?? '1bit';
+        $scaleLevel = $device->scaleLevel();
+        $darkMode = $imageType === 'sleep'; // Sleep mode uses dark mode, setup uses light mode
+
+        // Build view data
+        $viewData = [
+            'noBleed' => false,
+            'darkMode' => $darkMode,
+            'deviceVariant' => $deviceVariant,
+            'deviceOrientation' => $deviceOrientation,
+            'colorDepth' => $colorDepth,
+            'scaleLevel' => $scaleLevel,
+        ];
+
+        // Add plugin name for error screens
+        if ($imageType === 'error' && $pluginName !== null) {
+            $viewData['pluginName'] = $pluginName;
+        }
+
+        // Render the Blade template
+        return view($templateName, $viewData)->render();
+    }
 }

app/Services/OidcProvider.php

@@ -0,0 +1,158 @@
+<?php
+
+namespace App\Services;
+
+use Exception;
+use GuzzleHttp\Client;
+use Laravel\Socialite\Two\AbstractProvider;
+use Laravel\Socialite\Two\ProviderInterface;
+use Laravel\Socialite\Two\User;
+
+class OidcProvider extends AbstractProvider implements ProviderInterface
+{
+    /**
+     * The scopes being requested.
+     */
+    protected $scopes = [];
+
+    /**
+     * The separating character for the requested scopes.
+     */
+    protected $scopeSeparator = ' ';
+
+    /**
+     * The OIDC configuration.
+     */
+    protected $oidcConfig;
+
+    /**
+     * The base URL for OIDC endpoints.
+     */
+    protected $baseUrl;
+
+    /**
+     * Create a new provider instance.
+     */
+    public function __construct(\Illuminate\Http\Request $request, $clientId, $clientSecret, $redirectUrl, $scopes = [], $guzzle = [])
+    {
+        parent::__construct($request, $clientId, $clientSecret, $redirectUrl, $guzzle);
+
+        $endpoint = config('services.oidc.endpoint');
+        if (! $endpoint) {
+            throw new Exception('OIDC endpoint is not configured. Please set OIDC_ENDPOINT environment variable.');
+        }
+
+        // Handle both full well-known URL and base URL
+        if (str_ends_with((string) $endpoint, '/.well-known/openid-configuration')) {
+            $this->baseUrl = str_replace('/.well-known/openid-configuration', '', $endpoint);
+        } else {
+            $this->baseUrl = mb_rtrim($endpoint, '/');
+        }
+
+        $this->scopes = $scopes ?: ['openid', 'profile', 'email'];
+        $this->loadOidcConfiguration();
+    }
+
+    /**
+     * Load OIDC configuration from the well-known endpoint.
+     */
+    protected function loadOidcConfiguration()
+    {
+        try {
+            $url = $this->baseUrl.'/.well-known/openid-configuration';
+            $client = app(Client::class);
+            $response = $client->get($url);
+            $this->oidcConfig = json_decode($response->getBody()->getContents(), true);
+
+            if (! $this->oidcConfig) {
+                throw new Exception('OIDC configuration is empty or invalid JSON');
+            }
+
+            if (! isset($this->oidcConfig['authorization_endpoint'])) {
+                throw new Exception('authorization_endpoint not found in OIDC configuration');
+            }
+
+        } catch (Exception $e) {
+            throw new Exception('Failed to load OIDC configuration: '.$e->getMessage(), $e->getCode(), $e);
+        }
+    }
+
+    /**
+     * Get the authentication URL for the provider.
+     */
+    protected function getAuthUrl($state)
+    {
+        if (! $this->oidcConfig || ! isset($this->oidcConfig['authorization_endpoint'])) {
+            throw new Exception('OIDC configuration not loaded or authorization_endpoint not found.');
+        }
+
+        return $this->buildAuthUrlFromBase($this->oidcConfig['authorization_endpoint'], $state);
+    }
+
+    /**
+     * Get the token URL for the provider.
+     */
+    protected function getTokenUrl()
+    {
+        if (! $this->oidcConfig || ! isset($this->oidcConfig['token_endpoint'])) {
+            throw new Exception('OIDC configuration not loaded or token_endpoint not found.');
+        }
+
+        return $this->oidcConfig['token_endpoint'];
+    }
+
+    /**
+     * Get the raw user for the given access token.
+     */
+    protected function getUserByToken($token)
+    {
+        if (! $this->oidcConfig || ! isset($this->oidcConfig['userinfo_endpoint'])) {
+            throw new Exception('OIDC configuration not loaded or userinfo_endpoint not found.');
+        }
+
+        $response = $this->getHttpClient()->get($this->oidcConfig['userinfo_endpoint'], [
+            'headers' => [
+                'Authorization' => 'Bearer '.$token,
+            ],
+        ]);
+
+        return json_decode($response->getBody(), true);
+    }
+
+    /**
+     * Map the raw user array to a Socialite User instance.
+     */
+    public function mapUserToObject(array $user)
+    {
+        return (new User)->setRaw($user)->map([
+            'id' => $user['sub'],
+            'nickname' => $user['preferred_username'] ?? null,
+            'name' => $user['name'] ?? null,
+            'email' => $user['email'] ?? null,
+            'avatar' => $user['picture'] ?? null,
+        ]);
+    }
+
+    /**
+     * Get the access token response for the given code.
+     */
+    public function getAccessTokenResponse($code)
+    {
+        $response = $this->getHttpClient()->post($this->getTokenUrl(), [
+            'headers' => ['Accept' => 'application/json'],
+            'form_params' => $this->getTokenFields($code),
+        ]);
+
+        return json_decode($response->getBody(), true);
+    }
+
+    /**
+     * Get the POST fields for the token request.
+     */
+    protected function getTokenFields($code)
+    {
+        return array_merge(parent::getTokenFields($code), [
+            'grant_type' => 'authorization_code',
+        ]);
+    }
+}

app/Services/Plugin/Parsers/IcalResponseParser.php

@@ -0,0 +1,111 @@
+<?php
+
+namespace App\Services\Plugin\Parsers;
+
+use Carbon\Carbon;
+use DateTimeInterface;
+use Exception;
+use Illuminate\Http\Client\Response;
+use Illuminate\Support\Facades\Log;
+use om\IcalParser;
+
+class IcalResponseParser implements ResponseParser
+{
+    public function __construct(
+        private readonly IcalParser $parser = new IcalParser(),
+    ) {}
+
+    public function parse(Response $response): ?array
+    {
+        $contentType = $response->header('Content-Type');
+        $body = $response->body();
+
+        if (! $this->isIcalResponse($contentType, $body)) {
+            return null;
+        }
+
+        try {
+            $this->parser->parseString($body);
+
+            $events = $this->parser->getEvents()->sorted()->getArrayCopy();
+            $windowStart = now()->subDays(7);
+            $windowEnd = now()->addDays(30);
+
+            $filteredEvents = array_values(array_filter($events, function (array $event) use ($windowStart, $windowEnd): bool {
+                $startDate = $this->asCarbon($event['DTSTART'] ?? null);
+
+                if (! $startDate instanceof Carbon) {
+                    return false;
+                }
+
+                return $startDate->between($windowStart, $windowEnd, true);
+            }));
+
+            $normalizedEvents = array_map($this->normalizeIcalEvent(...), $filteredEvents);
+
+            return ['ical' => $normalizedEvents];
+        } catch (Exception $exception) {
+            Log::warning('Failed to parse iCal response: '.$exception->getMessage());
+
+            return ['error' => 'Failed to parse iCal response'];
+        }
+    }
+
+    private function isIcalResponse(?string $contentType, string $body): bool
+    {
+        $normalizedContentType = $contentType ? mb_strtolower($contentType) : '';
+
+        if ($normalizedContentType && str_contains($normalizedContentType, 'text/calendar')) {
+            return true;
+        }
+
+        return str_contains($body, 'BEGIN:VCALENDAR');
+    }
+
+    private function asCarbon(DateTimeInterface|string|null $value): ?Carbon
+    {
+        if ($value instanceof Carbon) {
+            return $value;
+        }
+
+        if ($value instanceof DateTimeInterface) {
+            return Carbon::instance($value);
+        }
+
+        if (is_string($value) && $value !== '') {
+            try {
+                return Carbon::parse($value);
+            } catch (Exception $exception) {
+                Log::warning('Failed to parse date value: '.$exception->getMessage());
+
+                return null;
+            }
+        }
+
+        return null;
+    }
+
+    private function normalizeIcalEvent(array $event): array
+    {
+        $normalized = [];
+
+        foreach ($event as $key => $value) {
+            $normalized[$key] = $this->normalizeIcalValue($value);
+        }
+
+        return $normalized;
+    }
+
+    private function normalizeIcalValue(mixed $value): mixed
+    {
+        if ($value instanceof DateTimeInterface) {
+            return Carbon::instance($value)->toAtomString();
+        }
+
+        if (is_array($value)) {
+            return array_map($this->normalizeIcalValue(...), $value);
+        }
+
+        return $value;
+    }
+}

app/Services/Plugin/Parsers/JsonOrTextResponseParser.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace App\Services\Plugin\Parsers;
+
+use Exception;
+use Illuminate\Http\Client\Response;
+use Illuminate\Support\Facades\Log;
+
+class JsonOrTextResponseParser implements ResponseParser
+{
+    public function parse(Response $response): array
+    {
+        try {
+            $json = $response->json();
+            if ($json !== null) {
+                return $json;
+            }
+
+            return ['data' => $response->body()];
+        } catch (Exception $e) {
+            Log::warning('Failed to parse JSON response: '.$e->getMessage());
+
+            return ['error' => 'Failed to parse JSON response'];
+        }
+    }
+}

app/Services/Plugin/Parsers/ResponseParser.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace App\Services\Plugin\Parsers;
+
+use Illuminate\Http\Client\Response;
+
+interface ResponseParser
+{
+    /**
+     * Attempt to parse the given response.
+     *
+     * Return null when the parser is not applicable so other parsers can run.
+     */
+    public function parse(Response $response): ?array;
+}

app/Services/Plugin/Parsers/ResponseParserRegistry.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace App\Services\Plugin\Parsers;
+
+class ResponseParserRegistry
+{
+    /**
+     * @var array<int, ResponseParser>
+     */
+    private readonly array $parsers;
+
+    /**
+     * @param  array<int, ResponseParser>  $parsers
+     */
+    public function __construct(array $parsers = [])
+    {
+        $this->parsers = $parsers ?: [
+            new XmlResponseParser(),
+            new IcalResponseParser(),
+            new JsonOrTextResponseParser(),
+        ];
+    }
+
+    /**
+     * @return array<int, ResponseParser>
+     */
+    public function getParsers(): array
+    {
+        return $this->parsers;
+    }
+}

app/Services/Plugin/Parsers/XmlResponseParser.php

@@ -0,0 +1,46 @@
+<?php
+
+namespace App\Services\Plugin\Parsers;
+
+use Exception;
+use Illuminate\Http\Client\Response;
+use Illuminate\Support\Facades\Log;
+use SimpleXMLElement;
+
+class XmlResponseParser implements ResponseParser
+{
+    public function parse(Response $response): ?array
+    {
+        $contentType = $response->header('Content-Type');
+
+        if (! $contentType || ! str_contains(mb_strtolower($contentType), 'xml')) {
+            return null;
+        }
+
+        try {
+            $xml = simplexml_load_string($response->body());
+            if ($xml === false) {
+                throw new Exception('Invalid XML content');
+            }
+
+            return ['rss' => $this->xmlToArray($xml)];
+        } catch (Exception $exception) {
+            Log::warning('Failed to parse XML response: '.$exception->getMessage());
+
+            return ['error' => 'Failed to parse XML response'];
+        }
+    }
+
+    private function xmlToArray(SimpleXMLElement $xml): array
+    {
+        $array = (array) $xml;
+
+        foreach ($array as $key => $value) {
+            if ($value instanceof SimpleXMLElement) {
+                $array[$key] = $this->xmlToArray($value);
+            }
+        }
+
+        return $array;
+    }
+}

app/Services/PluginExportService.php

@@ -0,0 +1,172 @@
+<?php
+
+namespace App\Services;
+
+use App\Models\Plugin;
+use App\Models\User;
+use Exception;
+use Illuminate\Http\Response;
+use Illuminate\Support\Facades\File;
+use Illuminate\Support\Facades\Storage;
+use RecursiveDirectoryIterator;
+use RecursiveIteratorIterator;
+use Symfony\Component\HttpFoundation\BinaryFileResponse;
+use Symfony\Component\Yaml\Yaml;
+use ZipArchive;
+
+/**
+ * PluginExportService
+ *
+ * Exports plugins to ZIP files in the same format that can be imported by PluginImportService.
+ *
+ * The exported ZIP file contains:
+ * - settings.yml: Plugin configuration including custom fields, polling settings, etc.
+ * - full.liquid or full.blade.php: The main template file
+ * - shared.liquid: Optional shared template (for liquid templates)
+ *
+ * This format is compatible with the PluginImportService and can be used to:
+ * - Backup plugins
+ * - Share plugins between users
+ * - Migrate plugins between environments
+ * - Create plugin templates
+ */
+class PluginExportService
+{
+    /**
+     * Export a plugin to a ZIP file in the same format that can be imported
+     *
+     * @param  Plugin  $plugin  The plugin to export
+     * @param  User  $user  The user exporting the plugin
+     * @return BinaryFileResponse The ZIP file response
+     *
+     * @throws Exception If the ZIP file cannot be created
+     */
+    public function exportToZip(Plugin $plugin, User $user): BinaryFileResponse
+    {
+        // Create a temporary directory
+        $tempDirName = 'temp/'.uniqid('plugin_export_', true);
+        Storage::makeDirectory($tempDirName);
+        $tempDir = Storage::path($tempDirName);
+        // Generate settings.yml content
+        $settings = $this->generateSettingsYaml($plugin);
+        $settingsYaml = Yaml::dump($settings, 10, 2, Yaml::DUMP_MULTI_LINE_LITERAL_BLOCK);
+        File::put($tempDir.'/settings.yml', $settingsYaml);
+        // Generate full template content
+        $fullTemplate = $this->generateFullTemplate($plugin);
+        $extension = $plugin->markup_language === 'liquid' ? 'liquid' : 'blade.php';
+        File::put($tempDir.'/full.'.$extension, $fullTemplate);
+        // Generate shared.liquid if needed (for liquid templates)
+        if ($plugin->markup_language === 'liquid') {
+            $sharedTemplate = $this->generateSharedTemplate();
+            /** @phpstan-ignore-next-line */
+            if ($sharedTemplate) {
+                File::put($tempDir.'/shared.liquid', $sharedTemplate);
+            }
+        }
+        // Create ZIP file
+        $zipPath = $tempDir.'/plugin_'.$plugin->trmnlp_id.'.zip';
+        $zip = new ZipArchive();
+        if ($zip->open($zipPath, ZipArchive::CREATE) !== true) {
+            throw new Exception('Could not create ZIP file.');
+        }
+        // Add files directly to ZIP root
+        $this->addDirectoryToZip($zip, $tempDir, '');
+        $zip->close();
+
+        // Return the ZIP file as a download response
+        return response()->download($zipPath, 'plugin_'.$plugin->trmnlp_id.'.zip');
+    }
+
+    /**
+     * Generate the settings.yml content for the plugin
+     */
+    private function generateSettingsYaml(Plugin $plugin): array
+    {
+        $settings = [];
+
+        // Add fields in the specific order requested
+        $settings['name'] = $plugin->name;
+        $settings['no_screen_padding'] = 'no'; // Default value
+        $settings['dark_mode'] = 'no'; // Default value
+        $settings['strategy'] = $plugin->data_strategy;
+
+        // Add static data if available
+        if ($plugin->data_payload) {
+            $settings['static_data'] = json_encode($plugin->data_payload, JSON_PRETTY_PRINT);
+        }
+
+        // Add polling configuration if applicable
+        if ($plugin->data_strategy === 'polling') {
+            if ($plugin->polling_verb) {
+                $settings['polling_verb'] = $plugin->polling_verb;
+            }
+            if ($plugin->polling_url) {
+                $settings['polling_url'] = $plugin->polling_url;
+            }
+            if ($plugin->polling_header) {
+                // Convert header format from "key: value" to "key=value"
+                $settings['polling_headers'] = str_replace(':', '=', $plugin->polling_header);
+            }
+            if ($plugin->polling_body) {
+                $settings['polling_body'] = $plugin->polling_body;
+            }
+        }
+
+        $settings['refresh_interval'] = $plugin->data_stale_minutes;
+        $settings['id'] = $plugin->trmnlp_id;
+
+        // Add custom fields from configuration template
+        if (isset($plugin->configuration_template['custom_fields'])) {
+            $settings['custom_fields'] = $plugin->configuration_template['custom_fields'];
+        }
+
+        return $settings;
+    }
+
+    /**
+     * Generate the full template content
+     */
+    private function generateFullTemplate(Plugin $plugin): string
+    {
+        $markup = $plugin->render_markup;
+
+        // Remove the wrapper div if it exists (it will be added during import)
+        $markup = preg_replace('/^<div class="view view--\{\{ size \}\}">\s*/', '', $markup);
+        $markup = preg_replace('/\s*<\/div>\s*$/', '', $markup);
+
+        return mb_trim($markup);
+    }
+
+    /**
+     * Generate the shared template content (for liquid templates)
+     */
+    private function generateSharedTemplate(): null
+    {
+        // For now, we don't have a way to store shared templates separately
+        // TODO - add support for shared templates
+        return null;
+    }
+
+    /**
+     * Add a directory and its contents to a ZIP file
+     */
+    private function addDirectoryToZip(ZipArchive $zip, string $dirPath, string $zipPath): void
+    {
+        $files = new RecursiveIteratorIterator(
+            new RecursiveDirectoryIterator($dirPath),
+            RecursiveIteratorIterator::LEAVES_ONLY
+        );
+
+        foreach ($files as $file) {
+            if (! $file->isDir()) {
+                $filePath = $file->getRealPath();
+                $fileName = basename((string) $filePath);
+
+                // For root directory, just use the filename
+                $relativePath = $zipPath === '' ? $fileName : $zipPath.'/'.mb_substr((string) $filePath, mb_strlen($dirPath) + 1);
+
+                $zip->addFile($filePath, $relativePath);
+            }
+        }
+    }
+}

app/Services/PluginImportService.php

@@ -0,0 +1,598 @@
+<?php
+
+namespace App\Services;
+
+use App\Models\Plugin;
+use App\Models\User;
+use Exception;
+use Illuminate\Http\UploadedFile;
+use Illuminate\Support\Facades\File;
+use Illuminate\Support\Facades\Http;
+use Illuminate\Support\Facades\Storage;
+use RecursiveDirectoryIterator;
+use RecursiveIteratorIterator;
+use Symfony\Component\Uid\Uuid;
+use Symfony\Component\Yaml\Yaml;
+use ZipArchive;
+
+class PluginImportService
+{
+    /**
+     * Validate YAML settings
+     *
+     * @param  array  $settings  The parsed YAML settings
+     *
+     * @throws Exception
+     */
+    private function validateYAML(array $settings): void
+    {
+        if (! isset($settings['custom_fields']) || ! is_array($settings['custom_fields'])) {
+            return;
+        }
+
+        foreach ($settings['custom_fields'] as $field) {
+            if (isset($field['field_type']) && $field['field_type'] === 'multi_string') {
+
+                if (isset($field['default']) && str_contains($field['default'], ',')) {
+                    throw new Exception("Validation Error: The default value for multistring fields like `{$field['keyname']}` cannot contain commas.");
+                }
+
+                if (isset($field['placeholder']) && str_contains($field['placeholder'], ',')) {
+                    throw new Exception("Validation Error: The placeholder value for multistring fields like `{$field['keyname']}` cannot contain commas.");
+                }
+
+            }
+        }
+    }
+
+    /**
+     * Import a plugin from a ZIP file
+     *
+     * @param  UploadedFile  $zipFile  The uploaded ZIP file
+     * @param  User  $user  The user importing the plugin
+     * @param  string|null  $zipEntryPath  Optional path to specific plugin in monorepo
+     * @return Plugin The created plugin instance
+     *
+     * @throws Exception If the ZIP file is invalid or required files are missing
+     */
+    public function importFromZip(UploadedFile $zipFile, User $user, ?string $zipEntryPath = null): Plugin
+    {
+        // Create a temporary directory using Laravel's temporary directory helper
+        $tempDirName = 'temp/'.uniqid('plugin_import_', true);
+        Storage::makeDirectory($tempDirName);
+        $tempDir = Storage::path($tempDirName);
+
+        try {
+            // Get the real path of the temporary file
+            $zipFullPath = $zipFile->getRealPath();
+
+            // Extract the ZIP file using ZipArchive
+            $zip = new ZipArchive();
+            if ($zip->open($zipFullPath) !== true) {
+                throw new Exception('Could not open the ZIP file.');
+            }
+
+            $zip->extractTo($tempDir);
+            $zip->close();
+
+            // Find the required files (settings.yml and full.liquid/full.blade.php/shared.liquid/shared.blade.php)
+            $filePaths = $this->findRequiredFiles($tempDir, $zipEntryPath);
+
+            // Validate that we found the required files
+            if (! $filePaths['settingsYamlPath']) {
+                throw new Exception('Invalid ZIP structure. Required file settings.yml is missing.');
+            }
+
+            // Validate that we have at least one template file
+            if (! $filePaths['fullLiquidPath'] && ! $filePaths['sharedLiquidPath'] && ! $filePaths['sharedBladePath']) {
+                throw new Exception('Invalid ZIP structure. At least one of the following files is required: full.liquid, full.blade.php, shared.liquid, or shared.blade.php.');
+            }
+
+            // Parse settings.yml
+            $settingsYaml = File::get($filePaths['settingsYamlPath']);
+            $settings = Yaml::parse($settingsYaml);
+            $this->validateYAML($settings);
+
+            // Determine which template file to use and read its content
+            $templatePath = null;
+            $markupLanguage = 'blade';
+
+            if ($filePaths['fullLiquidPath']) {
+                $templatePath = $filePaths['fullLiquidPath'];
+                $fullLiquid = File::get($templatePath);
+
+                // Prepend shared.liquid or shared.blade.php content if available
+                if ($filePaths['sharedLiquidPath'] && File::exists($filePaths['sharedLiquidPath'])) {
+                    $sharedLiquid = File::get($filePaths['sharedLiquidPath']);
+                    $fullLiquid = $sharedLiquid."\n".$fullLiquid;
+                } elseif ($filePaths['sharedBladePath'] && File::exists($filePaths['sharedBladePath'])) {
+                    $sharedBlade = File::get($filePaths['sharedBladePath']);
+                    $fullLiquid = $sharedBlade."\n".$fullLiquid;
+                }
+
+                // Check if the file ends with .liquid to set markup language
+                if (pathinfo((string) $templatePath, PATHINFO_EXTENSION) === 'liquid') {
+                    $markupLanguage = 'liquid';
+                    $fullLiquid = '<div class="view view--{{ size }}">'."\n".$fullLiquid."\n".'</div>';
+                }
+            } elseif ($filePaths['sharedLiquidPath']) {
+                $templatePath = $filePaths['sharedLiquidPath'];
+                $fullLiquid = File::get($templatePath);
+                $markupLanguage = 'liquid';
+                $fullLiquid = '<div class="view view--{{ size }}">'."\n".$fullLiquid."\n".'</div>';
+            } elseif ($filePaths['sharedBladePath']) {
+                $templatePath = $filePaths['sharedBladePath'];
+                $fullLiquid = File::get($templatePath);
+                $markupLanguage = 'blade';
+            }
+
+            // Ensure custom_fields is properly formatted
+            if (! isset($settings['custom_fields']) || ! is_array($settings['custom_fields'])) {
+                $settings['custom_fields'] = [];
+            }
+
+            // Normalize options in custom_fields (convert non-named values to named values)
+            $settings['custom_fields'] = $this->normalizeCustomFieldsOptions($settings['custom_fields']);
+
+            // Create configuration template with the custom fields
+            $configurationTemplate = [
+                'custom_fields' => $settings['custom_fields'],
+            ];
+
+            $plugin_updated = isset($settings['id'])
+                            && Plugin::where('user_id', $user->id)->where('trmnlp_id', $settings['id'])->exists();
+            // Create a new plugin
+            $plugin = Plugin::updateOrCreate(
+                [
+                    'user_id' => $user->id, 'trmnlp_id' => $settings['id'] ?? Uuid::v7(),
+                ],
+                [
+                    'user_id' => $user->id,
+                    'name' => $settings['name'] ?? 'Imported Plugin',
+                    'trmnlp_id' => $settings['id'] ?? Uuid::v7(),
+                    'data_stale_minutes' => $settings['refresh_interval'] ?? 15,
+                    'data_strategy' => $settings['strategy'] ?? 'static',
+                    'polling_url' => $settings['polling_url'] ?? null,
+                    'polling_verb' => $settings['polling_verb'] ?? 'get',
+                    'polling_header' => isset($settings['polling_headers'])
+                        ? str_replace('=', ':', $settings['polling_headers'])
+                        : null,
+                    'polling_body' => $settings['polling_body'] ?? null,
+                    'markup_language' => $markupLanguage,
+                    'render_markup' => $fullLiquid,
+                    'configuration_template' => $configurationTemplate,
+                    'data_payload' => json_decode($settings['static_data'] ?? '{}', true),
+                ]);
+
+            if (! $plugin_updated) {
+                // Extract default values from custom_fields and populate configuration
+                $configuration = [];
+                foreach ($settings['custom_fields'] as $field) {
+                    if (isset($field['keyname']) && isset($field['default'])) {
+                        $configuration[$field['keyname']] = $field['default'];
+                    }
+                }
+                // set only if plugin is new
+                $plugin->update([
+                    'configuration' => $configuration,
+                ]);
+            }
+            $plugin['trmnlp_yaml'] = $settingsYaml;
+
+            return $plugin;
+
+        } finally {
+            // Clean up temporary directory
+            Storage::deleteDirectory($tempDirName);
+        }
+    }
+
+    /**
+     * Import a plugin from a ZIP URL
+     *
+     * @param  string  $zipUrl  The URL to the ZIP file
+     * @param  User  $user  The user importing the plugin
+     * @param  string|null  $zipEntryPath  Optional path to specific plugin in monorepo
+     * @param  string|null  $preferredRenderer  Optional preferred renderer (e.g., 'trmnl-liquid')
+     * @param  string|null  $iconUrl  Optional icon URL to set on the plugin
+     * @param  bool  $allowDuplicate  If true, generate a new UUID for trmnlp_id if a plugin with the same trmnlp_id already exists
+     * @return Plugin The created plugin instance
+     *
+     * @throws Exception If the ZIP file is invalid or required files are missing
+     */
+    public function importFromUrl(string $zipUrl, User $user, ?string $zipEntryPath = null, $preferredRenderer = null, ?string $iconUrl = null, bool $allowDuplicate = false): Plugin
+    {
+        // Download the ZIP file
+        $response = Http::timeout(60)->get($zipUrl);
+
+        if (! $response->successful()) {
+            throw new Exception('Could not download the ZIP file from the provided URL.');
+        }
+
+        // Create a temporary file
+        $tempDirName = 'temp/'.uniqid('plugin_import_', true);
+        Storage::makeDirectory($tempDirName);
+        $tempDir = Storage::path($tempDirName);
+        $zipPath = $tempDir.'/plugin.zip';
+
+        // Save the downloaded content to a temporary file
+        File::put($zipPath, $response->body());
+
+        try {
+            // Extract the ZIP file using ZipArchive
+            $zip = new ZipArchive();
+            if ($zip->open($zipPath) !== true) {
+                throw new Exception('Could not open the downloaded ZIP file.');
+            }
+
+            $zip->extractTo($tempDir);
+            $zip->close();
+
+            // Find the required files (settings.yml and full.liquid/full.blade.php/shared.liquid/shared.blade.php)
+            $filePaths = $this->findRequiredFiles($tempDir, $zipEntryPath);
+
+            // Validate that we found the required files
+            if (! $filePaths['settingsYamlPath']) {
+                throw new Exception('Invalid ZIP structure. Required file settings.yml is missing.');
+            }
+
+            // Validate that we have at least one template file
+            if (! $filePaths['fullLiquidPath'] && ! $filePaths['sharedLiquidPath'] && ! $filePaths['sharedBladePath']) {
+                throw new Exception('Invalid ZIP structure. At least one of the following files is required: full.liquid, full.blade.php, shared.liquid, or shared.blade.php.');
+            }
+
+            // Parse settings.yml
+            $settingsYaml = File::get($filePaths['settingsYamlPath']);
+            $settings = Yaml::parse($settingsYaml);
+            $this->validateYAML($settings);
+
+            // Determine which template file to use and read its content
+            $templatePath = null;
+            $markupLanguage = 'blade';
+
+            if ($filePaths['fullLiquidPath']) {
+                $templatePath = $filePaths['fullLiquidPath'];
+                $fullLiquid = File::get($templatePath);
+
+                // Prepend shared.liquid or shared.blade.php content if available
+                if ($filePaths['sharedLiquidPath'] && File::exists($filePaths['sharedLiquidPath'])) {
+                    $sharedLiquid = File::get($filePaths['sharedLiquidPath']);
+                    $fullLiquid = $sharedLiquid."\n".$fullLiquid;
+                } elseif ($filePaths['sharedBladePath'] && File::exists($filePaths['sharedBladePath'])) {
+                    $sharedBlade = File::get($filePaths['sharedBladePath']);
+                    $fullLiquid = $sharedBlade."\n".$fullLiquid;
+                }
+
+                // Check if the file ends with .liquid to set markup language
+                if (pathinfo((string) $templatePath, PATHINFO_EXTENSION) === 'liquid') {
+                    $markupLanguage = 'liquid';
+                    $fullLiquid = '<div class="view view--{{ size }}">'."\n".$fullLiquid."\n".'</div>';
+                }
+            } elseif ($filePaths['sharedLiquidPath']) {
+                $templatePath = $filePaths['sharedLiquidPath'];
+                $fullLiquid = File::get($templatePath);
+                $markupLanguage = 'liquid';
+                $fullLiquid = '<div class="view view--{{ size }}">'."\n".$fullLiquid."\n".'</div>';
+            } elseif ($filePaths['sharedBladePath']) {
+                $templatePath = $filePaths['sharedBladePath'];
+                $fullLiquid = File::get($templatePath);
+                $markupLanguage = 'blade';
+            }
+
+            // Ensure custom_fields is properly formatted
+            if (! isset($settings['custom_fields']) || ! is_array($settings['custom_fields'])) {
+                $settings['custom_fields'] = [];
+            }
+
+            // Normalize options in custom_fields (convert non-named values to named values)
+            $settings['custom_fields'] = $this->normalizeCustomFieldsOptions($settings['custom_fields']);
+
+            // Create configuration template with the custom fields
+            $configurationTemplate = [
+                'custom_fields' => $settings['custom_fields'],
+            ];
+
+            // Determine the trmnlp_id to use
+            $trmnlpId = $settings['id'] ?? Uuid::v7();
+
+            // If allowDuplicate is true and a plugin with this trmnlp_id already exists, generate a new UUID
+            if ($allowDuplicate && isset($settings['id']) && Plugin::where('user_id', $user->id)->where('trmnlp_id', $settings['id'])->exists()) {
+                $trmnlpId = Uuid::v7();
+            }
+
+            $plugin_updated = ! $allowDuplicate && isset($settings['id'])
+                            && Plugin::where('user_id', $user->id)->where('trmnlp_id', $settings['id'])->exists();
+
+            // Create a new plugin
+            $plugin = Plugin::updateOrCreate(
+                [
+                    'user_id' => $user->id, 'trmnlp_id' => $trmnlpId,
+                ],
+                [
+                    'user_id' => $user->id,
+                    'name' => $settings['name'] ?? 'Imported Plugin',
+                    'trmnlp_id' => $trmnlpId,
+                    'data_stale_minutes' => $settings['refresh_interval'] ?? 15,
+                    'data_strategy' => $settings['strategy'] ?? 'static',
+                    'polling_url' => $settings['polling_url'] ?? null,
+                    'polling_verb' => $settings['polling_verb'] ?? 'get',
+                    'polling_header' => isset($settings['polling_headers'])
+                        ? str_replace('=', ':', $settings['polling_headers'])
+                        : null,
+                    'polling_body' => $settings['polling_body'] ?? null,
+                    'markup_language' => $markupLanguage,
+                    'render_markup' => $fullLiquid,
+                    'configuration_template' => $configurationTemplate,
+                    'data_payload' => json_decode($settings['static_data'] ?? '{}', true),
+                    'preferred_renderer' => $preferredRenderer,
+                    'icon_url' => $iconUrl,
+                ]);
+
+            if (! $plugin_updated) {
+                // Extract default values from custom_fields and populate configuration
+                $configuration = [];
+                foreach ($settings['custom_fields'] as $field) {
+                    if (isset($field['keyname']) && isset($field['default'])) {
+                        $configuration[$field['keyname']] = $field['default'];
+                    }
+                }
+                // set only if plugin is new
+                $plugin->update([
+                    'configuration' => $configuration,
+                ]);
+            }
+            $plugin['trmnlp_yaml'] = $settingsYaml;
+
+            return $plugin;
+
+        } finally {
+            // Clean up temporary directory
+            Storage::deleteDirectory($tempDirName);
+        }
+    }
+
+    private function findRequiredFiles(string $tempDir, ?string $zipEntryPath = null): array
+    {
+        $settingsYamlPath = null;
+        $fullLiquidPath = null;
+        $sharedLiquidPath = null;
+        $sharedBladePath = null;
+
+        // If zipEntryPath is specified, look for files in that specific directory first
+        if ($zipEntryPath) {
+            $targetDir = $tempDir.'/'.$zipEntryPath;
+            if (File::exists($targetDir)) {
+                // Check if files are directly in the target directory
+                if (File::exists($targetDir.'/settings.yml')) {
+                    $settingsYamlPath = $targetDir.'/settings.yml';
+
+                    if (File::exists($targetDir.'/full.liquid')) {
+                        $fullLiquidPath = $targetDir.'/full.liquid';
+                    } elseif (File::exists($targetDir.'/full.blade.php')) {
+                        $fullLiquidPath = $targetDir.'/full.blade.php';
+                    }
+
+                    if (File::exists($targetDir.'/shared.liquid')) {
+                        $sharedLiquidPath = $targetDir.'/shared.liquid';
+                    } elseif (File::exists($targetDir.'/shared.blade.php')) {
+                        $sharedBladePath = $targetDir.'/shared.blade.php';
+                    }
+                }
+
+                // Check if files are in src subdirectory of target directory
+                if (! $settingsYamlPath && File::exists($targetDir.'/src/settings.yml')) {
+                    $settingsYamlPath = $targetDir.'/src/settings.yml';
+
+                    if (File::exists($targetDir.'/src/full.liquid')) {
+                        $fullLiquidPath = $targetDir.'/src/full.liquid';
+                    } elseif (File::exists($targetDir.'/src/full.blade.php')) {
+                        $fullLiquidPath = $targetDir.'/src/full.blade.php';
+                    }
+
+                    if (File::exists($targetDir.'/src/shared.liquid')) {
+                        $sharedLiquidPath = $targetDir.'/src/shared.liquid';
+                    } elseif (File::exists($targetDir.'/src/shared.blade.php')) {
+                        $sharedBladePath = $targetDir.'/src/shared.blade.php';
+                    }
+                }
+
+                // If we found the required files in the target directory, return them
+                if ($settingsYamlPath && ($fullLiquidPath || $sharedLiquidPath || $sharedBladePath)) {
+                    return [
+                        'settingsYamlPath' => $settingsYamlPath,
+                        'fullLiquidPath' => $fullLiquidPath,
+                        'sharedLiquidPath' => $sharedLiquidPath,
+                        'sharedBladePath' => $sharedBladePath,
+                    ];
+                }
+            }
+        }
+
+        // First, check if files are directly in the src folder
+        if (File::exists($tempDir.'/src/settings.yml')) {
+            $settingsYamlPath = $tempDir.'/src/settings.yml';
+
+            // Check for full.liquid or full.blade.php
+            if (File::exists($tempDir.'/src/full.liquid')) {
+                $fullLiquidPath = $tempDir.'/src/full.liquid';
+            } elseif (File::exists($tempDir.'/src/full.blade.php')) {
+                $fullLiquidPath = $tempDir.'/src/full.blade.php';
+            }
+
+            // Check for shared.liquid or shared.blade.php in the same directory
+            if (File::exists($tempDir.'/src/shared.liquid')) {
+                $sharedLiquidPath = $tempDir.'/src/shared.liquid';
+            } elseif (File::exists($tempDir.'/src/shared.blade.php')) {
+                $sharedBladePath = $tempDir.'/src/shared.blade.php';
+            }
+        } else {
+            // Search for the files in the extracted directory structure
+            $directories = new RecursiveDirectoryIterator($tempDir, RecursiveDirectoryIterator::SKIP_DOTS);
+            $files = new RecursiveIteratorIterator($directories);
+
+            foreach ($files as $file) {
+                $filename = $file->getFilename();
+                $filepath = $file->getPathname();
+
+                if ($filename === 'settings.yml') {
+                    $settingsYamlPath = $filepath;
+                } elseif ($filename === 'full.liquid' || $filename === 'full.blade.php') {
+                    $fullLiquidPath = $filepath;
+                } elseif ($filename === 'shared.liquid') {
+                    $sharedLiquidPath = $filepath;
+                } elseif ($filename === 'shared.blade.php') {
+                    $sharedBladePath = $filepath;
+                }
+            }
+
+            // Check if shared.liquid or shared.blade.php exists in the same directory as full.liquid
+            if ($settingsYamlPath && $fullLiquidPath && ! $sharedLiquidPath && ! $sharedBladePath) {
+                $fullLiquidDir = dirname((string) $fullLiquidPath);
+                if (File::exists($fullLiquidDir.'/shared.liquid')) {
+                    $sharedLiquidPath = $fullLiquidDir.'/shared.liquid';
+                } elseif (File::exists($fullLiquidDir.'/shared.blade.php')) {
+                    $sharedBladePath = $fullLiquidDir.'/shared.blade.php';
+                }
+            }
+
+            // If we found the files but they're not in the src folder,
+            // check if they're in the root of the ZIP or in a subfolder
+            if ($settingsYamlPath && ($fullLiquidPath || $sharedLiquidPath || $sharedBladePath)) {
+                // If the files are in the root of the ZIP, create a src folder and move them there
+                $srcDir = dirname((string) $settingsYamlPath);
+
+                // If the parent directory is not named 'src', create a src directory
+                if (basename($srcDir) !== 'src') {
+                    $newSrcDir = $tempDir.'/src';
+                    File::makeDirectory($newSrcDir, 0755, true);
+
+                    // Copy the files to the src directory
+                    File::copy($settingsYamlPath, $newSrcDir.'/settings.yml');
+
+                    // Copy full.liquid or full.blade.php if it exists
+                    if ($fullLiquidPath) {
+                        $extension = pathinfo((string) $fullLiquidPath, PATHINFO_EXTENSION);
+                        File::copy($fullLiquidPath, $newSrcDir.'/full.'.$extension);
+                        $fullLiquidPath = $newSrcDir.'/full.'.$extension;
+                    }
+
+                    // Copy shared.liquid or shared.blade.php if it exists
+                    if ($sharedLiquidPath) {
+                        File::copy($sharedLiquidPath, $newSrcDir.'/shared.liquid');
+                        $sharedLiquidPath = $newSrcDir.'/shared.liquid';
+                    } elseif ($sharedBladePath) {
+                        File::copy($sharedBladePath, $newSrcDir.'/shared.blade.php');
+                        $sharedBladePath = $newSrcDir.'/shared.blade.php';
+                    }
+
+                    // Update the paths
+                    $settingsYamlPath = $newSrcDir.'/settings.yml';
+                }
+            }
+        }
+
+        return [
+            'settingsYamlPath' => $settingsYamlPath,
+            'fullLiquidPath' => $fullLiquidPath,
+            'sharedLiquidPath' => $sharedLiquidPath,
+            'sharedBladePath' => $sharedBladePath,
+        ];
+    }
+
+    /**
+     * Normalize options in custom_fields by converting non-named values to named values
+     * This ensures that options like ["true", "false"] become [["true" => "true"], ["false" => "false"]]
+     *
+     * @param  array  $customFields  The custom_fields array from settings
+     * @return array The normalized custom_fields array
+     */
+    private function normalizeCustomFieldsOptions(array $customFields): array
+    {
+        foreach ($customFields as &$field) {
+            // Only process select fields with options
+            if (isset($field['field_type']) && $field['field_type'] === 'select' && isset($field['options']) && is_array($field['options'])) {
+                $normalizedOptions = [];
+                foreach ($field['options'] as $option) {
+                    // If option is already a named value (array with key-value pair), keep it as is
+                    if (is_array($option)) {
+                        $normalizedOptions[] = $option;
+                    } else {
+                        // Convert non-named value to named value
+                        // Convert boolean to string, use lowercase for label
+                        $value = is_bool($option) ? ($option ? 'true' : 'false') : (string) $option;
+                        $normalizedOptions[] = [$value => $value];
+                    }
+                }
+                $field['options'] = $normalizedOptions;
+
+                // Normalize default value to match normalized option values
+                if (isset($field['default'])) {
+                    $default = $field['default'];
+                    // If default is boolean, convert to string to match normalized options
+                    if (is_bool($default)) {
+                        $field['default'] = $default ? 'true' : 'false';
+                    } else {
+                        // Convert to string to ensure consistency
+                        $field['default'] = (string) $default;
+                    }
+                }
+            }
+        }
+
+        return $customFields;
+    }
+
+    /**
+     * Validate that template and context are within command-line argument limits
+     *
+     * @param  string  $template  The liquid template string
+     * @param  string  $jsonContext  The JSON-encoded context
+     * @param  string  $liquidPath  The path to the liquid renderer executable
+     *
+     * @throws Exception If the template or context exceeds argument limits
+     */
+    public function validateExternalRendererArguments(string $template, string $jsonContext, string $liquidPath): void
+    {
+        // MAX_ARG_STRLEN on Linux is typically 131072 (128KB) for individual arguments
+        // ARG_MAX is the total size of all arguments (typically 2MB on modern systems)
+        $maxIndividualArgLength = 131072; // 128KB - MAX_ARG_STRLEN limit
+        $maxTotalArgLength = $this->getMaxArgumentLength();
+
+        // Check individual argument sizes (template and context are the largest)
+        if (mb_strlen($template) > $maxIndividualArgLength || mb_strlen($jsonContext) > $maxIndividualArgLength) {
+            throw new Exception('Context too large for external liquid renderer. Reduce the size of the Payload or Template.');
+        }
+
+        // Calculate total size of all arguments (path + flags + template + context)
+        // Add overhead for path, flags, and separators (conservative estimate: ~200 bytes)
+        $totalArgSize = mb_strlen($liquidPath) + mb_strlen('--template') + mb_strlen($template)
+            + mb_strlen('--context') + mb_strlen($jsonContext) + 200;
+
+        if ($totalArgSize > $maxTotalArgLength) {
+            throw new Exception('Context too large for external liquid renderer. Reduce the size of the Payload or Template.');
+        }
+    }
+
+    /**
+     * Get the maximum argument length for command-line arguments
+     *
+     * @return int Maximum argument length in bytes
+     */
+    private function getMaxArgumentLength(): int
+    {
+        // Try to get ARG_MAX from system using getconf
+        $argMax = null;
+        if (function_exists('shell_exec')) {
+            $result = @shell_exec('getconf ARG_MAX 2>/dev/null');
+            if ($result !== null && is_numeric(mb_trim($result))) {
+                $argMax = (int) mb_trim($result);
+            }
+        }
+
+        // Use conservative fallback if ARG_MAX cannot be determined
+        // ARG_MAX on macOS is typically 262144 (256KB), on Linux it's usually 2097152 (2MB)
+        // We use 200KB as a conservative limit that works on both systems
+        // Note: ARG_MAX includes environment variables, so we leave headroom
+        return $argMax !== null ? min($argMax, 204800) : 204800;
+    }
+}

composer.json

@@ -4,37 +4,45 @@
     "type": "project",
     "description": "TRMNL Server Implementation (BYOS) for Laravel",
     "keywords": [
-        "laravel",
-        "framework",
-        "trmnl"
+        "trmnl",
+        "trmnl-server",
+        "trmnl-byos",
+        "laravel"
     ],
     "license": "MIT",
     "require": {
         "php": "^8.2",
         "ext-imagick": "*",
-        "bnussbau/laravel-trmnl-blade": "1.1.*",
-        "intervention/image": "^3.11",
+        "ext-simplexml": "*",
+        "ext-zip": "*",
+        "bnussbau/laravel-trmnl-blade": "2.1.*",
+        "bnussbau/trmnl-pipeline-php": "^0.6.0",
         "keepsuit/laravel-liquid": "^0.5.2",
         "laravel/framework": "^12.1",
         "laravel/sanctum": "^4.0",
+        "laravel/socialite": "^5.23",
         "laravel/tinker": "^2.10.1",
         "livewire/flux": "^2.0",
         "livewire/volt": "^1.7",
+        "om/icalparser": "^3.2",
         "spatie/browsershot": "^5.0",
+        "stevebauman/purify": "^6.3",
+        "symfony/yaml": "^7.3",
         "wnx/sidecar-browsershot": "^2.6"
     },
     "require-dev": {
         "fakerphp/faker": "^1.23",
         "larastan/larastan": "^3.0",
+        "laravel/boost": "^1.0",
         "laravel/pail": "^1.2.2",
         "laravel/pint": "^1.18",
         "laravel/sail": "^1.41",
         "mockery/mockery": "^1.6",
         "nunomaduro/collision": "^8.6",
-        "pestphp/pest": "^3.7",
-        "pestphp/pest-plugin-drift": "^3.0",
-        "pestphp/pest-plugin-laravel": "^3.1",
-        "spatie/pest-expectations": "^1.10"
+        "pestphp/pest": "^4.0",
+        "pestphp/pest-plugin-drift": "^4.0",
+        "pestphp/pest-plugin-laravel": "^4.0",
+        "rector/rector": "^2.1"
     },
     "autoload": {
         "psr-4": {
@@ -70,7 +78,10 @@
         ],
         "test": "vendor/bin/pest",
         "test-coverage": "vendor/bin/pest --coverage",
-        "format": "vendor/bin/pint"
+        "format": "vendor/bin/pint",
+        "analyse": "vendor/bin/phpstan analyse",
+        "analyze": "vendor/bin/phpstan analyse",
+        "rector": "vendor/bin/rector process"
     },
     "extra": {
         "laravel": {

config/app.php

@@ -130,6 +130,8 @@ return [
     'force_https' => env('FORCE_HTTPS', false),
     'puppeteer_docker' => env('PUPPETEER_DOCKER', false),
     'puppeteer_mode' => env('PUPPETEER_MODE', 'local'),
+    'puppeteer_wait_for_network_idle' => env('PUPPETEER_WAIT_FOR_NETWORK_IDLE', true),
+    'puppeteer_window_size_strategy' => env('PUPPETEER_WINDOW_SIZE_STRATEGY', null),
 
     'notifications' => [
         'battery_low' => [
@@ -150,4 +152,5 @@ return [
 
     'version' => env('APP_VERSION', null),
 
+    'catalog_url' => env('CATALOG_URL', 'https://raw.githubusercontent.com/bnussbau/trmnl-recipe-catalog/refs/heads/main/catalog.yaml'),
 ];

config/services.php

@@ -41,6 +41,8 @@ return [
         'proxy_refresh_cron' => env('TRMNL_PROXY_REFRESH_CRON'),
         'override_orig_icon' => env('TRMNL_OVERRIDE_ORIG_ICON', false),
         'image_url_timeout' => env('TRMNL_IMAGE_URL_TIMEOUT', 30), // 30 seconds; increase on low-powered devices
+        'liquid_enabled' => env('TRMNL_LIQUID_ENABLED', false),
+        'liquid_path' => env('TRMNL_LIQUID_PATH', '/usr/local/bin/trmnl-liquid-cli'),
     ],
 
     'webhook' => [
@@ -50,4 +52,16 @@ return [
         ],
     ],
 
+    'oidc' => [
+        'enabled' => env('OIDC_ENABLED', false),
+        // OIDC_ENDPOINT can be either:
+        // - Base URL: https://your-provider.com (will append /.well-known/openid-configuration)
+        // - Full well-known URL: https://your-provider.com/.well-known/openid-configuration
+        'endpoint' => env('OIDC_ENDPOINT'),
+        'client_id' => env('OIDC_CLIENT_ID'),
+        'client_secret' => env('OIDC_CLIENT_SECRET'),
+        'redirect' => env('APP_URL', 'http://localhost:8000').'/auth/oidc/callback',
+        'scopes' => explode(',', env('OIDC_SCOPES', 'openid,profile,email')),
+    ],
+
 ];

config/trustedproxy.php

@@ -0,0 +1,6 @@
+<?php
+
+return [
+    // Comma‑separated list from .env, e.g. "10.0.0.0/8,172.16.0.0/12" or '*'
+    'proxies' => ($proxies = env('TRUSTED_PROXIES', '')) === '*' ? '*' : array_filter(explode(',', $proxies)),
+];

database/factories/DeviceModelFactory.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace Database\Factories;
+
+use App\Models\DeviceModel;
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/**
+ * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\DeviceModel>
+ */
+class DeviceModelFactory extends Factory
+{
+    protected $model = DeviceModel::class;
+
+    /**
+     * Define the model's default state.
+     *
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            'name' => $this->faker->unique()->slug(),
+            'label' => $this->faker->words(2, true),
+            'description' => $this->faker->sentence(),
+            'width' => $this->faker->randomElement([800, 1024, 1280, 1920]),
+            'height' => $this->faker->randomElement([480, 600, 720, 1080]),
+            'colors' => $this->faker->randomElement([2, 16, 256, 65536]),
+            'bit_depth' => $this->faker->randomElement([1, 4, 8, 16]),
+            'scale_factor' => $this->faker->randomElement([1, 2, 4]),
+            'rotation' => $this->faker->randomElement([0, 90, 180, 270]),
+            'mime_type' => $this->faker->randomElement(['image/png', 'image/jpeg', 'image/gif']),
+            'offset_x' => $this->faker->numberBetween(-100, 100),
+            'offset_y' => $this->faker->numberBetween(-100, 100),
+            'published_at' => $this->faker->optional()->dateTimeBetween('-1 year', 'now'),
+        ];
+    }
+}

database/factories/DevicePaletteFactory.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace Database\Factories;
+
+use App\Models\DevicePalette;
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/**
+ * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\DevicePalette>
+ */
+class DevicePaletteFactory extends Factory
+{
+    protected $model = DevicePalette::class;
+
+    /**
+     * Define the model's default state.
+     *
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            'id' => 'test-'.$this->faker->unique()->slug(),
+            'name' => $this->faker->words(3, true),
+            'grays' => $this->faker->randomElement([2, 4, 16, 256]),
+            'colors' => $this->faker->optional()->passthrough([
+                '#FF0000',
+                '#00FF00',
+                '#0000FF',
+                '#FFFF00',
+                '#000000',
+                '#FFFFFF',
+            ]),
+            'framework_class' => null,
+            'source' => 'api',
+        ];
+    }
+}

database/factories/PluginFactory.php

@@ -29,8 +29,24 @@ class PluginFactory extends Factory
             'icon_url' => null,
             'flux_icon_name' => null,
             'author_name' => $this->faker->name(),
+            'plugin_type' => 'recipe',
             'created_at' => Carbon::now(),
             'updated_at' => Carbon::now(),
         ];
     }
+
+    /**
+     * Indicate that the plugin is an image webhook plugin.
+     */
+    public function imageWebhook(): static
+    {
+        return $this->state(fn (array $attributes): array => [
+            'plugin_type' => 'image_webhook',
+            'data_strategy' => 'static',
+            'data_stale_minutes' => 60,
+            'polling_url' => null,
+            'polling_verb' => 'get',
+            'name' => $this->faker->randomElement(['Camera Feed', 'Security Camera', 'Webcam', 'Image Stream']),
+        ]);
+    }
 }

database/migrations/2025_06_13_102932_add_configuration_to_plugins_table.php

@@ -0,0 +1,30 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('plugins', function (Blueprint $table) {
+            $table->json('configuration_template')->nullable();
+            $table->json('configuration')->nullable();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('plugins', function (Blueprint $table) {
+            $table->dropColumn('configuration_template');
+            $table->dropColumn('configuration');
+        });
+    }
+};

database/migrations/2025_07_08_191003_add_sleep_mode_and_special_function_to_devices_table.php

@@ -0,0 +1,31 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('devices', function (Blueprint $table) {
+            $table->boolean('sleep_mode_enabled')->default(false);
+            $table->time('sleep_mode_from')->nullable();
+            $table->time('sleep_mode_to')->nullable();
+            $table->string('special_function')->nullable();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('devices', function (Blueprint $table) {
+            $table->dropColumn(['sleep_mode_enabled', 'sleep_mode_from', 'sleep_mode_to', 'special_function']);
+        });
+    }
+};

database/migrations/2025_07_10_164606_add_pause_until_to_devices_table.php

@@ -0,0 +1,22 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::table('devices', function (Blueprint $table) {
+            $table->dateTime('pause_until')->nullable()->after('last_refreshed_at');
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('devices', function (Blueprint $table) {
+            $table->dropColumn('pause_until');
+        });
+    }
+};

database/migrations/2025_08_04_064514_add_oidc_sub_to_users_table.php

@@ -0,0 +1,29 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('users', function (Blueprint $table) {
+            $table->string('oidc_sub')->nullable()->unique()->after('email');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('users', function (Blueprint $table) {
+            $table->dropUnique(['oidc_sub']);
+            $table->dropColumn('oidc_sub');
+        });
+    }
+};

database/migrations/2025_08_07_111635_create_device_models_table.php

@@ -0,0 +1,41 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('device_models', function (Blueprint $table) {
+            $table->id();
+            $table->string('name')->unique();
+            $table->string('label');
+            $table->text('description');
+            $table->unsignedInteger('width');
+            $table->unsignedInteger('height');
+            $table->unsignedInteger('colors');
+            $table->unsignedInteger('bit_depth');
+            $table->float('scale_factor');
+            $table->integer('rotation');
+            $table->string('mime_type');
+            $table->integer('offset_x')->default(0);
+            $table->integer('offset_y')->default(0);
+            $table->timestamp('published_at')->nullable();
+            $table->string('source')->nullable();
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('device_models');
+    }
+};

database/migrations/2025_08_07_131843_add_device_model_id_to_devices_table.php

@@ -0,0 +1,29 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('devices', function (Blueprint $table) {
+            $table->foreignId('device_model_id')->nullable()->constrained('device_models')->nullOnDelete();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('devices', function (Blueprint $table) {
+            $table->dropForeign(['device_model_id']);
+            $table->dropColumn('device_model_id');
+        });
+    }
+};

database/migrations/2025_08_16_135740_seed_device_models.php

@@ -0,0 +1,285 @@
+<?php
+
+use App\Models\DeviceModel;
+use Illuminate\Database\Migrations\Migration;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        $deviceModels = [
+            [
+                'name' => 'og_png',
+                'label' => 'TRMNL OG (1-bit)',
+                'description' => 'TRMNL OG (1-bit)',
+                'width' => 800,
+                'height' => 480,
+                'colors' => 2,
+                'bit_depth' => 1,
+                'scale_factor' => 1,
+                'rotation' => 0,
+                'mime_type' => 'image/png',
+                'offset_x' => 0,
+                'offset_y' => 0,
+                'published_at' => '2024-01-01 00:00:00',
+                'source' => 'api',
+                'created_at' => now(),
+                'updated_at' => now(),
+            ],
+            [
+                'name' => 'og_plus',
+                'label' => 'TRMNL OG (2-bit)',
+                'description' => 'TRMNL OG (2-bit)',
+                'width' => 800,
+                'height' => 480,
+                'colors' => 4,
+                'bit_depth' => 2,
+                'scale_factor' => 1,
+                'rotation' => 0,
+                'mime_type' => 'image/png',
+                'offset_x' => 0,
+                'offset_y' => 0,
+                'published_at' => '2024-01-01 00:00:00',
+                'source' => 'api',
+                'created_at' => now(),
+                'updated_at' => now(),
+            ],
+            [
+                'name' => 'amazon_kindle_2024',
+                'label' => 'Amazon Kindle 2024',
+                'description' => 'Amazon Kindle 2024',
+                'width' => 1400,
+                'height' => 840,
+                'colors' => 256,
+                'bit_depth' => 8,
+                'scale_factor' => 2.414,
+                'rotation' => 90,
+                'mime_type' => 'image/png',
+                'offset_x' => 75,
+                'offset_y' => 25,
+                'published_at' => '2024-01-01 00:00:00',
+                'source' => 'api',
+                'created_at' => now(),
+                'updated_at' => now(),
+            ],
+            [
+                'name' => 'amazon_kindle_paperwhite_6th_gen',
+                'label' => 'Amazon Kindle PW 6th Gen',
+                'description' => 'Amazon Kindle PW 6th Gen',
+                'width' => 1024,
+                'height' => 768,
+                'colors' => 256,
+                'bit_depth' => 8,
+                'scale_factor' => 1,
+                'rotation' => 90,
+                'mime_type' => 'image/png',
+                'offset_x' => 0,
+                'offset_y' => 0,
+                'published_at' => '2024-01-01 00:00:00',
+                'source' => 'api',
+                'created_at' => now(),
+                'updated_at' => now(),
+            ],
+            [
+                'name' => 'amazon_kindle_paperwhite_7th_gen',
+                'label' => 'Amazon Kindle PW 7th Gen',
+                'description' => 'Amazon Kindle PW 7th Gen',
+                'width' => 1448,
+                'height' => 1072,
+                'colors' => 256,
+                'bit_depth' => 8,
+                'scale_factor' => 1,
+                'rotation' => 90,
+                'mime_type' => 'image/png',
+                'offset_x' => 0,
+                'offset_y' => 0,
+                'published_at' => '2024-01-01 00:00:00',
+                'source' => 'api',
+                'created_at' => now(),
+                'updated_at' => now(),
+            ],
+            [
+                'name' => 'inkplate_10',
+                'label' => 'Inkplate 10',
+                'description' => 'Inkplate 10',
+                'width' => 1200,
+                'height' => 820,
+                'colors' => 8,
+                'bit_depth' => 3,
+                'scale_factor' => 1,
+                'rotation' => 0,
+                'mime_type' => 'image/png',
+                'offset_x' => 0,
+                'offset_y' => 0,
+                'published_at' => '2024-01-01 00:00:00',
+                'source' => 'api',
+                'created_at' => now(),
+                'updated_at' => now(),
+            ],
+            [
+                'name' => 'amazon_kindle_7',
+                'label' => 'Amazon Kindle 7',
+                'description' => 'Amazon Kindle 7',
+                'width' => 800,
+                'height' => 600,
+                'colors' => 256,
+                'bit_depth' => 8,
+                'scale_factor' => 1,
+                'rotation' => 90,
+                'mime_type' => 'image/png',
+                'offset_x' => 0,
+                'offset_y' => 0,
+                'published_at' => '2024-01-01 00:00:00',
+                'source' => 'api',
+                'created_at' => now(),
+                'updated_at' => now(),
+            ],
+            [
+                'name' => 'inky_impression_7_3',
+                'label' => 'Inky Impression 7.3',
+                'description' => 'Inky Impression 7.3',
+                'width' => 800,
+                'height' => 480,
+                'colors' => 2,
+                'bit_depth' => 1,
+                'scale_factor' => 1,
+                'rotation' => 0,
+                'mime_type' => 'image/png',
+                'offset_x' => 0,
+                'offset_y' => 0,
+                'published_at' => '2024-01-01 00:00:00',
+                'source' => 'api',
+                'created_at' => now(),
+                'updated_at' => now(),
+            ],
+            [
+                'name' => 'kobo_libra_2',
+                'label' => 'Kobo Libra 2',
+                'description' => 'Kobo Libra 2',
+                'width' => 1680,
+                'height' => 1264,
+                'colors' => 256,
+                'bit_depth' => 8,
+                'scale_factor' => 1,
+                'rotation' => 90,
+                'mime_type' => 'image/png',
+                'offset_x' => 0,
+                'offset_y' => 0,
+                'published_at' => '2024-01-01 00:00:00',
+                'source' => 'api',
+                'created_at' => now(),
+                'updated_at' => now(),
+            ],
+            [
+                'name' => 'amazon_kindle_oasis_2',
+                'label' => 'Amazon Kindle Oasis 2',
+                'description' => 'Amazon Kindle Oasis 2',
+                'width' => 1680,
+                'height' => 1264,
+                'colors' => 256,
+                'bit_depth' => 8,
+                'scale_factor' => 1,
+                'rotation' => 90,
+                'mime_type' => 'image/png',
+                'offset_x' => 0,
+                'offset_y' => 0,
+                'published_at' => '2024-01-01 00:00:00',
+                'source' => 'api',
+                'created_at' => now(),
+                'updated_at' => now(),
+            ],
+            [
+                'name' => 'kobo_aura_one',
+                'label' => 'Kobo Aura One',
+                'description' => 'Kobo Aura One',
+                'width' => 1872,
+                'height' => 1404,
+                'colors' => 256,
+                'bit_depth' => 8,
+                'scale_factor' => 1,
+                'rotation' => 90,
+                'mime_type' => 'image/png',
+                'offset_x' => 0,
+                'offset_y' => 0,
+                'published_at' => '2024-01-01 00:00:00',
+                'source' => 'api',
+                'created_at' => now(),
+                'updated_at' => now(),
+            ],
+            [
+                'name' => 'kobo_aura_hd',
+                'label' => 'Kobo Aura HD',
+                'description' => 'Kobo Aura HD',
+                'width' => 1440,
+                'height' => 1080,
+                'colors' => 16,
+                'bit_depth' => 4,
+                'scale_factor' => 1,
+                'rotation' => 90,
+                'mime_type' => 'image/png',
+                'offset_x' => 0,
+                'offset_y' => 0,
+                'published_at' => '2024-01-01 00:00:00',
+                'source' => 'api',
+                'created_at' => now(),
+                'updated_at' => now(),
+            ],
+            [
+                'name' => 'inky_impression_13_3',
+                'label' => 'Inky Impression 13.3',
+                'description' => 'Inky Impression 13.3',
+                'width' => 1600,
+                'height' => 1200,
+                'colors' => 2,
+                'bit_depth' => 1,
+                'scale_factor' => 1,
+                'rotation' => 0,
+                'mime_type' => 'image/png',
+                'offset_x' => 0,
+                'offset_y' => 0,
+                'published_at' => '2024-01-01 00:00:00',
+                'source' => 'api',
+                'created_at' => now(),
+                'updated_at' => now(),
+            ],
+        ];
+
+        // Upsert by unique 'name' to avoid duplicates and keep data fresh
+        DeviceModel::query()->upsert(
+            $deviceModels,
+            ['name'],
+            [
+                'label', 'description', 'width', 'height', 'colors', 'bit_depth', 'scale_factor',
+                'rotation', 'mime_type', 'offset_x', 'offset_y', 'published_at', 'source',
+                'created_at', 'updated_at',
+            ]
+        );
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        $names = [
+            'og_png',
+            'amazon_kindle_2024',
+            'amazon_kindle_paperwhite_6th_gen',
+            'amazon_kindle_paperwhite_7th_gen',
+            'inkplate_10',
+            'amazon_kindle_7',
+            'inky_impression_7_3',
+            'kobo_libra_2',
+            'amazon_kindle_oasis_2',
+            'og_plus',
+            'kobo_aura_one',
+            'kobo_aura_hd',
+            'inky_impression_13_3',
+        ];
+
+        DeviceModel::query()->whereIn('name', $names)->delete();
+    }
+};

database/migrations/2025_08_22_231823_add_trmnlp_to_plugins_table.php

@@ -0,0 +1,28 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('plugins', function (Blueprint $table) {
+            $table->string('trmnlp_id')->nullable()->after('uuid');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('plugins', function (Blueprint $table) {
+            $table->dropColumn('trmnlp_id');
+        });
+    }
+};

database/migrations/2025_10_30_144500_add_no_bleed_and_dark_mode_to_plugins_table.php

@@ -0,0 +1,32 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::table('plugins', function (Blueprint $table): void {
+            if (! Schema::hasColumn('plugins', 'no_bleed')) {
+                $table->boolean('no_bleed')->default(false)->after('configuration_template');
+            }
+            if (! Schema::hasColumn('plugins', 'dark_mode')) {
+                $table->boolean('dark_mode')->default(false)->after('no_bleed');
+            }
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('plugins', function (Blueprint $table): void {
+            if (Schema::hasColumn('plugins', 'dark_mode')) {
+                $table->dropColumn('dark_mode');
+            }
+            if (Schema::hasColumn('plugins', 'no_bleed')) {
+                $table->dropColumn('no_bleed');
+            }
+        });
+    }
+};

database/migrations/2025_11_03_213452_add_preferred_renderer_to_plugins_table.php

@@ -0,0 +1,28 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('plugins', function (Blueprint $table) {
+            $table->string('preferred_renderer')->nullable()->after('markup_language');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('plugins', function (Blueprint $table) {
+            $table->dropColumn('preferred_renderer');
+        });
+    }
+};

database/migrations/2025_11_22_084119_create_device_palettes_table.php

@@ -0,0 +1,33 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('device_palettes', function (Blueprint $table) {
+            $table->id();
+            $table->string('name')->unique();
+            $table->string('description')->nullable();
+            $table->integer('grays');
+            $table->json('colors')->nullable();
+            $table->string('framework_class')->default('');
+            $table->string('source')->default('api');
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('device_palettes');
+    }
+};

database/migrations/2025_11_22_084208_add_palette_id_to_device_models_table.php

@@ -0,0 +1,29 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('device_models', function (Blueprint $table) {
+            $table->foreignId('palette_id')->nullable()->after('source')->constrained('device_palettes')->onDelete('set null');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('device_models', function (Blueprint $table) {
+            $table->dropForeign(['palette_id']);
+            $table->dropColumn('palette_id');
+        });
+    }
+};

database/migrations/2025_11_22_084211_add_palette_id_to_devices_table.php

@@ -0,0 +1,29 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('devices', function (Blueprint $table) {
+            $table->foreignId('palette_id')->nullable()->constrained('device_palettes')->onDelete('set null');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('devices', function (Blueprint $table) {
+            $table->dropForeign(['palette_id']);
+            $table->dropColumn('palette_id');
+        });
+    }
+};

database/migrations/2025_11_22_084425_seed_palettes_and_relationships.php

@@ -0,0 +1,124 @@
+<?php
+
+use App\Models\DeviceModel;
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Support\Facades\DB;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        // Seed palettes from hardcoded data
+        // name = identifier, description = human-readable name
+        $palettes = [
+            [
+                'name' => 'bw',
+                'description' => 'Black & White',
+                'grays' => 2,
+                'colors' => null,
+                'framework_class' => 'screen--1bit',
+                'source' => 'api',
+            ],
+            [
+                'name' => 'gray-4',
+                'description' => '4 Grays',
+                'grays' => 4,
+                'colors' => null,
+                'framework_class' => 'screen--2bit',
+                'source' => 'api',
+            ],
+            [
+                'name' => 'gray-16',
+                'description' => '16 Grays',
+                'grays' => 16,
+                'colors' => null,
+                'framework_class' => 'screen--4bit',
+                'source' => 'api',
+            ],
+            [
+                'name' => 'gray-256',
+                'description' => '256 Grays',
+                'grays' => 256,
+                'colors' => null,
+                'framework_class' => 'screen--4bit',
+                'source' => 'api',
+            ],
+            [
+                'name' => 'color-6a',
+                'description' => '6 Colors',
+                'grays' => 2,
+                'colors' => json_encode(['#FF0000', '#00FF00', '#0000FF', '#FFFF00', '#000000', '#FFFFFF']),
+                'framework_class' => '',
+                'source' => 'api',
+            ],
+            [
+                'name' => 'color-7a',
+                'description' => '7 Colors',
+                'grays' => 2,
+                'colors' => json_encode(['#000000', '#FFFFFF', '#FF0000', '#00FF00', '#0000FF', '#FFFF00', '#FFA500']),
+                'framework_class' => '',
+                'source' => 'api',
+            ],
+        ];
+
+        $now = now();
+        $paletteIdMap = [];
+
+        foreach ($palettes as $paletteData) {
+            $paletteName = $paletteData['name'];
+            $paletteData['created_at'] = $now;
+            $paletteData['updated_at'] = $now;
+
+            DB::table('device_palettes')->updateOrInsert(
+                ['name' => $paletteName],
+                $paletteData
+            );
+
+            // Get the ID of the palette (either newly created or existing)
+            $paletteRecord = DB::table('device_palettes')->where('name', $paletteName)->first();
+            $paletteIdMap[$paletteName] = $paletteRecord->id;
+        }
+
+        // Set default palette_id on DeviceModel based on first palette_ids entry
+        $models = [
+            ['name' => 'og_png', 'palette_name' => 'bw'],
+            ['name' => 'og_plus', 'palette_name' => 'gray-4'],
+            ['name' => 'amazon_kindle_2024', 'palette_name' => 'gray-256'],
+            ['name' => 'amazon_kindle_paperwhite_6th_gen', 'palette_name' => 'gray-256'],
+            ['name' => 'amazon_kindle_paperwhite_7th_gen', 'palette_name' => 'gray-256'],
+            ['name' => 'inkplate_10', 'palette_name' => 'gray-4'],
+            ['name' => 'amazon_kindle_7', 'palette_name' => 'gray-256'],
+            ['name' => 'inky_impression_7_3', 'palette_name' => 'color-7a'],
+            ['name' => 'kobo_libra_2', 'palette_name' => 'gray-16'],
+            ['name' => 'amazon_kindle_oasis_2', 'palette_name' => 'gray-256'],
+            ['name' => 'kobo_aura_one', 'palette_name' => 'gray-16'],
+            ['name' => 'kobo_aura_hd', 'palette_name' => 'gray-16'],
+            ['name' => 'inky_impression_13_3', 'palette_name' => 'color-6a'],
+            ['name' => 'm5_paper_s3', 'palette_name' => 'gray-16'],
+            ['name' => 'amazon_kindle_scribe', 'palette_name' => 'gray-256'],
+            ['name' => 'seeed_e1001', 'palette_name' => 'gray-4'],
+            ['name' => 'seeed_e1002', 'palette_name' => 'gray-4'],
+            ['name' => 'waveshare_4_26', 'palette_name' => 'gray-4'],
+            ['name' => 'waveshare_7_5_bw', 'palette_name' => 'bw'],
+        ];
+
+        foreach ($models as $modelData) {
+            $deviceModel = DeviceModel::where('name', $modelData['name'])->first();
+            if ($deviceModel && ! $deviceModel->palette_id && isset($paletteIdMap[$modelData['palette_name']])) {
+                $deviceModel->update(['palette_id' => $paletteIdMap[$modelData['palette_name']]]);
+            }
+        }
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        // Remove palette_id from device models but keep palettes
+        DeviceModel::query()->update(['palette_id' => null]);
+    }
+};

database/migrations/2025_12_02_154228_add_timezone_to_users_table.php

@@ -0,0 +1,28 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('users', function (Blueprint $table) {
+            $table->string('timezone')->nullable()->after('oidc_sub');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('users', function (Blueprint $table) {
+            $table->dropColumn('timezone');
+        });
+    }
+};

database/migrations/2026_01_05_153321_add_plugin_type_to_plugins_table.php

@@ -0,0 +1,28 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('plugins', function (Blueprint $table): void {
+            $table->string('plugin_type')->default('recipe')->after('uuid');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('plugins', function (Blueprint $table): void {
+            $table->dropColumn('plugin_type');
+        });
+    }
+};

database/migrations/2026_01_08_173521_add_kind_to_device_models_table.php

@@ -0,0 +1,33 @@
+<?php
+
+use App\Models\DeviceModel;
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('device_models', function (Blueprint $table) {
+            $table->string('kind')->nullable()->index();
+        });
+
+        // Set existing og_png and og_plus to kind "trmnl"
+        DeviceModel::whereIn('name', ['og_png', 'og_plus'])->update(['kind' => 'trmnl']);
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('device_models', function (Blueprint $table) {
+            $table->dropIndex(['kind']);
+            $table->dropColumn('kind');
+        });
+    }
+};

database/migrations/2026_01_11_121809_make_trmnlp_id_unique_in_plugins_table.php

@@ -0,0 +1,58 @@
+<?php
+
+use App\Models\Plugin;
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        // Find and handle duplicate (user_id, trmnlp_id) combinations
+        $duplicates = Plugin::query()
+            ->selectRaw('user_id, trmnlp_id, COUNT(*) as duplicate_count')
+            ->whereNotNull('trmnlp_id')
+            ->groupBy('user_id', 'trmnlp_id')
+            ->havingRaw('COUNT(*) > ?', [1])
+            ->get();
+
+        // For each duplicate combination, keep the first one (by id) and set others to null
+        foreach ($duplicates as $duplicate) {
+            $plugins = Plugin::query()
+                ->where('user_id', $duplicate->user_id)
+                ->where('trmnlp_id', $duplicate->trmnlp_id)
+                ->orderBy('id')
+                ->get();
+
+            // Keep the first one, set the rest to null
+            $keepFirst = true;
+            foreach ($plugins as $plugin) {
+                if ($keepFirst) {
+                    $keepFirst = false;
+
+                    continue;
+                }
+
+                $plugin->update(['trmnlp_id' => null]);
+            }
+        }
+
+        Schema::table('plugins', function (Blueprint $table) {
+            $table->unique(['user_id', 'trmnlp_id']);
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('plugins', function (Blueprint $table) {
+            $table->dropUnique(['user_id', 'trmnlp_id']);
+        });
+    }
+};

database/migrations/2026_01_11_173757_add_alias_to_plugins_table.php

@@ -0,0 +1,28 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('plugins', function (Blueprint $table) {
+            $table->boolean('alias')->default(false);
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('plugins', function (Blueprint $table) {
+            $table->dropColumn('alias');
+        });
+    }
+};

database/seeders/ExampleRecipesSeeder.php

@@ -13,8 +13,8 @@ class ExampleRecipesSeeder extends Seeder
     public function run($user_id = 1): void
     {
         Plugin::updateOrCreate(
+            ['uuid' => '9e46c6cf-358c-4bfe-8998-436b3a207fec'],
             [
-                'uuid' => '9e46c6cf-358c-4bfe-8998-436b3a207fec',
                 'name' => 'ÖBB Departures',
                 'user_id' => $user_id,
                 'data_payload' => null,
@@ -32,8 +32,8 @@ class ExampleRecipesSeeder extends Seeder
         );
 
         Plugin::updateOrCreate(
+            ['uuid' => '3b046eda-34e9-4232-b935-c33b989a284b'],
             [
-                'uuid' => '3b046eda-34e9-4232-b935-c33b989a284b',
                 'name' => 'Weather',
                 'user_id' => $user_id,
                 'data_payload' => null,
@@ -51,8 +51,8 @@ class ExampleRecipesSeeder extends Seeder
         );
 
         Plugin::updateOrCreate(
+            ['uuid' => '21464b16-5f5a-4099-a967-f5c915e3da54'],
             [
-                'uuid' => '21464b16-5f5a-4099-a967-f5c915e3da54',
                 'name' => 'Zen Quotes',
                 'user_id' => $user_id,
                 'data_payload' => null,
@@ -70,8 +70,8 @@ class ExampleRecipesSeeder extends Seeder
         );
 
         Plugin::updateOrCreate(
+            ['uuid' => '8d472959-400f-46ee-afb2-4a9f1cfd521f'],
             [
-                'uuid' => '8d472959-400f-46ee-afb2-4a9f1cfd521f',
                 'name' => 'This Day in History',
                 'user_id' => $user_id,
                 'data_payload' => null,
@@ -89,8 +89,8 @@ class ExampleRecipesSeeder extends Seeder
         );
 
         Plugin::updateOrCreate(
+            ['uuid' => '4349fdad-a273-450b-aa00-3d32f2de788d'],
             [
-                'uuid' => '4349fdad-a273-450b-aa00-3d32f2de788d',
                 'name' => 'Home Assistant',
                 'user_id' => $user_id,
                 'data_payload' => null,
@@ -108,8 +108,8 @@ class ExampleRecipesSeeder extends Seeder
         );
 
         Plugin::updateOrCreate(
+            ['uuid' => 'be5f7e1f-3ad8-4d66-93b2-36f7d6dcbd80'],
             [
-                'uuid' => 'be5f7e1f-3ad8-4d66-93b2-36f7d6dcbd80',
                 'name' => 'Sunrise/Sunset',
                 'user_id' => $user_id,
                 'data_payload' => null,
@@ -127,8 +127,8 @@ class ExampleRecipesSeeder extends Seeder
         );
 
         Plugin::updateOrCreate(
+            ['uuid' => '82d3ee14-d578-4969-bda5-2bbf825435fe'],
             [
-                'uuid' => '82d3ee14-d578-4969-bda5-2bbf825435fe',
                 'name' => 'Pollen Forecast',
                 'user_id' => $user_id,
                 'data_payload' => null,
@@ -144,5 +144,42 @@ class ExampleRecipesSeeder extends Seeder
                 'flux_icon_name' => 'flower',
             ]
         );
+
+        Plugin::updateOrCreate(
+            ['uuid' => '1d98bca4-837d-4b01-b1a1-e3b6e56eca90'],
+            [
+                'name' => 'Holidays (iCal)',
+                'user_id' => $user_id,
+                'data_payload' => null,
+                'data_stale_minutes' => 720,
+                'data_strategy' => 'polling',
+                'configuration_template' => [
+                    'custom_fields' => [
+                        [
+                            'keyname' => 'calendar',
+                            'field_type' => 'select',
+                            'name' => 'Public Holidays Calendar',
+                            'options' => [
+                                ['USA' => 'usa'],
+                                ['Austria' => 'austria'],
+                                ['Australia' => 'australia'],
+                                ['Canada' => 'canada'],
+                                ['Germany' => 'germany'],
+                                ['UK' => 'united-kingdom'],
+                            ],
+                        ],
+                    ],
+                ],
+                'configuration' => ['calendar' => 'usa'],
+                'polling_url' => 'https://www.officeholidays.com/ics-clean/{{calendar}}',
+                'polling_verb' => 'get',
+                'polling_header' => null,
+                'render_markup' => null,
+                'render_markup_view' => 'recipes.holidays-ical',
+                'detail_view_route' => null,
+                'icon_url' => null,
+                'flux_icon_name' => 'calendar',
+            ]
+        );
     }
 }

docs/DEVELOPMENT.md

@@ -1,4 +1,4 @@
-### Local Development
+## Local Development
 
 #### Requirements
 
@@ -16,14 +16,20 @@ git clone git@github.com:usetrmnl/byos_laravel.git
 
 ```bash
 cp .env.example .env
-php artisan key:generate
 ```
 
-#### Install dependencies
+#### Install dependencies and build frontend
 
 ```bash
 composer install
 npm i
+npm run build
+```
+
+#### Generate application key
+
+```bash
+php artisan key:generate
 ```
 
 #### Run migrations
@@ -32,6 +38,12 @@ npm i
 php artisan migrate --seed
 ```
 
+#### Link storage to expose public assets
+
+```bash
+php artisan storage:link
+```
+
 #### Run the server
 
 To expose the built-in server to the local network, you can run the following command:
@@ -40,7 +52,9 @@ To expose the built-in server to the local network, you can run the following co
 php artisan serve  --host=0.0.0.0 --port 4567
 ```
 
-### Docker
+---
+
+## Docker
 Use the provided Dockerfile, or docker-compose file to run the server in a container.
 
 #### .devcontainer

lang/de/custom_plugins.php

@@ -0,0 +1,7 @@
+<?php
+
+return [
+    'today' => 'heute',
+    'tomorrow' => 'morgen',
+    'yesterday' => 'gestern',
+];

package.json

@@ -6,14 +6,27 @@
         "dev": "vite"
     },
     "dependencies": {
-        "@tailwindcss/vite": "^4.0.7",
+        "@codemirror/commands": "^6.9.0",
+        "@codemirror/lang-css": "^6.3.1",
+        "@codemirror/lang-html": "^6.4.11",
+        "@codemirror/lang-javascript": "^6.2.4",
+        "@codemirror/lang-json": "^6.0.2",
+        "@codemirror/lang-liquid": "^6.3.0",
+        "@codemirror/language": "^6.11.3",
+        "@codemirror/search": "^6.5.11",
+        "@codemirror/state": "^6.5.2",
+        "@codemirror/theme-one-dark": "^6.1.3",
+        "@codemirror/view": "^6.38.5",
+        "@fsegurai/codemirror-theme-github-light": "^6.2.2",
+        "@tailwindcss/vite": "^4.1.11",
         "autoprefixer": "^10.4.20",
         "axios": "^1.8.2",
+        "codemirror": "^6.0.2",
         "concurrently": "^9.0.1",
-        "laravel-vite-plugin": "^1.0",
-        "puppeteer": "^24.3.0",
+        "laravel-vite-plugin": "^2.0",
+        "puppeteer": "24.30.0",
         "tailwindcss": "^4.0.7",
-        "vite": "^6.3"
+        "vite": "^7.0.4"
     },
     "optionalDependencies": {
         "@rollup/rollup-linux-x64-gnu": "4.9.5",

public/mirror/index.html

@@ -0,0 +1,521 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
+  <title>TRMNL BYOS Laravel Mirror</title>
+  <link rel="manifest" href="/mirror/manifest.json" />
+  <meta name="apple-mobile-web-app-capable" content="yes" />
+  <meta name="apple-mobile-web-app-status-bar-style" content="black" />
+  <link rel="apple-touch-icon" type="image/png" href="/mirror/assets/apple-touch-icon-76x76.png" sizes="76x76" />
+  <link rel="apple-touch-icon" type="image/png" href="/mirror/assets/apple-touch-icon-120x120.png" sizes="120x120" />
+  <link rel="apple-touch-icon" type="image/png" href="/mirror/assets/apple-touch-icon-152x152.png" sizes="152x152" />
+  <link rel="apple-touch-icon" type="image/png" href="/mirror/assets/apple-touch-icon-167x167.png" sizes="167x167" />
+  <link rel="apple-touch-icon" type="image/png" href="/mirror/assets/apple-touch-icon-180x180.png" sizes="180x180" />
+
+  <link rel="icon" type="image/png" href="/mirror/assets/favicon-16x16.png" sizes="16x16" />
+  <link rel="icon" type="image/png" href="/mirror/assets/favicon-32x32.png" sizes="32x32" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no" />
+  <script>
+    var trmnl = {
+      STORAGE_KEY: "byos_laravel_mirror_settings",
+      refreshTimer: null,
+      renderedAt: 0,
+      ui: {},
+
+      showStatus: function (message) {
+        trmnl.ui.img.style.display = "none";
+        trmnl.ui.errorContainer.style.display = "flex";
+        trmnl.ui.errorMessage.textContent = message;
+      },
+
+      showScreen: function (src) {
+        trmnl.ui.img.src = src;
+        trmnl.ui.img.style.display = "block";
+        trmnl.ui.errorContainer.style.display = "none";
+      },
+
+      showSetupForm: function () {
+        var data = trmnl.getSettings();
+        trmnl.ui.apiKeyInput.value = data.api_key || "";
+        trmnl.ui.baseURLInput.value = data.base_url || "";
+        trmnl.ui.macAddressInput.value = data.mac_address || "";
+        trmnl.ui.displayModeSelect.value = data.display_mode || "";
+
+        trmnl.ui.setup.style.display = "flex";
+      },
+
+      saveSetup: function (event) {
+        event.preventDefault();
+
+        var apiKey = trmnl.ui.apiKeyInput.value;
+        var baseURL = trmnl.ui.baseURLInput.value;
+        var macAddress = trmnl.ui.macAddressInput.value;
+        var displayMode = trmnl.ui.displayModeSelect.value;
+
+        if (!apiKey) {
+          return;
+        }
+
+        trmnl.saveSettings({
+          api_key: apiKey,
+          base_url: baseURL,
+          mac_address: macAddress,
+          display_mode: displayMode
+        });
+
+        trmnl.fetchDisplay();
+      },
+
+      hideSetupForm: function () {
+        trmnl.ui.setup.style.display = "none";
+      },
+
+      fetchDisplay: function (opts) {
+        opts = opts || {};
+        clearTimeout(trmnl.refreshTimer);
+
+        if (!opts.quiet) {
+          trmnl.hideSetupForm();
+          trmnl.showStatus("Loading...");
+        }
+
+        var setup = trmnl.getSettings();
+        var apiKey = setup.api_key;
+        var displayMode = setup.display_mode;
+        var baseURL = setup.base_url || "https://your-byos-trmnl.com";
+        var macAddress = setup.mac_address || "00:00:00:00:00:01";
+
+        document.body.classList.remove("dark", "night")
+        if (displayMode) {
+          document.body.classList.add(displayMode)
+        }
+
+        var headers = {
+          "Access-Token": apiKey,
+          "id": macAddress
+        };
+
+        var url = baseURL + "/api/display";
+
+        var xhr = new XMLHttpRequest();
+        xhr.open("GET", url, true);
+
+        for (var headerName in headers) {
+          if (headers.hasOwnProperty(headerName)) {
+            xhr.setRequestHeader(headerName, headers[headerName]);
+          }
+        }
+
+        xhr.onload = function () {
+          if (xhr.status >= 200 && xhr.status < 300) {
+            try {
+              var data = JSON.parse(xhr.responseText);
+              console.log("Display response:", data);
+
+              if (data.status !== 0) {
+                trmnl.showStatus(
+                  "Error: " + (data.error || data.message || data.status)
+                );
+                return;
+              }
+
+              trmnl.showScreen(data.image_url);
+              trmnl.renderedAt = new Date();
+
+              if (data.refresh_rate) {
+                var refreshRate = 30;
+                refreshRate = data.refresh_rate;
+
+                console.log("Refreshing in " + refreshRate + " seconds...");
+                trmnl.refreshTimer = setTimeout(
+                  function () { trmnl.fetchDisplay({ quiet: true }); },
+                  1000 * refreshRate
+                );
+              }
+            } catch (e) {
+              trmnl.showStatus("Error processing response: " + e.message);
+            }
+          } else {
+            trmnl.showStatus(
+              "Failed to fetch screen: " + xhr.status + " " + xhr.statusText
+            );
+          }
+        };
+
+        xhr.onerror = function () {
+          trmnl.showStatus("Network error: Failed to connect or request was blocked.");
+        };
+
+        xhr.send();
+      },
+
+      getSettings: function () {
+        try {
+          return JSON.parse(localStorage.getItem(trmnl.STORAGE_KEY)) || {};
+        } catch (e) {
+          return {};
+        }
+      },
+
+      saveSettings: function (data) {
+        var settings = trmnl.getSettings();
+
+        for (var key in data) {
+          if (data.hasOwnProperty(key)) {
+            settings[key] = data[key];
+          }
+        }
+
+        localStorage.setItem(trmnl.STORAGE_KEY, JSON.stringify(settings));
+        console.log("Settings saved:", settings);
+      },
+
+      cleanUrl: function () {
+        if (window.history && window.history.replaceState) {
+          try {
+            window.history.replaceState(
+              {},
+              document.title,
+              window.location.pathname
+            );
+          } catch (e) {
+            // iOS 9 / UIWebView: silent ignore
+          }
+        }
+      },
+
+      applySettingsFromUrl: function () {
+        var query = window.location.search.substring(1);
+        if (!query) return;
+
+        var pairs = query.split("&");
+        var newSettings = {};
+        var hasOverrides = false;
+
+        for (var i = 0; i < pairs.length; i++) {
+          var parts = pairs[i].split("=");
+          if (parts.length !== 2) continue;
+
+          var key = decodeURIComponent(parts[0]);
+          var value = decodeURIComponent(parts[1]);
+
+          if (key === "api_key" && value) {
+            newSettings.api_key = value;
+            hasOverrides = true;
+          }
+
+          if (key === "base_url" && value) {
+            newSettings.base_url = value;
+            hasOverrides = true;
+          }
+
+          if (key === "mac_address" && value) {
+            newSettings.mac_address = value;
+            hasOverrides = true;
+          }
+        }
+
+        if (hasOverrides) {
+          trmnl.saveSettings(newSettings);
+          console.log("Settings overridden from URL:", newSettings);
+        }
+      },
+
+      setDefaultBaseUrlIfMissing: function () {
+        var settings = trmnl.getSettings();
+
+        if (settings && settings.base_url) {
+          return;
+        }
+
+        var protocol = window.location.protocol;
+        var host = window.location.hostname;
+        var port = window.location.port;
+
+        var origin = protocol + "//" + host;
+        if (port) {
+          origin += ":" + port;
+        }
+
+        trmnl.saveSettings({
+          base_url: origin
+        });
+
+        console.log("Default base_url set to:", origin);
+      },
+
+      clearSettings: function () {
+        try {
+          localStorage.removeItem(trmnl.STORAGE_KEY);
+        } catch (e) {
+          // fallback ultra-safe
+          localStorage.setItem(trmnl.STORAGE_KEY, "{}");
+        }
+        console.log("Settings cleared");
+        window.location.reload();
+      },
+
+      init: function () {
+
+        // override settings from GET params
+        trmnl.applySettingsFromUrl();
+
+        trmnl.cleanUrl();
+
+        // default base_url
+        trmnl.setDefaultBaseUrlIfMissing();
+
+        // screen
+        trmnl.ui.img = document.getElementById("screen");
+        trmnl.ui.errorContainer = document.getElementById("error-container");
+        trmnl.ui.errorMessage = document.getElementById("error-message");
+
+        // settings
+        trmnl.ui.apiKeyInput = document.getElementById("api_key");
+        trmnl.ui.baseURLInput = document.getElementById("base_url");
+        trmnl.ui.macAddressInput = document.getElementById("mac_address");
+        trmnl.ui.displayModeSelect = document.getElementById("display_mode");
+        trmnl.ui.setup = document.getElementById("setup");
+
+        var settings = trmnl.getSettings();
+        if (!settings || !settings.api_key) {
+          trmnl.showSetupForm();
+        } else {
+          trmnl.fetchDisplay();
+        }
+      }
+    };
+
+    document.addEventListener("DOMContentLoaded", function () {
+      trmnl.init();
+    });
+  </script>
+  <style>
+    body {
+      overflow: hidden;
+      font-family: sans-serif;
+      margin: 0;
+      padding: 0;
+    }
+
+    a {
+      color: #f54900;
+    }
+
+    #screen-container,
+    #setup {
+      position: fixed;
+      top: 0;
+      left: 0;
+      width: 100vw;
+      height: 100vh;
+      display: flex;
+      flex-direction: column;
+      justify-content: center;
+      align-items: center;
+      overflow-y: scroll;
+    }
+
+    #setup {
+      background-color: #3d3d3e;
+    }
+
+    #setup-panel {
+      display: flex;
+      flex-direction: column;
+      align-items: center;
+      justify-content: center;
+      background-color: #ffffff;
+      padding: 2em;
+      margin: 1em;
+      border-radius: 1em;
+      box-shadow: 0 0.5em 2em rgba(0, 0, 0, 1);
+    }
+
+    #setup-panel img {
+      margin-bottom: 2em;
+    }
+
+    #screen {
+      cursor: pointer;
+      width: 100vw;
+      height: 100vh;
+      object-fit: contain;
+      background-color: #000000;
+      z-index: 1;
+    }
+
+    body.dark #screen,
+    body.night #screen {
+      filter: invert(1) hue-rotate(180deg);
+      background-color: #ffffff;
+    }
+
+    #red-overlay {
+      background-color: #ff0000;
+      mix-blend-mode: darken;
+      display: none;
+    }
+
+    body.night #red-overlay {
+      display: block;
+      position: absolute;
+      top: 0;
+      left: 0;
+      width: 100vw;
+      height: 100vh;
+      z-index: 1000;
+      pointer-events: none;
+    }
+
+    #error-container {
+      display: flex;
+      flex-direction: column;
+      align-items: center;
+      justify-content: center;
+      text-align: center;
+    }
+
+    .dark #error-container,
+    .dark #screen-container,
+    .night #error-container,
+    .night #screen-container {
+      background-color: #000000;
+      color: #ffffff;
+    }
+
+    #error-message {
+      font-size: 1.5em;
+      margin-bottom: 1em;
+    }
+
+    #setup {
+      z-index: 2;
+    }
+
+    .form-control {
+      font-size: 1.25em;
+      width: 14em;
+      padding: 0.5em;
+      border: 1px solid #ccc;
+      border-radius: 0.5em;
+      display: block;
+    }
+
+    label,
+    summary {
+      font-size: 1.25em;
+      margin-bottom: 0.5em;
+      cursor: pointer;
+    }
+
+    label {
+      display: block;
+    }
+
+    fieldset {
+      border: none;
+      margin: 0;
+      padding: 0;
+      margin-bottom: 2em;
+    }
+
+    .btn {
+      font-size: 1.25em;
+      padding: 0.5em 1em;
+      background-color: #f54900;
+      color: white;
+      border: none;
+      border-radius: 0.5em;
+      cursor: pointer;
+      display: block;
+      width: 100%;
+    }
+
+    .btn-clear {
+      margin-top: 1em;
+      background-color: #777;
+    }
+
+    #error-container .btn {
+      margin-left: 0.5em;
+      margin-right: 0.5em;
+    }
+
+    .night #error-container .btn {
+      color: #000000;
+    }
+
+    select {
+      display: block;
+      width: 100%;
+      font-size: 1.25em;
+      padding: 0.5em;
+      border: 1px solid #ccc;
+      border-radius: 0.5em;
+      background-color: #ffffff;
+    }
+
+    #unsupported {
+      color: red;
+    }
+  </style>
+</head>
+
+<body>
+  <div id="setup" style="display: none;">
+    <div id="setup-panel">
+      <img src="/mirror/assets/logo--brand.svg" alt="TRMNL Logo" />
+
+      <form onsubmit="return trmnl.saveSetup(event)">
+        <fieldset>
+          <label for="mac_address">Device MAC Address</label>
+          <input name="mac_address" id="mac_address" type="text" placeholder="00:00:00:00:00:01" class="form-control"
+            required />
+        </fieldset>
+
+        <fieldset>
+          <label for="api_key">Device API Key</label>
+          <input name="api_key" id="api_key" type="text" placeholder="API Key" class="form-control" required />
+        </fieldset>
+
+        <fieldset>
+          <select id="display_mode" name="display_mode">
+            <option value="" selected="selected">Light Mode</option>
+            <option value="dark">Dark Mode</option>
+            <option value="night">Night Mode</option>
+          </select>
+        </fieldset>
+
+        <fieldset>
+          <label for="base_url">Custom Server URL</label>
+          <input name="base_url" id="base_url" type="text" placeholder="https://your-byos-trmnl.com"
+            class="form-control" value="" />
+        </fieldset>
+
+        <button class="btn">Save</button>
+
+        <button class="btn btn-clear" type="button" onclick="trmnl.clearSettings()">
+          Clear settings
+        </button>
+
+      </form>
+    </div>
+  </div>
+
+  <div id="screen-container">
+    <div id="red-overlay"></div>
+    <img id="screen" onclick="trmnl.showSetupForm()" style="display: none;">
+
+    <div id="error-container" style="display: none">
+      <div id="error-message"></div>
+      <div style="display: flex; margin-top: 1em">
+        <button class="btn" onclick="trmnl.showSetupForm()">Setup</button>
+        <button class="btn" onclick="trmnl.fetchDisplay()">Retry</button>
+      </div>
+    </div>
+  </div>
+</body>
+
+</html>

public/mirror/manifest.json

@@ -0,0 +1,7 @@
+{
+  "name": "TRMNL BYOS Laravel Mirror",
+  "short_name": "TRMNL BYOS",
+  "display": "standalone",
+  "background_color": "#ffffff",
+  "theme_color": "#ffffff"
+}

rector.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+use Rector\Config\RectorConfig;
+use Rector\Set\ValueObject\LevelSetList;
+use Rector\Set\ValueObject\SetList;
+
+return static function (RectorConfig $rectorConfig): void {
+    $rectorConfig->paths([
+        __DIR__.'/app',
+        __DIR__.'/tests',
+    ]);
+
+    $rectorConfig->sets([
+        LevelSetList::UP_TO_PHP_82,
+        SetList::CODE_QUALITY,
+        SetList::DEAD_CODE,
+        SetList::EARLY_RETURN,
+        SetList::TYPE_DECLARATION,
+    ]);
+
+    $rectorConfig->skip([
+        // Skip any specific rules if needed
+    ]);
+};

resources/css/app.css

@@ -59,6 +59,10 @@
     @apply !mb-0 !leading-tight;
 }
 
+[data-flux-description] a {
+    @apply text-accent underline hover:opacity-80;
+}
+
 input:focus[data-flux-control],
 textarea:focus[data-flux-control],
 select:focus[data-flux-control] {
@@ -68,3 +72,39 @@ select:focus[data-flux-control] {
 /* \[:where(&)\]:size-4 {
     @apply size-4;
 } */
+
+@layer components {
+    /* standard container for app */
+    .styled-container,
+    .tab-button {
+        @apply rounded-xl border bg-white dark:bg-stone-950 dark:border-zinc-700 text-stone-800 shadow-xs;
+    }
+
+    .tab-button {
+        @apply flex items-center gap-2 px-4 py-2 text-sm font-medium;
+        @apply rounded-b-none shadow-none bg-inherit;
+
+        /* This makes the button sit slightly over the box border */
+        margin-bottom: -1px;
+        position: relative;
+        z-index: 1;
+    }
+
+    .tab-button.is-active {
+        @apply text-zinc-700 dark:text-zinc-300;
+        @apply border-b-white dark:border-b-zinc-800;
+
+        /* Z-index 10 ensures the bottom border of the tab hides the top border of the box */
+        z-index: 10;
+    }
+
+    .tab-button:not(.is-active) {
+        @apply text-zinc-500 border-transparent;
+    }
+
+    .tab-button:not(.is-active):hover {
+        @apply text-zinc-700 dark:text-zinc-300;
+        @apply border-zinc-300 dark:border-zinc-700;
+        cursor: pointer;
+    }
+}