docs(users,dashboard): describe smart login-redirect fallback (#173)

CHANGELOG.md

@@ -19,6 +19,12 @@ All notable changes to this project are documented in this file. The format is b
   the resolver root, so the previous early-return excluded the very modules
   that need it. Cross-package bare imports (`maplibre-gl`, `pmtiles`, peer
   deps) now resolve in both wheel and workspace install modes (GH issue #156).
+- The `users` module's post-login redirect (`login_redirect_url`) no longer
+  hard-codes a `/` fallback when the Dashboard module isn't installed — `/`
+  404s on apps without a root route (e.g. `smpy_gis`, `--preset minimal`). It
+  now redirects to the first sibling module that exposes view routes, falling
+  back to `/` only as an absolute last resort. Operator-set overrides are
+  always preserved (GH issue #173).
 
 ## [0.0.1] — 2026-04-21
 

docs/modules/dashboard.md

@@ -69,4 +69,4 @@ Top-level keys in `dashboard/locales/en.json`:
 
 ## Replacing it
 
-If you want a different post-login landing page, set `users.login_redirect_url` in the [admin settings UI](/modules/settings) (or via `smpy settings import-from-env` from `SM_USERS_LOGIN_REDIRECT_URL`) to your route. You can keep the dashboard module installed for the menu entry, or set `SM_MODULES_ENABLED` without `dashboard` to drop it entirely. The `users` module auto-detects whether `dashboard` is installed and falls back to `/` if not.
+If you want a different post-login landing page, set `users.login_redirect_url` in the [admin settings UI](/modules/settings) (or via `smpy settings import-from-env` from `SM_USERS_LOGIN_REDIRECT_URL`) to your route. You can keep the dashboard module installed for the menu entry, or set `SM_MODULES_ENABLED` without `dashboard` to drop it entirely. The `users` module auto-detects whether `dashboard` is installed; if not, it redirects to the first other module that exposes view routes (e.g. the GIS module on apps like smpy_gis), falling back to `/` only as a last resort.

docs/modules/users.md

@@ -140,7 +140,7 @@ Everything else is DB-backed (initial values are pydantic defaults; edit at `/se
 |---|---|
 | `allow_signup` | `False` |
 | `require_verification` | `True` |
-| `login_redirect_url` | `"/dashboard/"` (auto-falls back to `/` if dashboard module isn't installed) |
+| `login_redirect_url` | `"/dashboard/"` (if the Dashboard module isn't installed, auto-falls back to the first other module that exposes view routes, or `/` only as a last resort) |
 | `reset_password_token_lifetime_seconds` | `3600` |
 | `verification_token_lifetime_seconds` | `604_800` (7 days) |
 | `cookie_name` | `"sm_auth"` |