diff --git a/src/facade/README.md b/src/facade/README.md index 5a8669e..ee6e232 100644 --- a/src/facade/README.md +++ b/src/facade/README.md @@ -116,6 +116,7 @@ These accept JSON strings for complex configuration: | Requirement | Default | Description | |---|---|---| | `login_path` | `/login.html` | Path to redirect unauthenticated users (no token in localStorage) | +| `login_redirect_param` | `""` _(off)_ | Query param name appended to `login_path` carrying the user's current relative URL, so the login flow can return them after auth. Empty disables. See [Post-login redirect](#post-login-redirect). | ### Theming @@ -204,6 +205,23 @@ Only override what differs from defaults. value: "custom:logo" ``` +### Post-login redirect + +Off by default. When enabled, the facade appends the current page's relative URL to `login_path` so the login flow can return the user to where they were after authenticating. + +```yaml + - name: login_redirect_param + value: "redirect_to" +``` + +A user opening a deep link like `/c/abc-123` without a valid token will be sent to: + +``` +/login.html?redirect_to=%2Fc%2Fabc-123 +``` + +The login page reads `redirect_to` from the query string and navigates the user there after successful auth. + ### Extra scripts Inject external `