feat: Release v3.0.0 — Native App Linking, Deep Linking, Pixels Registry, and Custom Expiry Pages

CONTRIBUTING.md

@@ -0,0 +1,30 @@
+# Contributing to Filament Short URL
+
+Thank you for considering contributing to the Filament Short URL plugin!
+
+## Development Setup
+
+If you are modifying the plugin source code and need to recompile its stylesheet after changing Blade, PHP, or configuration files, follow these steps:
+
+### 1. Recompile Plugin CSS (Tailwind CSS v4)
+Run the Tailwind CSS CLI from the root folder of your host application to scan the plugin's views and compile the final stylesheet:
+
+```bash
+npx @tailwindcss/cli -i ./packages/filament-short-url/resources/css/plugin.css \
+    -o ./packages/filament-short-url/resources/dist/filament-short-url.css --minify
+```
+
+### 2. Re-publish compiled assets
+After compiling, publish the updated CSS stylesheet to the public folder of your host application so the browser can load it:
+
+```bash
+php artisan filament:assets
+```
+
+## Running Tests
+
+We enforce test coverage for all features. To run the tests from the root of your host application:
+
+```bash
+php artisan test --filter=ShortUrl
+```

README.md

@@ -13,7 +13,16 @@
     <a href="https://github.com/janczakb/filament-short-url/actions"><img src="https://img.shields.io/badge/tests-passing-success.svg?style=flat-square" alt="Tests"></a>
 </p>
 
-A professional, high-performance **Short URL Manager** plugin for [Filament v5](https://filamentphp.com). Built from scratch with cutting-edge practices, proxy resistance, offline Geo-IP engines, enterprise-grade smart targeting, and zero external shortening API dependencies.
+A professional, high-performance **Short URL Manager, Redirect Engine & QR Code Generator** plugin for [Filament v5](https://filamentphp.com). 
+
+Acting as a self-hosted, enterprise-grade alternative to Bitly and Rebrandly, this package provides advanced link shortening, mobile app deep linking (Universal Links & Android App Links), client-side retargeting pixels, offline Geo-IP country routing, real-time analytics, and webhooks—with zero external API dependencies.
+
+### Why choose Filament Short URL?
+* **Save on SaaS Costs**: Replace expensive Bitly or Rebrandly subscriptions with a self-hosted solution that has zero click or creation limits.
+* **Server-Side GA4 Tracking**: Bypasses browser-side ad blockers completely to ensure 100% accurate traffic data.
+* **Retarget on External Sites**: Inject tracking pixels (Meta, Google Ads, LinkedIn, TikTok, Pinterest) on a beautiful glassmorphic redirect page before forwarding visitors.
+* **Seamless Mobile App Redirects**: Launch native mobile applications (Instagram, YouTube, Spotify, WhatsApp) automatically using deep links.
+* **GDPR-Friendly Geo-IP**: Resolve visitor countries offline using local MaxMind databases or trust your CDN headers (Cloudflare, CloudFront).
 
 ## Screenshots
 
@@ -37,30 +46,33 @@ A professional, high-performance **Short URL Manager** plugin for [Filament v5](
 
 ## Features
 
-- 🔗 **Short URL Generation** — Create custom links or let the system auto-generate collision-free Base62 keys.
-- 🌍 **Multiple Geo-IP Drivers** — High-speed offline detection using local MaxMind databases, edge-provided CDN headers (Cloudflare, CloudFront, generic), or fallback API integration.
-- 🗺️ **Visitor World Map Widget** — Interactive SVG world map on the link statistics dashboard showcasing the geographical distribution of visitor clicks with hover details.
-- 📈 **Real-Time Statistics Dashboard** — Track visits in real-time with cached aggregate metrics (countries, devices, browsers, operating systems, referrers, traffic charts, and maps).
-- 🛡️ **VPN, Proxy & Bot Filtering** — Exclude VPNs, proxies, Tor exit nodes, and automated bot clicks from your analytics to keep visitor statistics accurate.
-- 🔍 **Google Safe Browsing Integration** — Automatically verify target URLs on creation/edit to block malicious, phishing, malware, or social engineering links.
-- 🎨 **SVG QR Code Designer & Custom Logo Overlay** *(new in v2.0)* — Built-in interactive design canvas to customize dot styles, margins, gradient coloring, and background transparency. Upload custom brand logos with shape configuration (square/circle), margins, sizes, and auto-clear overlapping dots, with instant SVG/PNG download.
-- 📊 **Dedicated QR Code Scan Tracking** *(new in v2.0)* — Separates direct visits from QR code scans in analytics. Dynamically appends tracking tags and showcases QR scans in its own badge within tables.
-- 🌐 **Browser Language Analytics** *(new in v2.0)* — Detects client browser preferred language settings to showcase a "Top Languages" analytics breakdown in the link statistics dashboard.
-- ⚡ **Ultra-Fast Redirects** — Redirections resolve in milliseconds. Analytical tasks, event dispatching, and GA4 payloads are processed asynchronously via Laravel Queue jobs.
-- 🎯 **Google Analytics 4 server-side tracking** — Native integration with the GA4 Measurement Protocol to bypass client-side AdBlockers completely.
-- ⚙️ **Dual-way UTM Campaign Builder** — Built-in form builder synchronizes UTM parameters with your destination URLs in real-time (two-way binding).
-- 🔒 **Link Validity Ranges & Expiry** — Set activation date ranges (From - To), custom visit limit counters (e.g. active for 3 clicks then expires), single-use restrictions, and custom fallback redirect URLs on expiration instead of static 410 Gone errors.
-- ➡️ **Query Parameter Forwarding** — Dynamically forward client query parameters (e.g. ad tokens, discount codes) to the destination URL.
-- 🛠️ **Dedicated Settings GUI** — Manage global configuration (routing, Geo-IP, GA4, cache, rate limiting, aggregation) directly inside the Filament panel without modifying files or `.env` files.
-- 💻 **Fluent Developer Builder** — Native model query builder pattern and robust programmatic generation APIs.
-- 🔑 **Password-Protected Links** — Require a password before redirecting visitors, with session-based unlock.
-- ⚠️ **Redirect Warning Pages** — Show an interstitial security page before redirecting to external URLs (phishing/NSFW protection).
-- 🎯 **Smart Link Targeting** — Route visitors to different destination URLs based on their device type, country, or via weighted A/B split rotation.
-- 🛡️ **Rate Limiting / Bot Protection** — Configurable per-IP rate limits on redirects with automatic `429 Too Many Requests` responses.
-- 📊 **Daily Stats Aggregation & Pruning** — Automatic daily summarization of raw visit logs into compact daily stats tables. Configurable retention window prevents unbounded database growth at scale.
-- 🎯 **Social Retargeting Pixels** *(new in v1.5)* — Inject Meta Pixel, Google Tag, and LinkedIn Insight tracking scripts client-side via a premium glassmorphic interstitial page. Build remarketing audiences even when redirecting to external domains.
-- 🔌 **Developer REST API** *(new in v1.5)* — Full REST API (`GET`, `POST`, `DELETE`) for external integrations. Secured with API Key authentication managed via the Settings panel.
-- 📡 **Webhooks** *(new in v1.5)* — Real-time HTTP POST event notifications on every click, link creation, or expiration. Configure per-link or globally, dispatched asynchronously via the queue.
+- 🔗 **Base62 Short Link Generation** — Create clean, custom short links or let the system auto-generate collision-free Base62 keys.
+- 🌍 **Multiple Geo-IP Drivers** — Route and analyze traffic with offline MaxMind detection, CDN edge headers (Cloudflare's `CF-IPCountry`, CloudFront), or fallback APIs.
+- 🗺️ **Interactive Visitor World Map** — Showcase geographic click distribution on a beautiful SVG world map widget with real-time hover details.
+- 📈 **Comprehensive Analytics Dashboard** — Monitor total/unique visits, referrers, operating systems, devices, browsers, and top browser languages in real-time.
+- 🛡️ **VPN, Proxy & Bot Filtering** — Exclude scrapers, crawlers, Tor exit nodes, and automated bot clicks to keep your analytics clean and accurate.
+- 🔍 **Google Safe Browsing** — Automatically scan target URLs on creation/edit to block phishing, malware, and social engineering links.
+- 🎨 **SVG QR Code Designer** — Customize dot styles, gradients, margins, and upload custom brand logos with auto-clear backing dots and high-quality SVG/PNG exports.
+- 📊 **Dedicated QR Code Tracking** — Differentiate physical QR scans from direct web clicks with automatically appended query parameters (`?source=qr`).
+- 🌐 **Browser Language Targeting** — Route visitors dynamically based on their browser language preferences (e.g., redirect Polish speakers to a Polish landing page).
+- ⚡ **Ultra-Fast Redirections** — Redirections resolve in milliseconds. Logging, GA4 payloads, and webhooks are processed asynchronously in the background.
+- 🎯 **Server-Side GA4 Integration** — Send server-side `short_url_visit` hits using the Google Analytics 4 Measurement Protocol to bypass ad-blockers.
+- ⚙️ **Dual-way UTM Builder** — Build campaign URLs with a real-time synchronized UTM builder directly in the link creation form.
+- 🔒 **Link Expiration & Fallbacks** — Set activation date ranges, click-limit caps, single-use restrictions, and custom redirection fallbacks on expiration.
+- ➡️ **Query Parameter Forwarding** — Automatically forward client query strings (e.g., ad tokens, UTM parameters, discount codes) to the destination.
+- 🛠️ **Central Settings Panel** — Manage routes, Geo-IP, GA4, caching, rate limiting, and retention directly inside your Filament panel.
+- 🔑 **Password-Protected Links** — Secure sensitive links with a customizable, session-based password entry interstitial.
+- ⚠️ **Redirect Warning Interstitials** — Show a security warning page to verify external links (phishing and NSFW protection).
+- 🎯 **Advanced Smart Targeting** — Redirect visitors dynamically based on device type (iOS, Android, Desktop), country (Geo-IP), or browser language.
+- ⚖️ **A/B Split Testing Rotation** — Distribute traffic randomly across multiple landing pages using custom weighted rotation rules.
+- 🛡️ **Throttling & Rate Limiting** — Protect your redirection routes from flood attacks with configurable per-IP rate limits.
+- 📊 **Log Aggregation & Pruning** — Compact millions of raw visit logs into daily summaries automatically to prevent database bloat.
+- 🎯 **Central Retargeting Pixel Registry (new in v3.0.0)** — Register Meta Pixel, Google Tag, LinkedIn Insight, TikTok Pixel, and Pinterest Tag centrally and associate them with links via checkboxes.
+- 🔌 **Developer REST API** — Full programmatical control with secure API Key authentication to create, list, and delete short links externally.
+- 📡 **Real-Time Webhooks** — Asynchronous HTTP POST notifications on `visited`, `created`, `expired`, and `limit_reached` events with a built-in retry policy.
+- 📱 **Mobile App Deep Linking (new in v3.0.0)** — Detect mobile visitors and open links directly in 24+ native apps (Instagram, YouTube, Spotify, TikTok, etc.) using custom URI schemes.
+- 🔗 **Universal Links & App Links (new in v3.0.0)** — Host iOS `apple-app-site-association` and Android `assetlinks.json` domain configuration files directly from your root domain.
+- 🎨 **Branded Expiry Pages (new in v3.0.0)** — Display a premium, dark-mode compatible custom expiry page when a link is deactivated or limit-reached, falling back to a clean site-name greeting instead of a generic browser error.
 
 ---
 
@@ -122,6 +134,13 @@ php artisan filament:assets
 That's all. The plugin's CSS will be served from `public/css/janczakb/filament-short-url/filament-short-url.css` and Filament registers it automatically.
 
 > **You do not need to run Tailwind, Vite, or npm for the plugin styles.** The compiled file is included in the package.
+> 
+> **Using a Custom Filament Theme (Tailwind CSS v4)?**
+> If you are compiling your own Filament panel theme stylesheet, you can optionally tell Tailwind to scan the plugin's views by adding the `@source` directive to your theme's CSS file (e.g., `resources/css/filament/admin/theme.css`):
+> 
+> ```css
+> @source './vendor/janczakb/filament-short-url/resources/views/**/*.blade.php';
+> ```
 
 **Tip — automate on every `composer install` / `composer update`:**
 
@@ -139,21 +158,6 @@ Add `filament:assets` to the `post-autoload-dump` scripts in your application's
 
 ---
 
-> #### 🛠 For Plugin Developers Only
->
-> If you are modifying the plugin source and need to recompile its stylesheet after changing Blade/PHP files:
->
-> ```bash
-> # 1. Recompile the plugin CSS with Tailwind v4
-> npx @tailwindcss/cli -i ./packages/filament-short-url/resources/css/plugin.css \
->     -o ./packages/filament-short-url/resources/dist/filament-short-url.css --minify
->
-> # 2. Re-publish the compiled asset to public/
-> php artisan filament:assets
-> ```
-
----
-
 ## Setup
 
 Register the plugin in your Filament Panel Provider (`app/Providers/Filament/AdminPanelProvider.php`):
@@ -236,7 +240,7 @@ protected $policies = [
 
 ## Global Settings GUI
 
-The package comes with a built-in admin settings dashboard. You can access it by clicking the **Settings** action button on the top-right header of the Short URLs resource.
+The package comes with a built-in admin settings dashboard. It is accessible directly from your sidebar menu under the same navigation group as your links.
 
 Settings are stored dynamically in `storage/app/filament-short-url-settings.json` and immediately override config defaults.
 
@@ -318,6 +322,18 @@ This feature is useful for NSFW links, external partner links, or any URL that l
 
 ---
 
+## Custom Branded Expiry Pages (new in v3.0.0)
+
+When a short URL is expired, deactivated, or has reached its maximum visit limit, it needs to handle the redirect gracefully:
+* **Custom Fallback URL**: If configured, visitors are immediately redirected to the `expiration_redirect_url` target.
+* **Branded Expiry Page (Default)**: If no fallback URL is specified, the system displays a premium branded, fully localized, dark-mode compatible HTML page (`expired.blade.php`) instead of a generic browser `410 Gone` error.
+  - Automatically displays your customized **Site Name** (and host application logo if the `setting('logo_path')` helper is defined).
+  - Displays a clean visual alert state with details about the expired link.
+  - Features a friendly back button pointing to your website's homepage.
+  - Can be easily customized by publishing package views: `php artisan vendor:publish --tag=filament-short-url-views`.
+
+---
+
 ## Smart Link Targeting (new in v1.2.0)
 
 The **Targeting & Security** tab exposes a powerful rule engine that lets you route different visitors to different destinations — all from a single short URL.
@@ -398,6 +414,78 @@ $shortUrl->update([
 
 ---
 
+## Native App Linking & Deep Linking (new in v3.0.0)
+
+This package supports two distinct levels of mobile app integration: **Per-Link App Linking** (client-side redirects using custom schemes) and **Global Deep Linking Files** (domain association files for OS-level native integration).
+
+### 1. Per-Link App Linking (Mobile Auto-Open)
+
+When creating or editing a short URL, the **App Linking** tab allows you to configure automatic redirects into native mobile applications.
+
+* **How it works**: If a destination URL matches one of the 24+ pre-configured native applications (such as YouTube, TikTok, Instagram, Facebook, Spotify, WhatsApp, Messenger, etc.), the plugin can bypass standard web views for mobile visitors. 
+* **The Interstitial Experience**: If **Auto open app on mobile** is enabled, mobile visitors are shown a premium glassmorphic redirect interstitial page that triggers the corresponding custom URL scheme (e.g. `whatsapp://`, `instagram://`, `youtube://`) to launch the native app directly, with fallback options to open in a web browser.
+* **Interactive Panel Preview**: Inside the Filament resource edit form, a live preview widget demonstrates if the URL was matched, showing:
+  - The matched app with its official favicon.
+  - The calculated deep link scheme.
+  - An interactive grid showing all supported native applications.
+
+Supported apps include: YouTube, TikTok, Instagram, X (Twitter), Spotify, Facebook, Reddit, Snapchat, WhatsApp, LinkedIn, Pinterest, Twitch, Netflix, Google Docs/Sheets/Slides/Maps, Messenger, Apple Music, Airbnb, TripAdvisor, Amazon, StockX, Booking, AliExpress.
+
+---
+
+### 2. Global Deep Linking Files (Universal Links & App Links)
+
+To support seamless OS-level integrations without browser intermediaries—such as iOS Universal Links and Android App Links—you can serve domain association files directly from your application's root domain.
+
+> [!IMPORTANT]
+> **Disabled by default**: This feature is turned **off** by default. You can enable it and customize the association JSON in your settings panel.
+
+#### Enabling and Configuration
+1. Open the **Settings** panel from your Filament sidebar.
+2. Navigate to the **Deep Linking** tab.
+3. Toggle **Enable Deep Linking Files** to ON.
+4. Fill in your configurations:
+   * **apple-app-site-association (iOS)**: The JSON configuration representing your iOS application IDs and supported paths (e.g., `/s/*`). This will be served at `/.well-known/apple-app-site-association` and `/apple-app-site-association` with the `application/json` content-type header.
+   * **assetlinks.json (Android)**: The Digital Asset Links JSON array representing your Android application package names and SHA-256 certificate fingerprints. This will be served at `/.well-known/assetlinks.json`.
+
+#### Example Configurations
+##### iOS AASA Example:
+```json
+{
+    "applinks": {
+        "apps": [],
+        "details": [
+            {
+                "appID": "YOUR_TEAM_ID.com.yourcompany.app",
+                "paths": [
+                    "/s/*"
+                ]
+            }
+        ]
+    }
+}
+```
+
+##### Android AssetLinks Example:
+```json
+[
+    {
+        "relation": [
+            "delegate_permission/common.handle_all_urls"
+        ],
+        "target": {
+            "namespace": "android_app",
+            "package_name": "com.yourcompany.app",
+            "sha256_cert_fingerprints": [
+                "14:6D:E9:57:3E:28:B6:58:91:..."
+            ]
+        }
+    }
+]
+```
+
+---
+
 ## High-Traffic Optimizations (new in v1.2.0)
 
 ### Daily Stats Aggregation
@@ -447,13 +535,13 @@ When Redis is not available and counter buffering is enabled, the `IncrementVisi
 
 ---
 
-## Social Retargeting Pixels & Central Pixel Registry (new in v2.1.0)
+## Social Retargeting Pixels & Central Pixel Registry (new in v3.0.0)
 
 Instead of manually copy-pasting tracking pixel IDs (Meta, Google Tag, LinkedIn, TikTok, Pinterest) every time you create a new link, the package features a centralized **Retargeting Pixel Registry** with a Many-to-Many relationship. You define your marketing pixels once in the new **Pixel Registry** resource, and then easily select them via checkbox/list options when creating or editing short links.
 
 ### The Interstitial Experience
 - **Premium Design**: Built using the exact same modern glassmorphic look as the password protection and warning interstitial pages. Supports dark mode automatically.
-- **Brand Customization**: Automatically renders the application logo and the **Site Name Override** (configured globally in Settings, falling back to `config('app.name')`) to ensure the transition page looks professional and trust-instilling.
+- **Brand Customization**: Automatically renders the application logo (if defined via the `setting('logo_path')` helper) and the **Site Name Override** (configured globally in Settings, falling back to `config('app.name')`) to ensure the transition page looks professional and trust-instilling.
 - **Micro-Animations & Smooth Redirect**: Displays a sleek animated loading spinner and a progress bar that smoothly fills from 0% to 100% in ~220-250ms. This short delay ensures browser execution time for the tracking scripts before performing a seamless `window.location.replace()` to the destination URL.
 
 This unlocks remarketing to people who clicked your links **even when redirecting to external domains** (e.g. booking.com, amazon.com) where you cannot install your own tracking code.
@@ -891,10 +979,15 @@ All migrations are compatible with **SQLite**, **MySQL**, and **PostgreSQL**:
 
 ## Changelog
 
-### v2.1.0
+### v3.0.0
+- **Native App Linking (Mobile Auto-Open)** — Automatically match and redirect mobile visitors directly inside 24+ native mobile apps (such as WhatsApp, YouTube, TikTok, Instagram, Spotify, etc.) using custom schemes, complete with a glassmorphic redirect page and a live interactive matching preview widget.
+- **Global Deep Linking (Universal Links & App Links)** — Easily serve iOS `apple-app-site-association` and Android `.well-known/assetlinks.json` configuration files directly from your root domain to support OS-level native integration (disabled by default, managed via Settings).
 - **Central Retargeting Pixel Registry** — Introduced a premium Many-to-Many pixel management registry. Define pixels centrally (Meta Pixel, Google Tag, LinkedIn Insight, TikTok Pixel, Pinterest Tag) and easily associate them with short links via the Filament panel or the REST API.
+- **Standalone Settings Page** — Relocated the Settings interface from a resource header sub-action to a standalone sidebar navigation page under the default plugin group.
 - **Backward-Compatible REST API** — The API now exposes the `pixels` relationship list, while fully retaining backward-compatible support for legacy single-pixel parameters (`pixel_meta_id`, `pixel_google_id`, `pixel_linkedin_id`).
 - **Enhanced Browser Language Redirection** — Robust double-pass language targeting logic matching exact locales first (e.g. `en-US`, `zh-CN`) and falling back to base language codes (e.g. `en`, `zh`).
+- **Full Localization & WhatsApp Favicon Fix** — Added friendly translation strings in English and Polish across the entire app-linking preview and redirect interfaces, and adjusted domains order to restore the WhatsApp favicon.
+- **Custom Branded Expiry Pages** — Replaced raw 410 HTTP errors with a beautiful, fully localized, dark-mode compatible HTML expiry page displaying the Site Name, expired link details, and a homepage button.
 
 ### v2.0.0
 - **Interactive QR Code Designer Branding Logo** — Upload custom brand logos inside the QR designer canvas in Filament. Configure logo sizing, margins, shapes (square/circle), and toggle dot backing removal to prevent dots overlapping with the logo.

config/filament-short-url.php

@@ -217,4 +217,47 @@ return [
         'throttle:120,1',
     ],
 
+    /*
+    |--------------------------------------------------------------------------
+    | Deep Linking v2.1
+    |--------------------------------------------------------------------------
+    | Universal Links (iOS) and App Links (Android) configuration.
+    |
+    */
+    'deep_linking' => [
+        'enabled' => env('SHORT_URL_DEEP_LINKING_ENABLED', false),
+        'aasa_json' => env('SHORT_URL_AASA_JSON', <<<'JSON'
+{
+    "applinks": {
+        "apps": [],
+        "details": [
+            {
+                "appID": "YOUR_TEAM_ID.com.yourcompany.app",
+                "paths": [
+                    "/s/*"
+                ]
+            }
+        ]
+    }
+}
+JSON),
+        'assetlinks_json' => env('SHORT_URL_ASSETLINKS_JSON', <<<'JSON'
+[
+    {
+        "relation": [
+            "delegate_permission/common.handle_all_urls"
+        ],
+        "target": {
+            "namespace": "android_app",
+            "package_name": "com.yourcompany.app",
+            "sha256_cert_fingerprints": [
+                "14:6D:E9:..."
+            ]
+        }
+    }
+]
+JSON),
+    ],
+
 ];
+

database/migrations/2026_06_03_160000_add_auto_open_app_mobile_to_short_urls_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('short_urls', function (Blueprint $table) {
+            $table->boolean('auto_open_app_mobile')->default(false)->after('forward_query_params');
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('short_urls', function (Blueprint $table) {
+            $table->dropColumn('auto_open_app_mobile');
+        });
+    }
+};

resources/lang/en/default.php

@@ -9,6 +9,16 @@ return [
     'tab_link' => 'Link Details',
     'tab_tracking' => 'Tracking Settings',
     'tab_qr_design' => 'QR Code Design',
+    'tab_app_linking' => 'App Linking',
+
+    // App Linking
+    'form_section_app_linking' => 'App Linking / Deep Links',
+    'auto_open_app_mobile' => 'Auto open app on mobile',
+    'auto_open_app_mobile_helper' => 'Enable this if you want your link to automatically open as an app when accessed on mobile.',
+    'supported_operating_systems' => 'Supported Operating Systems',
+    'supported_apps' => 'Supported Apps',
+    'supported_apps_helper' => 'If you do not find your app here, you can use the Targeting feature to redirect the user to your app with your custom deep link.',
+    'matched' => 'Matched',
 
     // Link Form Fields
     'destination_url' => 'Destination URL',
@@ -466,4 +476,39 @@ return [
     'pixel_type' => 'Provider',
     'pixel_id_label' => 'Pixel ID / Tag ID',
     'pixel_status_active' => 'Active',
+    'settings_tab_deep_linking' => 'Deep Linking',
+    'settings_section_deep_linking' => 'Universal Links & App Links Association Files',
+    'settings_deep_linking_enabled' => 'Enable Deep Linking Files',
+    'settings_deep_linking_enabled_helper' => 'When enabled, the plugin serves AASA and AssetLinks configuration files from your root domain.',
+    'settings_aasa_json' => 'apple-app-site-association (iOS)',
+    'settings_aasa_json_helper' => 'Specify the valid JSON configuration for Apple App Site Association. Do not include wrapping script tags.',
+    'settings_assetlinks_json' => 'assetlinks.json (Android)',
+    'settings_assetlinks_json_helper' => 'Specify the valid JSON array configuration for Android Digital Asset Links.',
+    'validation_invalid_json' => 'The entered text is not a valid JSON string.',
+
+    // App Linking Preview
+    'app_linking_supported_os' => 'Supported Operating Systems:',
+    'app_linking_supported_apps' => 'Supported Apps',
+    'app_linking_supported_apps_helper' => 'If you do not find your app here, you can use the Targeting feature to redirect the user to your app with your custom deep link.',
+    'app_linking_matched' => 'Matched',
+    'app_linking_preconfigured_count' => ':count apps pre-configured for automatic redirection.',
+    'app_linking_redirect_active' => 'Opens directly inside :app',
+    'app_linking_auto_open' => 'Auto-Open',
+    'app_linking_matched_description' => 'When clicked on a mobile device, this link will open immediately inside the native <strong>:app</strong> application instead of the web browser.',
+    'app_linking_deep_link_scheme' => 'Mobile app path (Deep Link): :scheme',
+    'app_linking_standard_redirect' => 'This link will open in a standard mobile browser (no matching mobile app found).',
+
+    // App Redirect Page
+    'app_redirect_title' => 'Opening App...',
+    'app_redirect_opening_in' => 'Opening in :app',
+    'app_redirect_waiting_text' => 'We are redirecting you to the native application. Please wait a moment...',
+    'app_redirect_btn_open' => 'Open Native App',
+    'app_redirect_btn_browser' => 'Open in Browser',
+    'app_redirect_in_app_warning_title' => 'In-App Browser Detected',
+    'app_redirect_in_app_warning_desc' => 'Redirections can be restricted inside Instagram or Facebook. Tap the three dots (•••) in the top-right corner and select "Open in Safari" or "Open in Chrome" to launch the app.',
+
+    // Link Expired Page
+    'expired_title' => 'Link Inactive or Expired',
+    'expired_description' => 'This link is no longer active. It may have reached its click limit, expiration date, or has been deactivated.',
+    'expired_btn_home' => 'Go to Homepage',
 ];

resources/lang/pl/default.php

@@ -9,6 +9,12 @@ return [
     'tab_link' => 'Szczegóły linku',
     'tab_tracking' => 'Ustawienia śledzenia',
     'tab_qr_design' => 'Wygląd kodu QR',
+    'tab_app_linking' => 'Autootwieranie aplikacji',
+
+    // App Linking
+    'form_section_app_linking' => 'Autootwieranie aplikacji / Głębokie linkowanie',
+    'auto_open_app_mobile' => 'Automatycznie otwieraj aplikację na urządzeniach mobilnych',
+    'auto_open_app_mobile_helper' => 'Włącz tę opcję, jeśli chcesz, aby po kliknięciu linku na telefonie automatycznie otwierała się dedykowana aplikacja mobilna zamiast przeglądarki.',
 
     // Link Form Fields
     'destination_url' => 'Docelowy URL',
@@ -467,4 +473,39 @@ return [
     'pixel_type' => 'Dostawca',
     'pixel_id_label' => 'ID Piksela / Tagu',
     'pixel_status_active' => 'Aktywny',
+    'settings_tab_deep_linking' => 'Głębokie linkowanie',
+    'settings_section_deep_linking' => 'Pliki powiązań Universal Links & App Links',
+    'settings_deep_linking_enabled' => 'Włącz serwowanie plików powiązań',
+    'settings_deep_linking_enabled_helper' => 'Po włączeniu wtyczka będzie serwować pliki konfiguracyjne AASA (iOS) oraz AssetLinks (Android) z poziomu domeny głównej.',
+    'settings_aasa_json' => 'apple-app-site-association (iOS)',
+    'settings_aasa_json_helper' => 'Wprowadź prawidłowy kod JSON dla Apple App Site Association. Nie dołączaj znaczników HTML/JavaScript.',
+    'settings_assetlinks_json' => 'assetlinks.json (Android)',
+    'settings_assetlinks_json_helper' => 'Wprowadź prawidłową tablicę JSON dla Android Digital Asset Links.',
+    'validation_invalid_json' => 'Wprowadzony tekst nie jest poprawnym ciągiem JSON.',
+
+    // App Linking Preview
+    'app_linking_supported_os' => 'Wspierane systemy operacyjne:',
+    'app_linking_supported_apps' => 'Wspierane aplikacje',
+    'app_linking_supported_apps_helper' => 'Jeśli nie znajdziesz swojej aplikacji na liście, możesz użyć funkcji Targetowania, aby przekierować użytkownika za pomocą własnego głębokiego linku (Deep Link).',
+    'app_linking_matched' => 'Dopasowano',
+    'app_linking_preconfigured_count' => ':count gotowych aplikacji do automatycznego przekierowania.',
+    'app_linking_redirect_active' => 'Otwiera się bezpośrednio w :app',
+    'app_linking_auto_open' => 'Autootwieranie',
+    'app_linking_matched_description' => 'Po kliknięciu na telefonie lub tablecie, ten link otworzy się od razu w dedykowanej aplikacji <strong>:app</strong> zamiast w zwykłej przeglądarce.',
+    'app_linking_deep_link_scheme' => 'Używany schemat (Deep Link): :scheme',
+    'app_linking_standard_redirect' => 'Ten link otworzy się w zwykłej przeglądarce internetowej (brak dopasowanej aplikacji mobilnej).',
+
+    // App Redirect Page
+    'app_redirect_title' => 'Otwieranie aplikacji...',
+    'app_redirect_opening_in' => 'Otwieranie w: :app',
+    'app_redirect_waiting_text' => 'Przekierowujemy Cię do natywnej aplikacji. Proszę czekać...',
+    'app_redirect_btn_open' => 'Otwórz aplikację',
+    'app_redirect_btn_browser' => 'Otwórz w przeglądarce',
+    'app_redirect_in_app_warning_title' => 'Wykryto przeglądarkę wewnątrz aplikacji',
+    'app_redirect_in_app_warning_desc' => 'Przekierowania mogą być blokowane wewnątrz Instagrama lub Facebooka. Kliknij ikonę trzech kropek (•••) w prawym górnym rogu i wybierz „Otwórz w Safari” lub „Otwórz w Chrome”, aby uruchomić aplikację.',
+
+    // Link Expired Page
+    'expired_title' => 'Link nieaktywny lub wygasł',
+    'expired_description' => 'Ten link jest już nieaktywny. Mógł osiągnąć limit kliknięć, minął jego termin ważności lub został wyłączony.',
+    'expired_btn_home' => 'Przejdź do strony głównej',
 ];

resources/views/app-linking-preview.blade.php

@@ -0,0 +1,105 @@
+@php
+    $matchedAppId = \Bjanczak\FilamentShortUrl\Services\AppLinkingEngine::matchApp($destinationUrl);
+    $apps = \Bjanczak\FilamentShortUrl\Services\AppLinkingEngine::getSupportedApps();
+@endphp
+
+<div class="mt-4 space-y-4">
+    <!-- macOS style main block -->
+    <div class="p-4 rounded-xl border border-gray-200 dark:border-gray-800 bg-gray-50/50 dark:bg-gray-900/30 shadow-none">
+        
+        <!-- Header Info -->
+        <div class="flex flex-col sm:flex-row sm:items-center justify-between gap-2 pb-3 mb-4 border-b border-gray-200 dark:border-gray-800">
+            <div>
+                <h4 class="text-xs font-bold text-gray-850 dark:text-white uppercase tracking-wider">
+                    {{ __('filament-short-url::default.app_linking_supported_apps') }}
+                </h4>
+            </div>
+            
+            <div class="flex items-center gap-2 text-[10px]">
+                <span class="text-gray-500 dark:text-gray-450 font-medium">
+                    {{ __('filament-short-url::default.app_linking_supported_os') }}
+                </span>
+                <span class="px-2 py-0.5 rounded bg-gray-200 dark:bg-gray-800 text-gray-650 dark:text-gray-300 font-semibold">iOS</span>
+                <span class="px-2 py-0.5 rounded bg-gray-200 dark:bg-gray-800 text-gray-650 dark:text-gray-300 font-semibold">Android</span>
+            </div>
+        </div>
+
+        <!-- Matched App Banner -->
+        @if ($matchedAppId && isset($apps[$matchedAppId]))
+            @php
+                $matchedApp = $apps[$matchedAppId];
+                $matchedDomain = explode('/', $matchedApp['domains'][0])[0];
+                $matchedFavicon = "https://icons.duckduckgo.com/ip2/{$matchedDomain}.ico";
+                $deepLink = \Bjanczak\FilamentShortUrl\Services\AppLinkingEngine::convertToScheme($destinationUrl, $matchedAppId);
+            @endphp
+            <div class="mb-4 p-4 rounded-xl bg-emerald-500/5 dark:bg-emerald-500/5 border border-emerald-500 dark:border-emerald-600 text-xs shadow-none">
+                <div class="flex items-start gap-4">
+                    <!-- Squircle Favicon Box -->
+                    <div class="w-10 h-10 rounded-lg bg-white dark:bg-gray-800 flex items-center justify-center p-2 flex-shrink-0">
+                        <img src="{{ $matchedFavicon }}" alt="{{ $matchedApp['name'] }}" class="w-6 h-6 object-contain" onerror="this.src='https://icons.duckduckgo.com/ip2/google.com.ico'">
+                    </div>
+                    
+                    <div class="flex-grow min-w-0">
+                        <div class="flex flex-wrap items-center gap-2">
+                            <h5 class="text-xs font-bold text-emerald-850 dark:text-emerald-450">
+                                {{ __('filament-short-url::default.app_linking_redirect_active', ['app' => $matchedApp['name']]) }}
+                            </h5>
+                            <span class="inline-flex items-center px-1.5 py-0.5 rounded-full text-[9px] font-bold bg-emerald-500 text-white uppercase tracking-wider">
+                                {{ __('filament-short-url::default.app_linking_auto_open') }}
+                            </span>
+                        </div>
+                        <p class="text-[11px] text-emerald-700 dark:text-emerald-450 mt-1 leading-relaxed">
+                            {!! __('filament-short-url::default.app_linking_matched_description', ['app' => e($matchedApp['name'])]) !!}
+                        </p>
+                        <div class="mt-2 text-[10px] font-mono text-emerald-600 dark:text-emerald-400 break-all select-all">
+                            {{ __('filament-short-url::default.app_linking_deep_link_scheme', ['scheme' => $deepLink]) }}
+                        </div>
+                    </div>
+                </div>
+            </div>
+        @else
+            <!-- Standard Web Redirect banner -->
+            <div class="mb-4 p-3.5 rounded-xl bg-gray-100/50 dark:bg-gray-800/10 border border-gray-200 dark:border-gray-800 text-xs flex items-center gap-3 shadow-none">
+                <div class="w-7 h-7 rounded-[6px] bg-white dark:bg-gray-800 flex items-center justify-center p-1.5 flex-shrink-0">
+                    <svg class="w-4 h-4 text-gray-450" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2">
+                        <path stroke-linecap="round" stroke-linejoin="round" d="M21 12a9 9 0 11-18 0 9 9 0 0118 0z" />
+                    </svg>
+                </div>
+                <span class="text-gray-500 dark:text-gray-450 leading-relaxed text-[11px]">
+                    {{ __('filament-short-url::default.app_linking_standard_redirect') }}
+                </span>
+            </div>
+        @endif
+
+        <!-- Flat iOS-like Grid without Borders -->
+        <div class="grid grid-cols-2 sm:grid-cols-3 md:grid-cols-4 gap-2 mb-4">
+            @foreach ($apps as $appId => $app)
+                @php
+                    $isMatched = ($appId === $matchedAppId);
+                    $appDomain = explode('/', $app['domains'][0])[0];
+                    $appFavicon = "https://icons.duckduckgo.com/ip2/{$appDomain}.ico";
+                @endphp
+                <div class="flex items-center gap-2.5 p-1.5 rounded-lg transition {{ $isMatched ? 'bg-emerald-500/10 text-emerald-800 dark:text-emerald-400 font-bold' : 'hover:bg-gray-100/60 dark:hover:bg-gray-800/50 text-gray-700 dark:text-gray-300' }}">
+                    <!-- Favicon Squircle -->
+                    <div class="w-7 h-7 rounded-[6px] bg-white dark:bg-gray-800 flex items-center justify-center p-1.5 flex-shrink-0">
+                        <img src="{{ $appFavicon }}" alt="{{ $app['name'] }}" class="w-4 h-4 object-contain" onerror="this.src='https://icons.duckduckgo.com/ip2/google.com.ico'">
+                    </div>
+                    <span class="text-xs font-semibold truncate">
+                        {{ $app['name'] }}
+                    </span>
+                    @if ($isMatched)
+                        <span class="ml-auto flex h-3.5 w-3.5 items-center justify-center rounded-full bg-emerald-500 text-white text-[8px] font-bold shrink-0">
+                            ✓
+                        </span>
+                    @endif
+                </div>
+            @endforeach
+        </div>
+
+        <!-- Help footer -->
+        <p class="text-[11px] text-gray-450 dark:text-gray-500 border-t border-gray-200 dark:border-gray-800 pt-3 leading-relaxed">
+            {{ __('filament-short-url::default.app_linking_supported_apps_helper') }}
+        </p>
+
+    </div>
+</div>

resources/views/app-redirect.blade.php

@@ -0,0 +1,274 @@
+<!DOCTYPE html>
+<html lang="{{ str_replace('_', '-', app()->getLocale()) }}" class="h-full">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title>{{ __('filament-short-url::default.app_redirect_title') ?? 'Opening App...' }}</title>
+    
+    <!-- Premium Google Fonts: Bricolage Grotesque -->
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Bricolage+Grotesque:opsz,wght@12..96,200..800&display=swap" rel="stylesheet">
+    
+    <!-- Self-contained Tailwind CSS CDN for maximum plug-and-play reliability -->
+    <script src="https://cdn.tailwindcss.com"></script>
+    
+    <script>
+        tailwind.config = {
+            darkMode: 'class',
+            theme: {
+                extend: {
+                    fontFamily: {
+                        sans: ['Bricolage Grotesque', 'sans-serif'],
+                    },
+                }
+            }
+        }
+        
+        // Detect system dark mode preferences
+        if (window.matchMedia('(prefers-color-scheme: dark)').matches) {
+            document.documentElement.classList.add('dark');
+        } else {
+            document.documentElement.classList.remove('dark');
+        }
+    </script>
+
+    @php
+        $pixelMetaIds = $pixels->where('type', 'meta')->pluck('pixel_id');
+        $pixelGoogleIds = $pixels->where('type', 'google')->pluck('pixel_id');
+        $pixelLinkedinIds = $pixels->where('type', 'linkedin')->pluck('pixel_id');
+        $pixelTiktokIds = $pixels->where('type', 'tiktok')->pluck('pixel_id');
+        $pixelPinterestIds = $pixels->where('type', 'pinterest')->pluck('pixel_id');
+    @endphp
+
+    <!-- Meta / Facebook Pixel -->
+    @if($pixelMetaIds->isNotEmpty())
+    <script>
+    !function(f,b,e,v,n,t,s)
+    {if(f.fbq)return;n=f.fbq=function(){n.callMethod?
+    n.callMethod.apply(n,arguments):n.queue.push(arguments)};
+    if(!f._fbq)f._fbq=n;n.push=n;n.loaded=!0;n.version='2.0';
+    n.queue=[];t=b.createElement(e);t.async=!0;
+    t.src=v;s=b.getElementsByTagName(e)[0];
+    s.parentNode.insertBefore(t,s)}(window, document,'script',
+    'https://connect.facebook.net/en_US/fbevents.js');
+    @foreach($pixelMetaIds as $id)
+    fbq('init', '{{ $id }}');
+    fbq('track', 'PageView');
+    @endforeach
+    </script>
+    @foreach($pixelMetaIds as $id)
+    <noscript><img height="1" width="1" style="display:none" src="https://www.facebook.com/tr?id={{ $id }}&ev=PageView&noscript=1" /></noscript>
+    @endforeach
+    @endif
+
+    <!-- Google Analytics / GTM -->
+    @if($pixelGoogleIds->isNotEmpty())
+    @php $firstGoogleId = $pixelGoogleIds->first(); @endphp
+    <script async src="https://www.googletagmanager.com/gtag/js?id={{ $firstGoogleId }}"></script>
+    <script>
+    window.dataLayer = window.dataLayer || [];
+    function gtag(){dataLayer.push(arguments);}
+    gtag('js', new Date());
+    @foreach($pixelGoogleIds as $id)
+    gtag('config', '{{ $id }}');
+    @endforeach
+    </script>
+    @endif
+
+    <!-- LinkedIn Insight -->
+    @if($pixelLinkedinIds->isNotEmpty())
+    <script type="text/javascript">
+    window._linkedin_data_partner_ids = window._linkedin_data_partner_ids || [];
+    @foreach($pixelLinkedinIds as $id)
+    window._linkedin_data_partner_ids.push("{{ $id }}");
+    @endforeach
+    (function(l) {
+    if (!l){window.lintrk = function(a,b){window.lintrk.q.push([a,b])};
+    window.lintrk.q=[]}
+    var s = document.getElementsByTagName("script")[0];
+    var b = document.createElement("script");
+    b.type = "text/javascript";b.async = true;
+    b.src = "https://snap.licdn.com/li.lms-analytics/insight.min.js";
+    s.parentNode.insertBefore(b, s);})(window.lintrk);
+    </script>
+    @foreach($pixelLinkedinIds as $id)
+    <noscript><img height="1" width="1" style="display:none;" alt="" src="https://px.ads.linkedin.com/collect/?pid={{ $id }}&fmt=gif" /></noscript>
+    @endforeach
+    @endif
+
+    <!-- TikTok Pixel -->
+    @if($pixelTiktokIds->isNotEmpty())
+    <script>
+    !function (w, d, t) {
+      w.TiktokAnalyticsObject=t;var ttq=w[t]=w[t]||[];ttq.methods=["page","track","identify","instances","debug","on","off","once","ready","alias","group","enableCookie","disableCookie","holdConsent","revokeConsent","grantConsent"],ttq.setAndDefer=function(t,e){t[e]=function(){t.push([e].concat(Array.prototype.slice.call(arguments,0)))}};for(var i=0;i<ttq.methods.length;i++)ttq.setAndDefer(ttq,ttq.methods[i]);ttq.instance=function(t){for(var e=ttq._i[t]||[],n=0;n<ttq.methods.length;n++)ttq.setAndDefer(e,ttq.methods[n]);return e},ttq.load=function(e,n){var r="https://analytics.tiktok.com/i18n/pixel/events.js",o=n&&n.mixpanel;ttq._i=ttq._i||{},ttq._i[e]=[],ttq._i[e]._u=r,ttq._t=ttq._t||{},ttq._t[e]=+new Date,ttq._o=ttq._o||{},ttq._o[e]=o||{};var a=d.createElement("script");a.type="text/javascript",a.async=!0,a.src=r+"?sdkid="+e+"&lib="+t;var c=d.getElementsByTagName("script")[0];c.parentNode.insertBefore(a,c)};
+      @foreach($pixelTiktokIds as $id)
+      ttq.load('{{ $id }}');
+      ttq.page();
+      @endforeach
+    }(window, document, 'ttq');
+    </script>
+    @endif
+
+    <!-- Pinterest Tag -->
+    @if($pixelPinterestIds->isNotEmpty())
+    <script>
+    !function(e,n,t,r,a,s,o){e[r]||(e[r]=function(){(e[r].q=e[r].q||[]).push(arguments)},e[r].q=e[r].q||[],s=n.createElement(t),s.async=!0,s.src="https://s.pntrac.com/tag.js",o=n.getElementsByTagName(t)[0],o.parentNode.insertBefore(s,o))}(window,document,"script","pintrk");
+    @foreach($pixelPinterestIds as $id)
+    pintrk('load', '{{ $id }}');
+    pintrk('page');
+    @endforeach
+    </script>
+    @foreach($pixelPinterestIds as $id)
+    <noscript><img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?event=init&tid={{ $id }}&noscript=1" /></noscript>
+    @endforeach
+    @endif
+</head>
+<body class="bg-[#FCFCFC] dark:bg-[#0C0C0C] min-h-screen flex flex-col justify-between items-center py-10 px-6 font-sans antialiased">
+    @php
+        $siteName = config('filament-short-url.site_name') ?: config('app.name', 'Laravel');
+        
+        // Retrieve app metadata for premium visual hints
+        $apps = \Bjanczak\FilamentShortUrl\Services\AppLinkingEngine::getSupportedApps();
+        $matchedApp = $apps[$appId] ?? null;
+        $appColor = $matchedApp['color'] ?? '#3b82f6';
+        $appName = $matchedApp['name'] ?? 'App';
+    @endphp
+
+    {{-- Main Container --}}
+    <div class="w-full max-w-[360px] flex flex-col items-center gap-6 my-auto">
+        <div class="flex flex-col items-center text-center pb-2 select-none w-full">
+            <span class="text-2xl font-extrabold tracking-tight text-neutral-900 dark:text-white mb-6 select-none">{{ $siteName }}</span>
+
+            <!-- Premium Dynamic Loader with App Theme Highlight -->
+            <div class="relative flex items-center justify-center w-20 h-20 mb-6">
+                <!-- Outer Pulse ring -->
+                <div class="absolute inset-0 rounded-full opacity-20 animate-ping" style="background-color: {{ $appColor }};"></div>
+                <!-- Inner Spinning Border -->
+                <div class="absolute inset-0 rounded-full border-4 border-neutral-100 dark:border-neutral-900"></div>
+                <div class="absolute inset-0 rounded-full border-4 border-transparent border-t-current animate-spin" style="color: {{ $appColor }};"></div>
+                <!-- Center App Accent -->
+                <div class="w-10 h-10 rounded-full flex items-center justify-center text-white font-bold shadow-md" style="background-color: {{ $appColor }};">
+                    {{ substr($appName, 0, 1) }}
+                </div>
+            </div>
+            
+            <p class="text-xl font-bold text-neutral-900 dark:text-white mt-2">
+                {{ __('filament-short-url::default.app_redirect_opening_in', ['app' => $appName]) ?? "Opening in {$appName}" }}
+            </p>
+            <p class="text-sm text-neutral-400 dark:text-neutral-500 mt-2 max-w-[280px]">
+                {{ __('filament-short-url::default.app_redirect_waiting_text') ?? 'We are redirecting you to the native application. Please wait a moment...' }}
+            </p>
+        </div>
+        
+        <div class="w-full flex flex-col gap-4">
+            {{-- Action Buttons --}}
+            <div class="flex flex-col gap-3 w-full mt-2">
+                <!-- Manual trigger if redirect didn't catch -->
+                <a href="{{ $deepLink }}"
+                   class="w-full py-3.5 rounded-xl text-white font-semibold text-sm transition duration-200 shadow-md flex justify-center items-center gap-2 text-center"
+                   style="background-color: {{ $appColor }}; filter: brightness(0.95);"
+                   onmouseover="this.style.filter='brightness(1.05)';"
+                   onmouseout="this.style.filter='brightness(0.95)';"
+                   id="deep-link-btn">
+                    <span>{{ __('filament-short-url::default.app_redirect_btn_open') ?? 'Open Native App' }}</span>
+                    <svg class="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2.5">
+                        <path stroke-linecap="round" stroke-linejoin="round" d="M13.5 4.5L21 12m0 0l-7.5 7.5M21 12H3" />
+                    </svg>
+                </a>
+                
+                <!-- Fallback Button -->
+                <a href="{{ $destination }}"
+                   class="w-full py-3 rounded-xl border border-neutral-200 dark:border-neutral-800 bg-white dark:bg-neutral-900 hover:bg-neutral-50 dark:hover:bg-neutral-800 text-neutral-500 dark:text-neutral-400 font-semibold text-sm transition duration-200 flex justify-center items-center gap-2 shadow-sm"
+                   id="fallback-btn">
+                    <span>{{ __('filament-short-url::default.app_redirect_btn_browser') ?? 'Open in Browser' }}</span>
+                </a>
+            </div>
+
+            {{-- In-App Browser Alert Banner (Hidden by default, shown via JS) --}}
+            <div id="in-app-alert" class="hidden mt-4 p-3.5 rounded-xl border border-amber-200 bg-amber-50 dark:border-amber-950/20 dark:bg-amber-950/10 text-amber-800 dark:text-amber-400 text-xs text-center flex flex-col gap-1 select-none">
+                <p class="font-bold flex items-center justify-center gap-1.5 text-amber-900 dark:text-amber-300">
+                    <svg class="h-3.5 w-3.5" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2.5">
+                        <path stroke-linecap="round" stroke-linejoin="round" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z" />
+                    </svg>
+                    <span>{{ __('filament-short-url::default.app_redirect_in_app_warning_title') ?? 'In-App Browser Detected' }}</span>
+                </p>
+                <p class="text-[11px] leading-relaxed opacity-95">
+                    {{ __('filament-short-url::default.app_redirect_in_app_warning_desc') ?? 'Redirections can be restricted inside Instagram or Facebook. Tap the three dots (•••) in the top-right corner and select "Open in Safari" or "Open in Chrome" to launch the app.' }}
+                </p>
+            </div>
+        </div>
+    </div>
+
+    {{-- Footer section --}}
+    <div class="flex flex-col items-center gap-2 mt-auto select-none">
+        <span class="text-xs font-medium text-neutral-400 dark:text-neutral-600">© {{ date('Y') }} {{ $siteName }}. All rights reserved.</span>
+    </div>
+
+    <!-- Automatic JS Deep Linking Engine -->
+    <script>
+        (function() {
+            var deepLink = @json($deepLink);
+            var fallbackUrl = @json($destination);
+            var hasPixels = @json(!empty($pixels) && $pixels->isNotEmpty());
+            
+            // Detect in-app webviews
+            var ua = navigator.userAgent || navigator.vendor || window.opera;
+            var isInstagram = ua.indexOf('Instagram') > -1;
+            var isFacebook = (ua.indexOf('FBAN') > -1) || (ua.indexOf('FBAV') > -1);
+            var isMessenger = (ua.indexOf('Messenger') > -1) || (ua.indexOf('FB_IAB') > -1);
+            
+            if (isInstagram || isFacebook || isMessenger) {
+                var alertBox = document.getElementById('in-app-alert');
+                if (alertBox) {
+                    alertBox.classList.remove('hidden');
+                }
+            }
+
+            var fallbackTimeout = null;
+
+            function launchApp() {
+                // Try opening native app scheme
+                window.location.replace(deepLink);
+                
+                // Trigger fallback if not installed/unsupported after 1.8 seconds
+                fallbackTimeout = setTimeout(function() {
+                    window.location.replace(fallbackUrl);
+                }, 1800);
+                
+                // Cancel fallback if user switches context (app successfully opened)
+                window.addEventListener('pagehide', function() {
+                    if (fallbackTimeout) clearTimeout(fallbackTimeout);
+                });
+                window.addEventListener('visibilitychange', function() {
+                    if (document.hidden && fallbackTimeout) {
+                        clearTimeout(fallbackTimeout);
+                    }
+                });
+                window.addEventListener('blur', function() {
+                    if (fallbackTimeout) {
+                        clearTimeout(fallbackTimeout);
+                    }
+                });
+            }
+
+            // Also clear timeout if user clicks manual trigger button
+            var deepLinkBtn = document.getElementById('deep-link-btn');
+            if (deepLinkBtn) {
+                deepLinkBtn.addEventListener('click', function() {
+                    if (fallbackTimeout) {
+                        clearTimeout(fallbackTimeout);
+                    }
+                });
+            }
+
+            if (hasPixels) {
+                // Wait 250ms for pixels to fire before triggering redirect
+                setTimeout(launchApp, 250);
+            } else {
+                launchApp();
+            }
+        })();
+    </script>
+</body>
+</html>

resources/views/expired.blade.php

@@ -0,0 +1,90 @@
+<!DOCTYPE html>
+<html lang="{{ str_replace('_', '-', app()->getLocale()) }}" class="h-full">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title>{{ __('filament-short-url::default.expired_title') ?? 'Link Inactive or Expired' }}</title>
+    
+    <!-- Premium Google Fonts: Bricolage Grotesque -->
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Bricolage+Grotesque:opsz,wght@12..96,200..800&display=swap" rel="stylesheet">
+    
+    <!-- Self-contained Tailwind CSS CDN for maximum plug-and-play reliability -->
+    <script src="https://cdn.tailwindcss.com"></script>
+    
+    <script>
+        tailwind.config = {
+            darkMode: 'class',
+            theme: {
+                extend: {
+                    fontFamily: {
+                        sans: ['Bricolage Grotesque', 'sans-serif'],
+                    },
+                }
+            }
+        }
+        
+        // Detect system dark mode preferences
+        if (window.matchMedia('(prefers-color-scheme: dark)').matches) {
+            document.documentElement.classList.add('dark');
+        } else {
+            document.documentElement.classList.remove('dark');
+        }
+    </script>
+</head>
+<body class="bg-[#FCFCFC] dark:bg-[#0C0C0C] min-h-screen flex flex-col justify-between items-center py-10 px-6 font-sans antialiased">
+    @php
+        $siteName = config('filament-short-url.site_name') ?: config('app.name', 'Laravel');
+    @endphp
+
+    {{-- Main Expiry Box --}}
+    <div class="w-full max-w-[360px] flex flex-col items-center gap-6 my-auto">
+        <div class="flex flex-col items-center text-center pb-2 select-none w-full">
+            <span class="text-3xl font-extrabold tracking-tight text-neutral-900 dark:text-white mb-3">{{ $siteName }}</span>
+
+            <div class="w-16 h-16 rounded-full bg-amber-500/10 dark:bg-amber-500/20 flex items-center justify-center mt-4 mb-2 text-amber-500">
+                <svg class="h-8 w-8" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2">
+                    <path stroke-linecap="round" stroke-linejoin="round" d="M12 8v4l3 3m6-3a9 9 0 11-18 0 9 9 0 0118 0z" />
+                </svg>
+            </div>
+
+            <p class="text-xl font-medium text-neutral-900 dark:text-white mt-2">
+                {{ __('filament-short-url::default.expired_title') ?? 'Link Inactive or Expired' }}
+            </p>
+            <p class="text-sm text-neutral-400 dark:text-neutral-500 mt-1">
+                {{ __('filament-short-url::default.expired_description') ?? 'This link is no longer active. It may have reached its click limit, expiration date, or has been deactivated.' }}
+            </p>
+        </div>
+
+        <div class="w-full flex flex-col gap-4">
+            {{-- Short URL info box --}}
+            @if ($shortUrl)
+                <div class="relative flex items-center justify-center px-3 py-3.5 w-full rounded-xl border border-neutral-200 dark:border-neutral-800 bg-white dark:bg-neutral-900 transition duration-200">
+                    <div class="flex flex-col justify-center text-center min-w-0">
+                        <span class="text-[10px] font-bold text-neutral-400 dark:text-neutral-500 uppercase tracking-wide select-none">
+                            Expired Link
+                        </span>
+                        <p class="break-all text-xs font-mono font-semibold text-rose-600 dark:text-rose-400 mt-1 select-all">
+                            {{ $shortUrl->getShortUrl() }}
+                        </p>
+                    </div>
+                </div>
+            @endif
+
+            {{-- Action Button --}}
+            <a href="{{ url('/') }}" class="w-full mt-2 py-3.5 rounded-xl bg-neutral-900 hover:bg-neutral-800 dark:bg-white dark:hover:bg-neutral-200 dark:text-neutral-900 text-white font-semibold text-sm transition duration-200 flex justify-center items-center gap-2 text-center">
+                <span>{{ __('filament-short-url::default.expired_btn_home') ?? 'Go to Homepage' }}</span>
+                <svg class="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2">
+                    <path stroke-linecap="round" stroke-linejoin="round" d="M3 12l2-2m0 0l7-7 7 7M5 10v10a1 1 0 001 1h3m10-11l2 2m-2-2v10a1 1 0 01-1 1h-3m-6 0a1 1 0 001-1v-4a1 1 0 011-1h2a1 1 0 011 1v4a1 1 0 001 1m-6 0h6" />
+                </svg>
+            </a>
+        </div>
+    </div>
+
+    {{-- Footer section --}}
+    <div class="flex flex-col items-center gap-2 mt-auto select-none">
+        <span class="text-xs font-medium text-neutral-400 dark:text-neutral-600">© {{ date('Y') }} {{ $siteName }} Inc. All rights reserved.</span>
+    </div>
+</body>
+</html>

routes/web.php

@@ -7,6 +7,13 @@ use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Log;
 use Illuminate\Support\Facades\Route;
 
+Route::get('/.well-known/apple-app-site-association', [ShortUrlRedirectController::class, 'serveAasa'])
+    ->middleware(['web']);
+Route::get('/apple-app-site-association', [ShortUrlRedirectController::class, 'serveAasa'])
+    ->middleware(['web']);
+Route::get('/.well-known/assetlinks.json', [ShortUrlRedirectController::class, 'serveAssetLinks'])
+    ->middleware(['web']);
+
 Route::match(
     ['GET', 'POST'],
     config('filament-short-url.route_prefix', 's').'/{key}',
@@ -16,6 +23,7 @@ Route::match(
     ->where('key', '[a-zA-Z0-9_-]+')
     ->middleware(config('filament-short-url.middleware', ['web', 'throttle:120,1']));
 
+
 Route::prefix('api/short-url')
     ->middleware([AuthenticateShortUrlApi::class])
     ->group(function () {

src/Filament/Resources/ShortUrlPixelResource.php

@@ -7,10 +7,10 @@ use Bjanczak\FilamentShortUrl\Models\ShortUrlPixel;
 use Filament\Forms\Components\Select;
 use Filament\Forms\Components\TextInput;
 use Filament\Forms\Components\Toggle;
+use Filament\Actions\DeleteAction;
+use Filament\Actions\EditAction;
 use Filament\Resources\Resource;
 use Filament\Schemas\Schema;
-use Filament\Tables\Actions\DeleteAction;
-use Filament\Tables\Actions\EditAction;
 use Filament\Tables\Columns\IconColumn;
 use Filament\Tables\Columns\TextColumn;
 use Filament\Tables\Columns\ToggleColumn;
@@ -137,8 +137,17 @@ class ShortUrlPixelResource extends Resource
             ])
             ->filters([])
             ->actions([
-                EditAction::make()->modalWidth('md'),
-                DeleteAction::make(),
+                EditAction::make()
+                    ->icon('heroicon-o-pencil-square')
+                    ->color('gray')
+                    ->iconButton()
+                    ->tooltip(__('filament-short-url::default.action_edit'))
+                    ->modalWidth('md'),
+                DeleteAction::make()
+                    ->icon('heroicon-o-trash')
+                    ->color('gray')
+                    ->iconButton()
+                    ->tooltip(__('filament-short-url::default.action_delete')),
             ])
             ->bulkActions([]);
     }

src/Filament/Resources/ShortUrlResource.php

@@ -3,7 +3,6 @@
 namespace Bjanczak\FilamentShortUrl\Filament\Resources;
 
 use Bjanczak\FilamentShortUrl\Filament\Resources\ShortUrlResource\Pages\ListShortUrls;
-use Bjanczak\FilamentShortUrl\Filament\Resources\ShortUrlResource\Pages\ShortUrlSettingsPage;
 use Bjanczak\FilamentShortUrl\Filament\Resources\ShortUrlResource\Pages\ViewShortUrlLogs;
 use Bjanczak\FilamentShortUrl\Filament\Resources\ShortUrlResource\Pages\ViewShortUrlStats;
 use Bjanczak\FilamentShortUrl\Filament\Resources\ShortUrlResource\Schemas\ShortUrlForm;
@@ -113,7 +112,6 @@ class ShortUrlResource extends Resource
             'index' => ListShortUrls::route('/'),
             'stats' => ViewShortUrlStats::route('/{record}/stats'),
             'stats.logs' => ViewShortUrlLogs::route('/{record}/stats/logs'),
-            'settings' => ShortUrlSettingsPage::route('/settings'),
         ];
     }
 }

src/Filament/Resources/ShortUrlResource/Pages/ListShortUrls.php

@@ -19,14 +19,6 @@ class ListShortUrls extends ManageRecords
     protected function getHeaderActions(): array
     {
         return [
-            Action::make('settings')
-                ->label(__('filament-short-url::default.settings_nav_label'))
-                ->icon('heroicon-o-adjustments-horizontal')
-                ->color('gray')
-                ->size('sm')
-                ->url(static::getResource()::getUrl('settings'))
-                ->visible(fn () => ShortUrlSettingsPage::canAccess()),
-
             CreateAction::make()
                 ->icon('heroicon-o-plus')
                 ->size('sm')

src/Filament/Resources/ShortUrlResource/Pages/ShortUrlSettingsPage.php

@@ -12,12 +12,13 @@ use Filament\Forms\Components\ColorPicker;
 use Filament\Forms\Components\Placeholder;
 use Filament\Forms\Components\Repeater;
 use Filament\Forms\Components\Select;
+use Filament\Forms\Components\Textarea;
 use Filament\Forms\Components\TextInput;
 use Filament\Forms\Components\Toggle;
 use Filament\Forms\Concerns\InteractsWithForms;
 use Filament\Forms\Contracts\HasForms;
 use Filament\Notifications\Notification;
-use Filament\Resources\Pages\Page;
+use Filament\Pages\Page;
 use Filament\Schemas\Components\Actions;
 use Filament\Schemas\Components\Section;
 use Filament\Schemas\Components\Tabs;
@@ -32,10 +33,35 @@ class ShortUrlSettingsPage extends Page implements HasForms
 {
     use InteractsWithForms;
 
-    protected static string $resource = ShortUrlResource::class;
+    protected static string|\BackedEnum|null $navigationIcon = 'heroicon-o-cog-6-tooth';
+
+    protected static ?string $slug = 'short-url-settings';
 
     protected string $view = 'filament-short-url::settings';
 
+    public static function getNavigationLabel(): string
+    {
+        return __('filament-short-url::default.settings_nav_label') ?? 'Settings';
+    }
+
+    public static function getNavigationGroup(): string|\UnitEnum|null
+    {
+        try {
+            return ShortUrlResource::getNavigationGroup();
+        } catch (\Throwable) {
+            return __('filament-short-url::default.navigation_group');
+        }
+    }
+
+    public static function getNavigationSort(): ?int
+    {
+        try {
+            return ShortUrlResource::getNavigationSort() + 2;
+        } catch (\Throwable) {
+            return 52;
+        }
+    }
+
     public static function canAccess(array $parameters = []): bool
     {
         try {
@@ -55,7 +81,7 @@ class ShortUrlSettingsPage extends Page implements HasForms
         }
 
         // Default fallback: Check if the user is authorized to view the resource in general
-        return static::getResource()::canViewAny();
+        return ShortUrlResource::canViewAny();
     }
 
     public ?array $data = [];
@@ -64,6 +90,22 @@ class ShortUrlSettingsPage extends Page implements HasForms
     {
         $mgr = app(ShortUrlSettingsManager::class);
 
+        $aasa = $mgr->get('aasa_json');
+        if (! empty($aasa)) {
+            $decoded = json_decode($aasa, true);
+            if (json_last_error() === JSON_ERROR_NONE) {
+                $aasa = json_encode($decoded, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
+            }
+        }
+
+        $assetlinks = $mgr->get('assetlinks_json');
+        if (! empty($assetlinks)) {
+            $decoded = json_decode($assetlinks, true);
+            if (json_last_error() === JSON_ERROR_NONE) {
+                $assetlinks = json_encode($decoded, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
+            }
+        }
+
         $this->form->fill([
             'route_prefix' => $mgr->get('route_prefix', 's'),
             'redirect_status_code' => $mgr->get('redirect_status_code', 302),
@@ -117,6 +159,10 @@ class ShortUrlSettingsPage extends Page implements HasForms
             'vpn_block_action' => $mgr->get('vpn_block_action', 'flag_only'),
             'safe_browsing_enabled' => $mgr->get('safe_browsing_enabled', false),
             'google_safe_browsing_api_key' => $mgr->get('google_safe_browsing_api_key'),
+            // Deep Linking v2.1
+            'deep_linking_enabled' => $mgr->get('deep_linking_enabled', false),
+            'aasa_json' => $aasa,
+            'assetlinks_json' => $assetlinks,
         ]);
     }
 
@@ -823,6 +869,65 @@ class ShortUrlSettingsPage extends Page implements HasForms
                                             ->visible(fn (Get $get): bool => (bool) $get('global_webhook_enabled')),
                                     ]),
                             ]),
+
+                        // ── Deep Linking ─────────────────────────────────────
+                        Tab::make(__('filament-short-url::default.settings_tab_deep_linking'))
+                            ->icon('heroicon-o-device-phone-mobile')
+                            ->schema([
+                                Section::make(__('filament-short-url::default.settings_section_deep_linking'))
+                                    ->schema([
+                                        Toggle::make('deep_linking_enabled')
+                                            ->label(__('filament-short-url::default.settings_deep_linking_enabled'))
+                                            ->helperText(__('filament-short-url::default.settings_deep_linking_enabled_helper'))
+                                            ->default(false)
+                                            ->inline(false)
+                                            ->live(),
+
+                                        Textarea::make('aasa_json')
+                                            ->label(__('filament-short-url::default.settings_aasa_json'))
+                                            ->helperText(__('filament-short-url::default.settings_aasa_json_helper'))
+                                            ->nullable()
+                                            ->visible(fn (Get $get): bool => (bool) $get('deep_linking_enabled'))
+                                            ->columnSpanFull()
+                                            ->extraInputAttributes(['style' => 'font-family: monospace;'])
+                                            ->rows(8)
+                                            ->rules([
+                                                function () {
+                                                    return function (string $attribute, $value, \Closure $fail) {
+                                                        if (empty($value)) {
+                                                            return;
+                                                        }
+                                                        json_decode($value);
+                                                        if (json_last_error() !== JSON_ERROR_NONE) {
+                                                            $fail(__('filament-short-url::default.validation_invalid_json'));
+                                                        }
+                                                    };
+                                                },
+                                            ]),
+
+                                        Textarea::make('assetlinks_json')
+                                            ->label(__('filament-short-url::default.settings_assetlinks_json'))
+                                            ->helperText(__('filament-short-url::default.settings_assetlinks_json_helper'))
+                                            ->nullable()
+                                            ->visible(fn (Get $get): bool => (bool) $get('deep_linking_enabled'))
+                                            ->columnSpanFull()
+                                            ->extraInputAttributes(['style' => 'font-family: monospace;'])
+                                            ->rows(8)
+                                            ->rules([
+                                                function () {
+                                                    return function (string $attribute, $value, \Closure $fail) {
+                                                        if (empty($value)) {
+                                                            return;
+                                                        }
+                                                        json_decode($value);
+                                                        if (json_last_error() !== JSON_ERROR_NONE) {
+                                                            $fail(__('filament-short-url::default.validation_invalid_json'));
+                                                        }
+                                                    };
+                                                },
+                                            ]),
+                                    ]),
+                            ]),
                     ]),
             ])
             ->statePath('data');
@@ -834,6 +939,10 @@ class ShortUrlSettingsPage extends Page implements HasForms
 
         app(ShortUrlSettingsManager::class)->set($data);
 
+        // Clear deep linking cache when settings are saved!
+        cache()->forget('fsu:deep-linking:aasa');
+        cache()->forget('fsu:deep-linking:assetlinks');
+
         Notification::make()
             ->title(__('filament-short-url::default.settings_saved'))
             ->success()
@@ -848,7 +957,7 @@ class ShortUrlSettingsPage extends Page implements HasForms
                 ->icon('heroicon-o-arrow-left')
                 ->color('gray')
                 ->size('sm')
-                ->url(static::getResource()::getUrl()),
+                ->url(ShortUrlResource::getUrl()),
         ];
     }
 

src/Filament/Resources/ShortUrlResource/Schemas/ShortUrlForm.php

@@ -28,6 +28,7 @@ class ShortUrlForm
             Tabs::make()->tabs([
                 static::linkTab(),
                 static::targetingTab(),
+                static::appLinkingTab(),
                 static::trackingTab(),
                 static::marketingTab(),
                 static::qrDesignTab(),
@@ -569,4 +570,30 @@ class ShortUrlForm
                     ]),
             ]);
     }
+
+    private static function appLinkingTab(): Tab
+    {
+        return Tab::make(__('filament-short-url::default.tab_app_linking') ?? 'App Linking')
+            ->icon('heroicon-o-device-phone-mobile')
+            ->schema([
+                Section::make(__('filament-short-url::default.form_section_app_linking') ?? 'App Linking / Deep Links')
+                    ->schema([
+                        Toggle::make('auto_open_app_mobile')
+                            ->label(__('filament-short-url::default.auto_open_app_mobile') ?? 'Auto open app on mobile')
+                            ->helperText(__('filament-short-url::default.auto_open_app_mobile_helper') ?? 'Enable this if you want your link to automatically open as an app when accessed on mobile.')
+                            ->default(false)
+                            ->inline(false)
+                            ->live(),
+
+                        ViewField::make('app_linking_preview')
+                            ->view('filament-short-url::app-linking-preview')
+                            ->viewData(fn (Get $get) => [
+                                'destinationUrl' => $get('destination_url'),
+                            ])
+                            ->columnSpanFull()
+                            ->visible(fn (Get $get): bool => (bool) $get('auto_open_app_mobile')),
+                    ]),
+            ]);
     }
+}
+

src/FilamentShortUrlPlugin.php

@@ -46,6 +46,9 @@ class FilamentShortUrlPlugin implements Plugin
             ->resources([
                 ShortUrlResource::class,
                 ShortUrlPixelResource::class,
+            ])
+            ->pages([
+                \Bjanczak\FilamentShortUrl\Filament\Resources\ShortUrlResource\Pages\ShortUrlSettingsPage::class,
             ]);
     }
 

src/FilamentShortUrlServiceProvider.php

@@ -39,6 +39,8 @@ class FilamentShortUrlServiceProvider extends PackageServiceProvider
                 '2026_06_02_224250_add_qr_logo_to_short_urls_table',
                 '2026_06_03_110000_add_qr_and_language_to_visits_and_daily_stats',
                 '2026_06_03_120000_add_track_browser_language_to_short_urls_table',
+                '2026_06_03_150000_create_short_url_pixels_table',
+                '2026_06_03_160000_add_auto_open_app_mobile_to_short_urls_table',
             ])
             ->hasCommands([
                 SyncBufferedCountersCommand::class,

src/Http/Controllers/ShortUrlRedirectController.php

@@ -4,9 +4,11 @@ namespace Bjanczak\FilamentShortUrl\Http\Controllers;
 
 use Bjanczak\FilamentShortUrl\Jobs\TrackShortUrlVisitJob;
 use Bjanczak\FilamentShortUrl\Models\ShortUrl;
+use Bjanczak\FilamentShortUrl\Services\AppLinkingEngine;
 use Bjanczak\FilamentShortUrl\Services\ClientIpExtractor;
 use Bjanczak\FilamentShortUrl\Services\ProxyDetectionService;
 use Bjanczak\FilamentShortUrl\Services\ShortUrlService;
+use Bjanczak\FilamentShortUrl\Services\UserAgentParser;
 use Illuminate\Http\Request;
 use Illuminate\Routing\Controller;
 use Illuminate\Support\Facades\Log;
@@ -35,7 +37,9 @@ class ShortUrlRedirectController extends Controller
                 return redirect()->away($shortUrl->expiration_redirect_url, 302);
             }
 
-            abort(410);
+            return response(view('filament-short-url::expired', [
+                'shortUrl' => $shortUrl,
+            ]), 410)->header('Content-Type', 'text/html');
         }
 
         // 1. VPN/Proxy & Bot Blocking Check
@@ -92,6 +96,27 @@ class ShortUrlRedirectController extends Controller
         // 4. Resolve Destination URL (evaluating targeting rules and forwarding query parameters)
         $destination = $this->service->resolveRedirectUrl($shortUrl, $request);
 
+        // App Linking / Deep Links Auto-Open Check
+        if ($shortUrl->auto_open_app_mobile) {
+            $uaParser = app(UserAgentParser::class);
+            $parsedUa = $uaParser->parse($request->userAgent() ?? '');
+
+            if ($parsedUa['device_type'] === 'mobile' || $parsedUa['device_type'] === 'tablet') {
+                $matchedApp = AppLinkingEngine::matchApp($destination);
+                if ($matchedApp !== null) {
+                    $deepLink = AppLinkingEngine::convertToScheme($destination, $matchedApp);
+                    $activePixels = $shortUrl->pixels()->where('is_active', true)->get();
+
+                    return response(view('filament-short-url::app-redirect', [
+                        'destination' => $destination,
+                        'deepLink' => $deepLink,
+                        'appId' => $matchedApp,
+                        'pixels' => $activePixels,
+                    ]))->header('Content-Type', 'text/html');
+                }
+            }
+        }
+
         // 5. Warning / Intermediate Page Check
         if ($shortUrl->show_warning_page && ! $request->has('confirmed')) {
             return response(view('filament-short-url::warning', ['destinationUrl' => $destination]))
@@ -155,7 +180,9 @@ class ShortUrlRedirectController extends Controller
 
             // Another request beat us to it — this visit should 410
             if ($affected === 0) {
-                abort(410);
+                return response(view('filament-short-url::expired', [
+                    'shortUrl' => $shortUrl,
+                ]), 410)->header('Content-Type', 'text/html');
             }
 
             // Manually forget cache since DB-level update does not trigger Eloquent events
@@ -173,4 +200,70 @@ class ShortUrlRedirectController extends Controller
 
         return redirect()->away($destination, $shortUrl->redirect_status_code);
     }
+
+    /**
+     * Serve the Apple App Site Association (AASA) file for iOS Universal Links.
+     */
+    public function serveAasa(Request $request): Response
+    {
+        if (! config('filament-short-url.deep_linking.enabled', false)) {
+            abort(404);
+        }
+
+        $aasaJson = config('filament-short-url.deep_linking.aasa_json');
+
+        if (empty($aasaJson)) {
+            abort(404);
+        }
+
+        $minified = cache()->remember('fsu:deep-linking:aasa', 604800, function () use ($aasaJson): string {
+            try {
+                $decoded = json_decode($aasaJson, true, 512, JSON_THROW_ON_ERROR);
+
+                return json_encode($decoded, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
+            } catch (\Throwable) {
+                return $aasaJson;
+            }
+        });
+
+        return response($minified, 200, [
+            'Content-Type' => 'application/json; charset=utf-8',
+            'Cache-Control' => 'public, max-age=604800, must-revalidate',
+            'X-Content-Type-Options' => 'nosniff',
+            'Access-Control-Allow-Origin' => '*',
+        ]);
+    }
+
+    /**
+     * Serve the Asset Links file for Android App Links.
+     */
+    public function serveAssetLinks(Request $request): Response
+    {
+        if (! config('filament-short-url.deep_linking.enabled', false)) {
+            abort(404);
+        }
+
+        $assetlinksJson = config('filament-short-url.deep_linking.assetlinks_json');
+
+        if (empty($assetlinksJson)) {
+            abort(404);
+        }
+
+        $minified = cache()->remember('fsu:deep-linking:assetlinks', 604800, function () use ($assetlinksJson): string {
+            try {
+                $decoded = json_decode($assetlinksJson, true, 512, JSON_THROW_ON_ERROR);
+
+                return json_encode($decoded, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
+            } catch (\Throwable) {
+                return $assetlinksJson;
+            }
+        });
+
+        return response($minified, 200, [
+            'Content-Type' => 'application/json; charset=utf-8',
+            'Cache-Control' => 'public, max-age=604800, must-revalidate',
+            'X-Content-Type-Options' => 'nosniff',
+            'Access-Control-Allow-Origin' => '*',
+        ]);
+    }
 }

src/Models/ShortUrl.php

@@ -86,6 +86,7 @@ class ShortUrl extends Model
         'webhook_url',
         'qr_logo',
         'qr_scans',
+        'auto_open_app_mobile',
     ];
 
     /** @var array<string, string> */
@@ -93,6 +94,7 @@ class ShortUrl extends Model
         'is_enabled' => 'boolean',
         'single_use' => 'boolean',
         'forward_query_params' => 'boolean',
+        'auto_open_app_mobile' => 'boolean',
         'track_visits' => 'boolean',
         'track_ip_address' => 'boolean',
         'track_browser' => 'boolean',

src/Services/AppLinkingEngine.php

@@ -0,0 +1,242 @@
+<?php
+
+namespace Bjanczak\FilamentShortUrl\Services;
+
+class AppLinkingEngine
+{
+    /**
+     * List of supported apps with their metadata.
+     *
+     * @return array<string, array{name: string, color: string, icon: string, domains: string[]}>
+     */
+    public static function getSupportedApps(): array
+    {
+        return [
+            'youtube' => [
+                'name' => 'YouTube',
+                'color' => '#ff0000',
+                'icon' => 'fab-youtube',
+                'domains' => ['youtube.com', 'youtu.be', 'youtube-nocookie.com'],
+            ],
+            'tiktok' => [
+                'name' => 'TikTok',
+                'color' => '#fc295d',
+                'icon' => 'fab-tiktok',
+                'domains' => ['tiktok.com'],
+            ],
+            'instagram' => [
+                'name' => 'Instagram',
+                'color' => '#e1306c',
+                'icon' => 'fab-instagram',
+                'domains' => ['instagram.com', 'instagr.am'],
+            ],
+            'x' => [
+                'name' => 'X (Twitter)',
+                'color' => '#1da1f2',
+                'icon' => 'fab-x-twitter',
+                'domains' => ['x.com', 'twitter.com'],
+            ],
+            'spotify' => [
+                'name' => 'Spotify',
+                'color' => '#2cd85c',
+                'icon' => 'fab-spotify',
+                'domains' => ['spotify.com', 'open.spotify.com', 'spotify.link'],
+            ],
+            'facebook' => [
+                'name' => 'Facebook',
+                'color' => '#1877f2',
+                'icon' => 'fab-facebook',
+                'domains' => ['facebook.com', 'fb.com', 'fb.me'],
+            ],
+            'reddit' => [
+                'name' => 'Reddit',
+                'color' => '#fc3a06',
+                'icon' => 'fab-reddit',
+                'domains' => ['reddit.com', 'redd.it'],
+            ],
+            'snapchat' => [
+                'name' => 'Snapchat',
+                'color' => '#ffb700',
+                'icon' => 'fab-snapchat',
+                'domains' => ['snapchat.com'],
+            ],
+            'whatsapp' => [
+                'name' => 'WhatsApp',
+                'color' => '#128c7e',
+                'icon' => 'fab-whatsapp',
+                'domains' => ['whatsapp.com', 'wa.me', 'api.whatsapp.com'],
+            ],
+            'linkedin' => [
+                'name' => 'LinkedIn',
+                'color' => '#0a66c2',
+                'icon' => 'fab-linkedin',
+                'domains' => ['linkedin.com'],
+            ],
+            'pinterest' => [
+                'name' => 'Pinterest',
+                'color' => '#e60023',
+                'icon' => 'fab-pinterest',
+                'domains' => ['pinterest.com', 'pin.it'],
+            ],
+            'twitch' => [
+                'name' => 'Twitch',
+                'color' => '#9146ff',
+                'icon' => 'fab-twitch',
+                'domains' => ['twitch.tv'],
+            ],
+            'netflix' => [
+                'name' => 'Netflix',
+                'color' => '#e50914',
+                'icon' => 'fas-film',
+                'domains' => ['netflix.com'],
+            ],
+            'google_sheets' => [
+                'name' => 'Google Sheets',
+                'color' => '#25a465',
+                'icon' => 'fas-file',
+                'domains' => ['docs.google.com/spreadsheets'],
+            ],
+            'google_docs' => [
+                'name' => 'Google Docs',
+                'color' => '#2a7efc',
+                'icon' => 'fas-file-word',
+                'domains' => ['docs.google.com/document'],
+            ],
+            'google_slides' => [
+                'name' => 'Google Slides',
+                'color' => '#fabe0b',
+                'icon' => 'fas-image',
+                'domains' => ['docs.google.com/presentation'],
+            ],
+            'google_maps' => [
+                'name' => 'Google Maps',
+                'color' => '#4285f4',
+                'icon' => 'fas-map-location-dot',
+                'domains' => ['google.com/maps', 'maps.google.com', 'maps.app.goo.gl'],
+            ],
+            'facebook_messenger' => [
+                'name' => 'Facebook Messenger',
+                'color' => '#0084ff',
+                'icon' => 'fab-facebook-messenger',
+                'domains' => ['messenger.com'],
+            ],
+            'apple_music' => [
+                'name' => 'Apple Music',
+                'color' => '#f8506b',
+                'icon' => 'fab-apple',
+                'domains' => ['music.apple.com'],
+            ],
+            'airbnb' => [
+                'name' => 'Airbnb',
+                'color' => '#ff5a5f',
+                'icon' => 'fab-airbnb',
+                'domains' => ['airbnb.com', 'airbnb.pl', 'airbnb.de', 'airbnb.fr'],
+            ],
+            'tripadvisor' => [
+                'name' => 'TripAdvisor',
+                'color' => '#00af87',
+                'icon' => 'fas-plane',
+                'domains' => ['tripadvisor.com', 'tripadvisor.pl'],
+            ],
+            'amazon' => [
+                'name' => 'Amazon',
+                'color' => '#ff9900',
+                'icon' => 'fab-amazon',
+                'domains' => ['amazon.com', 'amazon.co.uk', 'amazon.de', 'amazon.pl', 'amazon.fr', 'amazon.it', 'amazon.es'],
+            ],
+            'stockx' => [
+                'name' => 'StockX',
+                'color' => '#006341',
+                'icon' => 'fas-chart-line',
+                'domains' => ['stockx.com'],
+            ],
+            'booking' => [
+                'name' => 'Booking.com',
+                'color' => '#003580',
+                'icon' => 'fas-hotel',
+                'domains' => ['booking.com'],
+            ],
+            'aliexpress' => [
+                'name' => 'AliExpress',
+                'color' => '#e62e04',
+                'icon' => 'fas-cart-shopping',
+                'domains' => ['aliexpress.com', 'aliexpress.ru'],
+            ],
+        ];
+    }
+
+    /**
+     * Identify the app matching the destination URL.
+     */
+    public static function matchApp(?string $url): ?string
+    {
+        if (empty($url)) {
+            return null;
+        }
+
+        $urlLower = strtolower($url);
+
+        foreach (static::getSupportedApps() as $appId => $app) {
+            foreach ($app['domains'] as $domain) {
+                if (str_contains($urlLower, $domain)) {
+                    return $appId;
+                }
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * Convert standard HTTP URL to its native deep link scheme.
+     */
+    public static function convertToScheme(string $url, string $appId): string
+    {
+        // Standard fallback: replace http(s) with scheme
+        $scheme = match ($appId) {
+            'youtube' => 'youtube://',
+            'tiktok' => 'tiktok://',
+            'instagram' => 'instagram://',
+            'x' => 'twitter://',
+            'spotify' => 'spotify://',
+            'facebook' => 'fb://',
+            'reddit' => 'reddit://',
+            'snapchat' => 'snapchat://',
+            'whatsapp' => 'whatsapp://',
+            'linkedin' => 'linkedin://',
+            'pinterest' => 'pinterest://',
+            'twitch' => 'twitch://',
+            'netflix' => 'netflix://',
+            'facebook_messenger' => 'fb-messenger://',
+            'apple_music' => 'music://',
+            'airbnb' => 'airbnb://',
+            'tripadvisor' => 'tripadvisor://',
+            'amazon' => 'amazon://',
+            'stockx' => 'stockx://',
+            'booking' => 'booking://',
+            'aliexpress' => 'aliexpress://',
+            'google_sheets' => 'googlesheets://',
+            'google_docs' => 'googledocs://',
+            'google_slides' => 'googleslides://',
+            'google_maps' => 'googlemaps://',
+            default => null,
+        };
+
+        if ($scheme === null) {
+            return $url;
+        }
+
+        // Strip http:// or https://
+        $urlWithoutProtocol = preg_replace('/^https?:\/\//i', '', $url);
+
+        // Spotify URI format (special case)
+        if ($appId === 'spotify') {
+            // open.spotify.com/track/123 -> spotify:track:123
+            if (preg_match('/open\.spotify\.com\/(track|playlist|album|artist)\/([a-zA-Z0-9]+)/i', $url, $matches)) {
+                return "spotify:{$matches[1]}:{$matches[2]}";
+            }
+        }
+
+        return $scheme . $urlWithoutProtocol;
+    }
+}

src/Services/ShortUrlSettingsManager.php

@@ -96,6 +96,10 @@ class ShortUrlSettingsManager
             'vpn_block_action' => config('filament-short-url.vpn_detection.block_action', 'flag_only'),
             'safe_browsing_enabled' => config('filament-short-url.safe_browsing.enabled', false),
             'google_safe_browsing_api_key' => config('filament-short-url.safe_browsing.api_key'),
+            // Deep Linking v2.1
+            'deep_linking_enabled' => config('filament-short-url.deep_linking.enabled', false),
+            'aasa_json' => config('filament-short-url.deep_linking.aasa_json'),
+            'assetlinks_json' => config('filament-short-url.deep_linking.assetlinks_json'),
         ], $stored);
 
         return $this->cache;
@@ -176,6 +180,10 @@ class ShortUrlSettingsManager
             'vpn_block_action',
             'safe_browsing_enabled',
             'google_safe_browsing_api_key',
+            // Deep Linking v2.1
+            'deep_linking_enabled',
+            'aasa_json',
+            'assetlinks_json',
         ];
 
         $filtered = array_intersect_key($data, array_flip($keys));
@@ -275,6 +283,9 @@ class ShortUrlSettingsManager
         if (isset($filtered['safe_browsing_enabled'])) {
             $filtered['safe_browsing_enabled'] = (bool) $filtered['safe_browsing_enabled'];
         }
+        if (isset($filtered['deep_linking_enabled'])) {
+            $filtered['deep_linking_enabled'] = (bool) $filtered['deep_linking_enabled'];
+        }
 
         File::put($path, json_encode($filtered, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE));
         cache()->forget('filament-short-url:settings');
@@ -356,6 +367,10 @@ class ShortUrlSettingsManager
             'filament-short-url.vpn_detection.timeout' => 2,
             'filament-short-url.safe_browsing.enabled' => (bool) ($settings['safe_browsing_enabled'] ?? false),
             'filament-short-url.safe_browsing.api_key' => $settings['google_safe_browsing_api_key'] ?? null,
+            // Deep Linking v2.1
+            'filament-short-url.deep_linking.enabled' => (bool) ($settings['deep_linking_enabled'] ?? false),
+            'filament-short-url.deep_linking.aasa_json' => $settings['aasa_json'] ?? null,
+            'filament-short-url.deep_linking.assetlinks_json' => $settings['assetlinks_json'] ?? null,
         ]);
     }
 }

tests/Feature/ShortUrlDeepLinkingTest.php

@@ -0,0 +1,155 @@
+<?php
+
+use Bjanczak\FilamentShortUrl\Filament\Resources\ShortUrlResource\Pages\ShortUrlSettingsPage;
+use Bjanczak\FilamentShortUrl\Services\ShortUrlSettingsManager;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Support\Facades\Cache;
+
+uses(RefreshDatabase::class);
+
+beforeEach(function () {
+    // Reset config overrides
+    config([
+        'filament-short-url.deep_linking.enabled' => false,
+        'filament-short-url.deep_linking.aasa_json' => null,
+        'filament-short-url.deep_linking.assetlinks_json' => null,
+    ]);
+
+    Cache::forget('fsu:deep-linking:aasa');
+    Cache::forget('fsu:deep-linking:assetlinks');
+});
+
+it('returns 404 for deep linking endpoints when disabled', function () {
+    $this->get('/.well-known/apple-app-site-association')->assertStatus(404);
+    $this->get('/apple-app-site-association')->assertStatus(404);
+    $this->get('/.well-known/assetlinks.json')->assertStatus(404);
+});
+
+it('returns 404 for deep linking endpoints when enabled but json is empty', function () {
+    config([
+        'filament-short-url.deep_linking.enabled' => true,
+        'filament-short-url.deep_linking.aasa_json' => '',
+        'filament-short-url.deep_linking.assetlinks_json' => null,
+    ]);
+
+    $this->get('/.well-known/apple-app-site-association')->assertStatus(404);
+    $this->get('/.well-known/assetlinks.json')->assertStatus(404);
+});
+
+it('serves minified aasa and assetlinks with correct headers and caches them', function () {
+    $aasaInput = '{
+        "applinks": {
+            "apps": [],
+            "details": [
+                {
+                    "appID": "9JA89Q824A.com.example.app",
+                    "paths": [ "/s/*" ]
+                }
+            ]
+        }
+    }';
+
+    $assetlinksInput = '[{
+        "relation": ["delegate_permission/common.handle_all_urls"],
+        "target": {
+            "namespace": "android_app",
+            "package_name": "com.example.app",
+            "sha256_cert_fingerprints": ["14:6D:E9:..."]
+        }
+    }]';
+
+    config([
+        'filament-short-url.deep_linking.enabled' => true,
+        'filament-short-url.deep_linking.aasa_json' => $aasaInput,
+        'filament-short-url.deep_linking.assetlinks_json' => $assetlinksInput,
+    ]);
+
+    // Request AASA
+    $responseAasa = $this->get('/.well-known/apple-app-site-association');
+    $responseAasa->assertStatus(200)
+        ->assertHeader('Content-Type', 'application/json; charset=utf-8')
+        ->assertHeader('Cache-Control', 'max-age=604800, must-revalidate, public')
+        ->assertHeader('X-Content-Type-Options', 'nosniff')
+        ->assertHeader('Access-Control-Allow-Origin', '*');
+
+    // Verify it is minified (no spaces or newlines)
+    $minifiedAasa = json_encode(json_decode($aasaInput, true), JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
+    expect($responseAasa->getContent())->toBe($minifiedAasa);
+
+    // Verify AASA is cached
+    expect(Cache::get('fsu:deep-linking:aasa'))->toBe($minifiedAasa);
+
+    // Request AssetLinks
+    $responseAssetLinks = $this->get('/.well-known/assetlinks.json');
+    $responseAssetLinks->assertStatus(200)
+        ->assertHeader('Content-Type', 'application/json; charset=utf-8')
+        ->assertHeader('Cache-Control', 'max-age=604800, must-revalidate, public')
+        ->assertHeader('X-Content-Type-Options', 'nosniff')
+        ->assertHeader('Access-Control-Allow-Origin', '*');
+
+    $minifiedAssetLinks = json_encode(json_decode($assetlinksInput, true), JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
+    expect($responseAssetLinks->getContent())->toBe($minifiedAssetLinks);
+
+    // Verify AssetLinks is cached
+    expect(Cache::get('fsu:deep-linking:assetlinks'))->toBe($minifiedAssetLinks);
+});
+
+it('clears deep linking cache when settings page save is triggered', function () {
+    Cache::put('fsu:deep-linking:aasa', 'cached_aasa', 600);
+    Cache::put('fsu:deep-linking:assetlinks', 'cached_assetlinks', 600);
+
+    expect(Cache::has('fsu:deep-linking:aasa'))->toBeTrue();
+    expect(Cache::has('fsu:deep-linking:assetlinks'))->toBeTrue();
+
+    // Verify that calling page save logic (which invokes cache forgets) successfully clears cache
+    $page = new class extends ShortUrlSettingsPage
+    {
+        public ?array $formData = [];
+
+        public function save(): void
+        {
+            // Simulating save logic
+            app(ShortUrlSettingsManager::class)->set($this->formData);
+
+            cache()->forget('fsu:deep-linking:aasa');
+            cache()->forget('fsu:deep-linking:assetlinks');
+        }
+    };
+
+    $page->formData = [
+        'deep_linking_enabled' => true,
+        'aasa_json' => '{}',
+        'assetlinks_json' => '[]',
+    ];
+
+    $page->save();
+
+    expect(Cache::has('fsu:deep-linking:aasa'))->toBeFalse();
+    expect(Cache::has('fsu:deep-linking:assetlinks'))->toBeFalse();
+});
+
+it('redirects to the intermediate app-redirect page when auto_open_app_mobile is enabled and visited from mobile', function () {
+    $shortUrl = app(\Bjanczak\FilamentShortUrl\Services\ShortUrlService::class)->create([
+        'destination_url' => 'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
+        'url_key' => 'ytmobile',
+        'auto_open_app_mobile' => true,
+        'track_visits' => false,
+    ]);
+
+    // Visited from desktop -> should redirect directly (no intermediate page)
+    $responseDesktop = $this->get('/s/ytmobile', [
+        'User-Agent' => 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) Chrome/120.0.0.0',
+    ]);
+    $responseDesktop->assertRedirect('https://www.youtube.com/watch?v=dQw4w9WgXcQ');
+
+    // Visited from mobile (iPhone) -> should render intermediate app-redirect page
+    $responseMobile = $this->get('/s/ytmobile', [
+        'User-Agent' => 'Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 Mobile/15E148 Safari/604.1',
+    ]);
+
+    $responseMobile->assertStatus(200)
+        ->assertSee('Opening in YouTube')
+        ->assertSee('youtube://www.youtube.com/watch?v=dQw4w9WgXcQ')
+        ->assertSee('Open Native App')
+        ->assertSee('Open in Browser');
+});

tests/Feature/ShortUrlRedirectTest.php

@@ -675,3 +675,13 @@ it('enforces single_use in real-time even when model caching is active', functio
     // Second visit: should return 410, even if the model exists in the cache as enabled
     $this->get('/s/single-use-cache')->assertStatus(410);
 });
+
+it('renders custom branded expired view on deactivated URL', function () {
+    createShortUrl(['url_key' => 'disabled-view', 'is_enabled' => false, 'track_visits' => false]);
+
+    $response = $this->get('/s/disabled-view');
+    $response->assertStatus(410);
+    $response->assertSee('Link Inactive or Expired');
+    $response->assertSee('Go to Homepage');
+});
+