Skip to content

Configuration ​

auth_pages ​

Primary config for auth pages. Override in modularous/auth_pages.php or merge into config/modularous.php.

Top-Level Keys ​

KeyTypeDescription
component_namestringAuth component to use: ue-auth (package default) or ue-custom-auth
layoutarrayDefault layout attributes (e.g. logoSymbol, logoLightSymbol)
attributesarrayGlobal attributes passed to all auth pages
pagesarrayPer-page definitions (login, register, forgot_password, etc.)
layoutPresetsarrayReusable structural presets (banner, minimal)

Example: modularous/auth_pages.php ​

php
<?php

return [
    'component_name' => 'ue-custom-auth',
    'attributes' => [
        'bannerDescription' => __('authentication.banner-description'),
        'bannerSubDescription' => __('authentication.banner-sub-description'),
        'redirectButtonText' => __('authentication.redirect-button-text'),
    ],
];

Deferred Loading ​

When using __() or ___() in attributes, load auth config via defers so the translator is available:

  • config/defers/auth_pages.php — merged by LoadLocalizedConfig middleware
  • Or use modularous/auth_pages.php which is typically loaded after translator

auth_component ​

UI and styling config. Passed to Vue via window.__MODULAROUS_AUTH_CONFIG__.

KeyTypeDescription
formWidtharrayForm width by breakpoint (xs, sm, md, lg, xl, xxl)
layoutarrayColumn classes for custom auth layouts
bannerarrayBanner section classes (titleClass, buttonClass)
dividerTextstringText between form and bottom slots (e.g. "or")
useLegacyboolWhen true, use UeCustomAuth (legacy design)

Example: auth_component formWidth ​

php
'formWidth' => [
    'xs' => '85vw',
    'sm' => '450px',
    'md' => '450px',
    'lg' => '500px',
    'xl' => '600px',
    'xxl' => 700,
],