Warp Mobile changelog
Update with composer update qalainau/filament-warp-mobile, then run php artisan filament:assets.
1.0.0 Nov 20, 2026
Added
- Bottom tab bar for phones: the first four pages of the panel's navigation plus More (opens the panel's menu), or your own tabs with
MobileTab(resource, page or URL, icon, active icon, badge, visibility, active rule). Hides while the keyboard is open, optionally while scrolling down. More is marked as the current tab on pages that are inside its list or the panel's menu. - Home screen app (on by default,
->homeScreenApp(...)): a web app manifest (name, icon,start_urlandscope= the panel's URL,display: standalone) and the iPhone meta tags, so that an app added to an iPhone's home screen stays in its own window instead of opening every link in a Safari window on top. When opened from the home screen, the viewport getsviewport-fit=cover, so the tab bar and the floating button clear the home indicator. The viewport is added again after eachwire:navigatepage change, and in landscape the page, sidebar, top bar, bottom bar, floating button and modals keep clear of the notch. Nothing is output when the same panel uses Warp Offline's->pwa(). - Back button in the top bar on pages that are not tabs (edit, create, view), for home-screen apps that have no browser back button.
$table->mobileCards()turns table rows into cards on phones; give columns a role withmobileTitle(),mobileSubtitle(),mobileBadge(),mobileAvatar(),mobileMeta()andmobileHidden().mobileCards()andswipeActions()work on a Warp Table (->warp(), 1.5.0 or later): below the breakpoint the table is Filament's own table with the cards; on wider screens it is the canvas. See “With Warp Table” in the README.Action::floatingOnMobile()shows a header action as a round button in the bottom corner on phones; the page gets room at the bottom so the last card and the pagination are not under it.->touchTargets()makes buttons, links, checkboxes and pagination at least 44px tall on phones.->breakpoint('sm' | 'md' | 'lg')chooses below which width all of this applies (defaultmd, 768px). Wider screens are not changed.$table->swipeActions(leading: [...], trailing: [...], fullSwipe: true)lets people swipe a card sideways on phones to reveal its row actions (up to three per side, picked by name fromrecordActions(), also inside anActionGroup). The buttons are the Filament actions themselves, so visibility, authorization, confirmation and URLs work as defined. Swiping all the way runs the first action. Buttons are as wide as their labels (72–112px, at most 80% of the row per side). Works in right-to-left languages.- Pull to refresh (on by default): pulling down at the top of a page refreshes its Livewire components without reloading, so half-typed input stays. Turn it off with
->pullToRefresh(false), reload the whole page with->pullToRefresh(reload: true), skip pages withexcept: [...]orpublic static bool $warpMobilePullToRefresh = false. Not active over canvases, maps,[data-warp-mobile-no-pull], open modals or while offline (it says so instead). Listen to thewarp-mobile:refreshbrowser event to refresh your own widgets. - Bottom sheets (on by default,
->bottomSheets(false)to turn off): on phones, modals slide up from the bottom with a grab handle and full-width buttons. Drag the handle or heading down to close a modal that can be closed by clicking away. ->mouseGestures()lets the mouse drive swipes, pull to refresh and bottom sheets too (for demos in a phone frame); a slow mouse drag over a card's link does not start the browser's link drag.- Cards: tapping anywhere on a card opens the record. The row actions sit on their own line at the bottom right of the card, so the title and the Label: value lines use the card's whole width (when the actions took a column on the right, a date broke into 2–4 lines at 390px).
- Swipes on tables drawn by other code: rows marked with
data-fi-warp-mobile-swipe-rowinsidedata-fi-warp-mobile-swipe-tableswipe with the same script and styles, andSwipeActions::namesFor($table)reads back the names ofswipeActions(). Warp Offline uses this to show the cards and swipes in its offline list. - Swipes do not start inside a box that scrolls sideways in a card (a code block, a wide table): the box scrolls instead.
- With More shown, the ≡ button in the top bar is hidden on phones in panels with
->topNavigation()and Warp Mega Menu too (Mega Menu's own ≡, the menu drawer button, stayed next to More; the logo now shows in its place). With Mega Menu, More opens Mega Menu's drawer (search, favorites, groups) instead of the sidebar; without the drawer (->mobileDrawer(false)) it opens the sidebar. Without More the ≡ stays. - Works in panels with Filament's tenancy: pages before a tenant is chosen (registering or choosing a tenant) are left alone and the tab bar is not drawn there.
- Static analysis: the methods added with
macro()(->mobileCards(),->swipeActions(),->mobileTitle(),->floatingOnMobile()…) are known to Larastan: the plugin shipsextension.neon, a PHPStan extension that reads Filament's macros (loaded automatically withphpstan/extension-installer; otherwise add it toincludes). See “Static analysis” in the README. - Right-to-left languages, dark mode and the ten languages of the other Warp plugins (en, ja, de, fr, es, it, pt_BR, ko, zh_CN, zh_TW).