ernestdefoe / mobile-tab
A configurable mobile bottom tab bar for Flarum 2.x — build your own tabs (icon, label, destination), a raised center action, and a logo/favicon slot.
Package info
github.com/ernestdefoe/mobiletab
Language:Less
Type:flarum-extension
pkg:composer/ernestdefoe/mobile-tab
Requires
- flarum/core: ^2.0
README
A configurable mobile bottom tab bar for Flarum 2.x. On phones, a native-app-style bar is pinned to the bottom of the screen; on tablet and desktop it's hidden.
Features
- 🧱 Full custom tab editor — build the bar yourself in admin: add, remove, and reorder tabs.
- 🎛️ Per-tab settings — each tab has a type, a Font Awesome icon, a label, a visibility (everyone / logged-in / logged-out), and an optional raised flag (the lifted center button).
- 🧩 Tab types — Home, Tags, Search, Notifications, Profile (avatar menu), New discussion, Log in, Site logo, Favicon, or a custom link (internal route or external URL).
- 🖼️ Logo / favicon in the middle — drop a Site logo or Favicon tile anywhere, including the raised center slot.
- 🔢 Live unread badge on the Notifications tab, active-route highlighting, and a
html.has-mobile-tabhook for themes that need to shift content above the bar.
Leave the tab list empty to use the sensible default bar (Home · Tags · + · Notifications · Profile).
Installation
composer require ernestdefoe/mobile-tab php flarum cache:clear
Enable it in Admin → Extensions, then configure the bar under its settings.
Configuring the bar
Open the extension's settings page and use the Bottom bar tabs editor:
- Add tab to append a row, or reorder with the ▲ ▼ arrows.
- Pick a type, set an icon (e.g.
fas fa-home) and label. - Choose visibility and tick Raised for the center action.
- For Custom link, enter a path (
/tags/support) or URL (https://…). - Save Changes. (Site logo / Favicon types pull your site image automatically.)
Credits
Originally created by resofire. Rebranded and extended (configurable tab editor, logo/favicon slots) by ernestdefoe, with full credit to the original author.
License
MIT — © ResofireV2 (original author).