Dashboard app: Modern as the new default theme

Author: nicozanf

apps/_dashboard/DASHBOARD_GUIDE.md

@@ -149,14 +149,15 @@ export PY4WEB_PASSWORD_FILE=password.txt
 
 ## Theming
 
-The dashboard supports multiple built-in themes (AlienDark, AlienLight, Classic) with a fully extensible theming system. Users can switch themes dynamically without page reload, with preferences persisted to the backend.
+The dashboard supports multiple built-in themes (AlienDark, AlienLight, Classic, Modern) with a fully extensible theming system. Users can switch themes dynamically without page reload, with preferences persisted to the backend.
 
 **For comprehensive theming documentation**, see [THEMES_GUIDE.md](THEMES_GUIDE.md).
 
 ### Quick Overview
 
 **Currently Available Themes:**
-- **AlienDark** - Modern dark theme with cyan accents (default)
+- **Modern** - Light activity-bar layout with green and orange accents (default)
+- **AlienDark** - Modern dark theme with cyan accents
 - **AlienLight** - Professional light theme with blue accents
 - **Classic** - Legacy-inspired dashboard appearance
 
@@ -221,14 +222,14 @@ static/themes/{ThemeName}/
 4. **Optional - Add assets:** `favicon.ico`, `widget.gif`, `templates/partials/` hook overrides
 5. **Optional - Add behavior:** `theme.js` for theme-specific JavaScript
 
-**That's it!** The theme automatically appears in the dropdown.
+**That's it!** The theme automatically appears in the settings dropdown.
 
 ### Theme Selector UI
 
-Dropdowns appear on all dashboard pages:
+Theme selector dropdown is rendered in the settings page (`templates/settings.html`) and synchronized through `data-theme-selector`:
 
 ```html
-<select id="dashboard-theme-select" data-theme-selector onchange="setDashboardTheme(this.value)">
+<select id="theme-select" data-theme-selector onchange="setDashboardTheme(this.value)">
   [[for theme in themes:]]
     <option value="[[=theme]]">[[=theme]]</option>
   [[pass]]
@@ -277,7 +278,7 @@ Theme selection is saved in two places:
 
 1. **Backend** - `apps/_dashboard/user_settings.toml`
    ```toml
-   selected_theme = "AlienDark"
+  selected_theme = "Modern"
    ```
    Survives browser cache clear / private browsing
 
@@ -287,7 +288,9 @@ Theme selection is saved in two places:
 **Selection Priority:**
 1. Backend setting (from `user_settings.toml`)
 2. Browser storage (from localStorage)
-3. Default theme (AlienDark if available, else first alphabetically)
+3. Default theme (Modern if available, else first alphabetically)
+
+Backend persistence is attempted only for authenticated sessions (`USER_ID` available). Without login, selection remains in localStorage only.
 
 Themes should not ship full-page replacements for the dashboard main pages; keep the main `index.html` in `apps/_dashboard/templates/` and use `templates/partials/` hooks for small structural overrides.
 

apps/_dashboard/THEMES_GUIDE.md

@@ -6,7 +6,8 @@ The `_dashboard` app supports dynamic theme switching with persisted user prefer
 Themes are discovered from `static/themes/` and can be switched without a page reload.
 
 Current built-in themes:
-- **AlienDark** (default dark UI)
+- **Modern** (default light activity-bar UI with green primary and orange highlight accents)
+- **AlienDark** (dark UI)
 - **AlienLight** (light UI)
 - **Classic** (legacy-inspired dashboard style)
 
@@ -110,9 +111,14 @@ Key responsibilities:
 - load optional `theme.js`
 - persist selection via `POST ../save_theme`
 - keep all selectors (`[data-theme-selector]`) synchronized
+- expose shared helpers through `window.DashboardThemeUtils`
 
 Public API:
 - `window.setDashboardTheme(theme)`
+- `window.DashboardThemeUtils.getDashboardBaseUrl()`
+- `window.DashboardThemeUtils.getDashboardRelativeBase()`
+- `window.DashboardThemeUtils.getDashboardViewUrl(appName, view)`
+- `window.DashboardThemeUtils.getActiveThemeName()`
 
 ---
 
@@ -130,9 +136,9 @@ Key functions:
 
 Backend normalization guarantees that stale values (for example removed themes) do not break rendering.
 If a stored theme is unavailable:
-1. use `AlienDark` if present
-2. otherwise use the first available theme
-3. otherwise fall back to `AlienDark`
+1. use `Modern` if present
+2. otherwise use the first theme alphabetically
+3. otherwise fall back to `Modern`
 
 `save_theme` also validates that the requested theme exists.
 
@@ -167,12 +173,20 @@ In dashboard templates, keep these elements:
 
 ```html
 <script>
-  var SELECTED_THEME = '[[= selected_theme or "AlienDark" ]]';
+  var SELECTED_THEME = '[[= selected_theme or "Modern" ]]';
 </script>
 
-<link id="dashboard-theme" rel="stylesheet" href="themes/[[= selected_theme or 'AlienDark' ]]/theme.css">
+<link id="dashboard-theme" rel="stylesheet" href="themes/[[= selected_theme or 'Modern' ]]/theme.css">
+```
+
+Theme selector dropdowns are optional and are currently rendered in:
+
+- `apps/_dashboard/templates/settings.html`
 
-<select id="dashboard-theme-select" data-theme-selector onchange="setDashboardTheme(this.value)">
+Selector example used in settings:
+
+```html
+<select id="theme-select" name="theme" data-theme-selector onchange="setDashboardTheme(this.value)">
   [[for theme in themes:]]
     <option value="[[=theme]]" [[='selected' if theme == selected_theme else '']]>[[=theme]]</option>
   [[pass]]
@@ -211,6 +225,8 @@ No backend code changes are required.
 - verify `POST ../save_theme` succeeds
 - check `apps/_dashboard/user_settings.toml` is writable
 
+If the user is not logged in, theme changes still apply in the browser and are stored in localStorage, but backend persistence is skipped.
+
 ### Theme script not running
 - verify `theme.js` exists and has valid JavaScript
 - check browser console for syntax/runtime errors
@@ -221,3 +237,4 @@ No backend code changes are required.
 
 - The dashboard uses canonical page templates plus optional hook partials.
 - Theme-specific customization should stay primarily in `theme.css` and optional `theme.js`; use hook partials only for small structural differences.
+- Keep shared behavior helpers in `apps/_dashboard/static/js/theme-selector.js` and shared dashboard JS files, not duplicated in individual themes.

apps/_dashboard/__init__.py

@@ -115,13 +115,13 @@ def change_password_handler(old_password, new_password):
 def load_user_settings():
     """Load user settings from user_settings.toml"""
     settings_file = os.path.join(settings.APP_FOLDER, "user_settings.toml")
-    default_settings = {"selected_theme": "AlienDark"}
+    default_settings = {"selected_theme": "Modern"}
 
     if not os.path.exists(settings_file):
         # Create default settings file
         try:
             with open(settings_file, "w") as fp:
-                fp.write('selected_theme = "AlienDark"\n')
+                fp.write('selected_theme = "Modern"\n')
             return default_settings
         except Exception:
             return default_settings
@@ -179,11 +179,11 @@ def normalize_selected_theme(selected_theme, available_themes=None):
     themes = available_themes if available_themes is not None else get_available_themes()
     if selected_theme and selected_theme in themes:
         return selected_theme
-    if "AlienDark" in themes:
-        return "AlienDark"
+    if "Modern" in themes:
+        return "Modern"
     if themes:
         return themes[0]
-    return "AlienDark"
+    return "Modern"
 
 
 def _safe_name(value):
@@ -233,6 +233,26 @@ def build_theme_partials(selected_theme, partial_names):
     }
 
 
+def get_system_info_payload():
+    """Collect system and loaded module version information."""
+    os_info = f"{platform.system()} {platform.release()}"
+    items = [
+        {"name": "os", "version": os_info},
+        {"name": "py4web", "version": __version__},
+        {"name": "python", "version": sys.version},
+    ]
+    for module in sorted(sys.modules):
+        if "." in module:
+            continue
+        try:
+            imported = __import__(module)
+            if "__version__" in dir(imported):
+                items.append({"name": module, "version": imported.__version__})
+        except ImportError:
+            pass
+    return items
+
+
 session = Session()
 T = Translator(settings.T_FOLDER)
 authenticated = ActionFactory(Logged(session))
@@ -252,7 +272,7 @@ def index():
         themes = get_available_themes()
         user_settings = load_user_settings()
         selected_theme = normalize_selected_theme(
-            user_settings.get("selected_theme", "AlienDark"), themes
+            user_settings.get("selected_theme", "Modern"), themes
         )
         theme_partials = build_theme_partials(selected_theme, ["index_header_actions"])
 
@@ -315,26 +335,46 @@ def save_theme():
         user_settings["selected_theme"] = theme
         return save_user_settings(user_settings)
 
+    @action("settings")
+    @action.uses(Logged(session), "settings.html")
+    @catch_errors
+    def settings_page():
+        themes = get_available_themes()
+        user_settings = load_user_settings()
+        selected_theme = normalize_selected_theme(
+            user_settings.get("selected_theme", "Modern"), themes
+        )
+        return dict(
+            themes=themes,
+            selected_theme=selected_theme,
+            message="",
+            message_type="",
+        )
+
     @action("tickets/search")
     @action.uses(Logged(session), "dbadmin.html")
     def dbadmin():
         db = error_logger.database_logger.db
         themes = get_available_themes()
         user_settings = load_user_settings()
         selected_theme = normalize_selected_theme(
-            user_settings.get("selected_theme", "AlienDark"), themes
+            user_settings.get("selected_theme", "Modern"), themes
         )
         theme_partials = build_theme_partials(
             selected_theme, ["dbadmin_nav", "dbadmin_footer_back"]
         )
+        filter_app = request.query.get("app_name", "").strip()
 
         def make_grid():
             make_safe(db)
             table = db.py4web_error
+            query = (table.app_name == filter_app) if filter_app else table
             columns = [field for field in table if not field.name == "snapshot"]
             return Grid(
-                table,
+                query,
                 columns=columns,
+                search_queries=None,
+                create=False,
                 details=False,
                 editable=False,
                 pre_action_buttons=[
@@ -348,7 +388,7 @@ def make_grid():
 
         grid = action.uses(db)(make_grid)()
         return dict(
-            app_name="",
+            app_name=filter_app,
             table_name="py4web_error",
             grid=grid,
             themes=themes,
@@ -362,7 +402,7 @@ def dbadmin(app_name, db_name, table_name):
         themes = get_available_themes()
         user_settings = load_user_settings()
         selected_theme = normalize_selected_theme(
-            user_settings.get("selected_theme", "AlienDark"), themes
+            user_settings.get("selected_theme", "Modern"), themes
         )
         theme_partials = build_theme_partials(
             selected_theme, ["dbadmin_nav", "dbadmin_footer_back"]
@@ -415,22 +455,21 @@ def make_grid():
     @session_secured
     @catch_errors
     def info():
-        # Start with OS information
-        os_info = f"{platform.system()} {platform.release()}"
-        vars = [
-            {"name": "os", "version": os_info},
-            {"name": "py4web", "version": __version__},
-            {"name": "python", "version": sys.version}
-        ]
-        for module in sorted(sys.modules):
-            if not "." in module:
-                try:
-                    m = __import__(module)
-                    if "__version__" in dir(m):
-                        vars.append({"name": module, "version": m.__version__})
-                except ImportError:
-                    pass
-        return {"status": "success", "payload": vars}
+        return {"status": "success", "payload": get_system_info_payload()}
+
+    @action("system_info")
+    @action.uses(Logged(session), "system_info.html")
+    def system_info_page():
+        themes = get_available_themes()
+        user_settings = load_user_settings()
+        selected_theme = normalize_selected_theme(
+            user_settings.get("selected_theme", "Modern"), themes
+        )
+        return dict(
+            info_items=get_system_info_payload(),
+            themes=themes,
+            selected_theme=selected_theme,
+        )
 
     @action("routes")
     @session_secured
@@ -703,7 +742,21 @@ def packed(path):
     def tickets():
         """Returns most recent tickets grouped by path+error"""
         tickets = safely(error_logger.database_logger.get) if MODE != "DEMO" else None
-        return {"payload": tickets or [], "status": "success"}
+        total_count = 0
+        if MODE != "DEMO":
+            total_count = safely(
+                lambda: error_logger.database_logger.db(
+                    error_logger.database_logger.db.py4web_error
+                ).count()
+            ) or 0
+        return {"payload": tickets or [], "total_count": total_count, "status": "success"}
+
+    @action("tickets/delete_all", method=["POST"])
+    @action.uses(Logged(session))
+    def delete_all_tickets():
+        if MODE != "demo":
+            safely(error_logger.database_logger.clear)
+        redirect(URL("tickets/search"))
 
     @action("clear")
     @session_secured
@@ -718,17 +771,21 @@ def error_ticket(ticket_uuid):
         themes = get_available_themes()
         user_settings = load_user_settings()
         selected_theme = normalize_selected_theme(
-            user_settings.get("selected_theme", "AlienDark"), themes
+            user_settings.get("selected_theme", "Modern"), themes
+        )
+        theme_partials = build_theme_partials(
+            selected_theme, ["dbadmin_nav", "dbadmin_footer_back"]
         )
         if MODE != "demo":
             return dict(
                 ticket=safely(
                     lambda: error_logger.database_logger.get(ticket_uuid=ticket_uuid)
                 ),
-                selected_theme=selected_theme
+                selected_theme=selected_theme,
+                theme_partials=theme_partials,
             )
         else:
-            return dict(ticket=None, selected_theme=selected_theme)
+            return dict(ticket=None, selected_theme=selected_theme, theme_partials=theme_partials)
 
     @action("rest/<path:path>", method=["GET", "POST", "PUT", "DELETE"])
     @session_secured
@@ -921,8 +978,16 @@ def new_app():
     def gitlog(project):
         themes = get_available_themes()
         user_settings = load_user_settings()
+        selected_theme = normalize_selected_theme(
+            user_settings.get("selected_theme", "Modern"), themes
+        )
         if not is_git_repo(os.path.join(FOLDER, project)):
-            return "Project is not a GIT repo"
+            return dict(
+                status="error",
+                error="Project is not a GIT repo",
+                project=project,
+                selected_theme=selected_theme,
+            )
         branches = get_branches(cwd=os.path.join(FOLDER, project))
         commits = get_commits(cwd=os.path.join(FOLDER, project))
         return dict(
@@ -931,9 +996,7 @@ def gitlog(project):
             checkout=checkout,
             project=project,
             branches=branches,
-            selected_theme=normalize_selected_theme(
-                user_settings.get("selected_theme", "AlienDark"), themes
-            ),
+            selected_theme=selected_theme,
         )
 
     @authenticated.callback()
@@ -987,7 +1050,7 @@ def translations(name):
     return dict(
         languages=t.languages,
         selected_theme=normalize_selected_theme(
-            user_settings.get("selected_theme", "AlienDark"), themes
+            user_settings.get("selected_theme", "Modern"), themes
         ),
     )