README

Auth Modals

Redesigns Flarum's login, sign-up and forgot-password modals with a custom side panel (background image + contextual icon), and optionally adds pill-shaped Log In / Sign Up buttons to the header for guests.

Features

• Side panel — Injected into the Log In, Sign Up and Forgot Password modals, with a contextual Font Awesome icon (lock / user-plus / envelope).
• Custom background image — Upload any image from the admin panel; rendered as a cover background on the right-side panel.
• Header buttons — Optional pill-shaped Log In / Sign Up buttons in the header secondary nav for guests, with an "or" separator.
• Colored-header aware — Buttons automatically swap to readable contrast when the forum uses a colored header.
• Dark mode — Styles included; borders and surfaces adapt to the active theme.
• Auto-save — Settings persist on every change; no submit button on the extension page.

Requirements

• Flarum ^2.0.0

Installation

composer require ramon/auth-modals
php flarum cache:clear

Then enable Auth Modals under the Extensions page in the admin panel.

Updating

composer update ramon/auth-modals --with-dependencies
php flarum cache:clear

Configuration

All settings are available in the admin panel under the Auth Modals extension:

API Endpoints

Build

cd js
npm install
npm run build

Links

• GitHub
• Issues
• Donate

Authors

• Ramon Guilherme

License

MIT