@axzydev/axzy_ui_system 1.4.2 → 1.4.4

package/package.json

@@ -4,7 +4,7 @@
   "packageManager": "pnpm@10.34.0",
   "private": false,
   "license": "MIT",
-  "version": "1.4.2",
+  "version": "1.4.4",
   "type": "module",
   "sideEffects": [
     "*.css"

package/src/components/molecules/card/card.tsx

@@ -2,6 +2,7 @@ import clsx from "clsx";
 import { ITCardProps } from "./card.props";
 import { useState } from "react";
 import ITText from "@/components/atoms/text/text";
+import { useITFlatAppearance } from "@/theme/theme-context";
 
 /**
  * Versatile card container with optional image, title, body content, and action footer. Supports interactive hover states.
@@ -30,21 +31,33 @@ export default function ITCard({
   onClick,
 }: ITCardProps) {
   const [isHovered, setIsHovered] = useState(false);
+  const flat = useITFlatAppearance();
 
   const containerStyle: React.CSSProperties = {
     backgroundColor: "var(--it-card-bg, #ffffff)",
-    borderColor: "var(--it-card-border, rgba(15, 23, 42, 0.06))",
+    borderColor: flat
+      ? "var(--it-card-flat-border, var(--color-secondary-200))"
+      : "var(--it-card-border, rgba(15, 23, 42, 0.06))",
     borderWidth: "1px",
-    borderRadius: "var(--it-card-radius, var(--radius-2xl))",
+    borderStyle: "solid",
+    borderRadius: flat
+      ? "var(--it-card-radius, var(--radius-lg))"
+      : "var(--it-card-radius, var(--radius-2xl))",
     // Soft depth: every card floats a little at rest; interactive cards
     // gain visual weight on hover instead of appearing flat until clicked.
-    boxShadow: onClick
-      ? isHovered
-        ? "var(--shadow-lg)"
-        : "var(--shadow-sm)"
-      : "var(--shadow-sm)",
+    // Flat appearance: the hairline border carries the surface, so a card
+    // only gets a shadow as hover feedback when it is clickable.
+    boxShadow: flat
+      ? onClick && isHovered
+        ? "var(--shadow-sm)"
+        : "none"
+      : onClick
+        ? isHovered
+          ? "var(--shadow-lg)"
+          : "var(--shadow-sm)"
+        : "var(--shadow-sm)",
     transition: onClick ? "box-shadow 0.2s ease-in-out, transform 0.2s ease-in-out" : "none",
-    transform: onClick && isHovered ? "translateY(-2px)" : "translateY(0)",
+    transform: onClick && isHovered && !flat ? "translateY(-2px)" : "translateY(0)",
     cursor: onClick ? "pointer" : "default",
   };
 
@@ -72,7 +85,7 @@ export default function ITCard({
         {title && (
           <ITText
             as="h3"
-            className={clsx("text-xl font-semibold mb-2", titleClassName)}
+            className={clsx(flat ? "text-base font-semibold mb-3" : "text-xl font-semibold mb-2", titleClassName)}
           >
             {title}
           </ITText>

package/src/components/organisms/page-header/page-header.tsx

@@ -2,6 +2,7 @@ import { FaChevronLeft } from "react-icons/fa";
 import { ITPageHeaderProps } from "./page-header.props";
 import ITBreadcrumbs from "@/components/molecules/breadcrumbs/breadcrumbs";
 import ITText from "@/components/atoms/text/text";
+import { useITFlatAppearance } from "@/theme/theme-context";
 
 /**
  * Page title bar with breadcrumbs, description, back button, and action buttons.
@@ -29,6 +30,8 @@ export default function ITPageHeader({
   className,
 }: ITPageHeaderProps) {
   const showTopRow = breadcrumbs?.length || backAction;
+  // Flat appearance: compact title, no decorative icon tile.
+  const flat = useITFlatAppearance();
 
   return (
     <div className={`${className} space-y-3`}>
@@ -60,7 +63,7 @@ export default function ITPageHeader({
       {/* Fila principal: icono + título + descripción + (acciones si no hay top row) */}
       <div className="flex items-start justify-between gap-6">
         <div className="flex items-start gap-4 min-w-0">
-          {icon && (
+          {icon && !flat && (
             <div
               className="flex items-center justify-center w-12 h-12 rounded-full border border-slate-200 dark:border-slate-700 bg-slate-50/50 dark:bg-slate-800/50 text-slate-600 dark:text-slate-300 flex-shrink-0 transition-all duration-200 hover:border-slate-300 dark:hover:border-slate-500 hover:shadow-sm"
               style={iconColor ? { color: iconColor } : undefined}
@@ -71,14 +74,22 @@ export default function ITPageHeader({
           <div className="min-w-0">
             <ITText
               as="h1"
-              className="text-3xl font-bold text-slate-800 dark:text-white tracking-tight leading-tight"
+              className={
+                flat
+                  ? "text-[1.625rem] font-bold text-slate-900 dark:text-white tracking-tight leading-tight"
+                  : "text-3xl font-bold text-slate-800 dark:text-white tracking-tight leading-tight"
+              }
             >
               {title}
             </ITText>
             {description && (
               <ITText
                 as="p"
-                className="text-sm font-light text-slate-500 dark:text-slate-400 mt-1 leading-relaxed"
+                className={
+                  flat
+                    ? "text-sm font-normal text-slate-500 dark:text-slate-400 mt-0.5 leading-relaxed"
+                    : "text-sm font-light text-slate-500 dark:text-slate-400 mt-1 leading-relaxed"
+                }
               >
                 {description}
               </ITText>

package/src/components/organisms/sidebar/sidebar.doc.mdx

@@ -21,6 +21,8 @@ Vertical navigation sidebar with collapsible submenus, tooltips when collapsed,
 | `className` | `string` | — | Additional CSS classes on the sidebar `<aside>`. |
 | `header` | `ReactNode` | — | Optional content rendered above the navigation list (e.g. a wordmark). Hidden while the sidebar is collapsed, so it only appears when the hover-expanded rail is shown. |
 | `notification` | `ITSidebarNotification` | — | Optional notification entry (icon + label + `ITBadget` counter) pinned above the navigation. Unlike `header`, it stays visible while collapsed, showing only the icon and counter. |
+| `brand` | `ITSidebarBrand` | — | Brand (`logo` + `text`) pinned in a 64px row at the very top. The logo stays visible while collapsed; the text does not. `ITLayout` fills it from `topBar.logo` / `topBar.logoText` when `sidebarFullHeight` is set. |
+| `expandOnHover` | `boolean` | `true` | `true`: the collapsed rail expands over the content on hover. `false`: it stays an icon-only rail (item name in a tooltip) and only opens through `onToggleCollapse` — the top bar menu button in `ITLayout`. Clicking a collapsed parent item opens the sidebar with that group expanded. |
 
 ### ITNavigationItem
 

package/src/components/organisms/sidebar/sidebar.props.ts

@@ -86,14 +86,36 @@ export interface ITSidebarNotification {
   badgeProps?: ITBadgetProps;
 }
 
+/**
+ * Brand block pinned at the top of {@link ITSidebarProps}. The logo stays
+ * visible while the rail is collapsed; the text only shows when expanded.
+ */
+export interface ITSidebarBrand {
+  /** Logo element (e.g. an `<img>` or an SVG mark). Always visible. */
+  logo?: React.ReactNode;
+  /** Wordmark rendered next to the logo. Hidden while the sidebar is collapsed. */
+  text?: string;
+}
+
 /** Props for the ITSidebar vertical navigation component. */
 export interface ITSidebarProps {
   /** Navigation structure: top-level items with optional sub-items. */
   navigationItems: ITNavigationItem[];
   /** Whether the sidebar is collapsed to icon-only mode. */
   isCollapsed?: boolean;
-  /** Callback when the user toggles collapse via the toggle button. */
+  /**
+   * Callback that flips `isCollapsed`. `ITLayout` calls it from the top bar's
+   * menu button when `expandOnHover` is `false`; the sidebar itself calls it
+   * when a collapsed parent item is clicked, so its submenu can be shown.
+   */
   onToggleCollapse?: () => void;
+  /**
+   * How the collapsed rail opens. `true`: it expands over the content while
+   * the pointer is on it (no button). `false`: it stays an icon-only rail —
+   * the item name shows in a tooltip on hover — and it only opens through
+   * `onToggleCollapse` (the top bar's menu button in `ITLayout`). @default true
+   */
+  expandOnHover?: boolean;
   /** Force sidebar visible on mobile breakpoints. */
   visibleOnMobile?: boolean; 
   /** Callback when a top-level navigation item is clicked. Receives the item. */
@@ -115,5 +137,11 @@ export interface ITSidebarProps {
    * while collapsed, showing just the icon and the counter.
    */
   notification?: ITSidebarNotification;
+  /**
+   * Brand (logo + wordmark) pinned at the very top of the sidebar, in a 64px
+   * row that lines up with the top bar. Unlike {@link ITSidebarProps.header}
+   * the logo stays visible while collapsed. `ITLayout` fills it from
+   * `topBar.logo` / `topBar.logoText` when `sidebarFullHeight` is set.
+   */
+  brand?: ITSidebarBrand;
 }
-

package/src/components/organisms/sidebar/sidebar.tsx

@@ -10,6 +10,7 @@ import {
 } from "./sidebar.props";
 import ITBadget from "@/components/atoms/badget/badget";
 import ITText from "@/components/atoms/text/text";
+import { useITFlatAppearance } from "@/theme/theme-context";
 
 /** Narrows a submenu entry to a titled group. */
 function isSubItemGroup(
@@ -66,7 +67,12 @@ export default function ITSidebar({
   subitemConnector = 'dot',
   header,
   notification,
+  brand,
+  onToggleCollapse,
+  expandOnHover = true,
 }: ITSidebarProps) {
+  // Flat appearance: plain surface, no glow/accent bar, narrower panel.
+  const flat = useITFlatAppearance();
   const [expandedItems, setExpandedItems] = useState<Set<string>>(new Set());
   const [isHovering, setIsHovering] = useState(false);
   const sidebarRef = useRef<HTMLDivElement>(null);
@@ -128,6 +134,13 @@ export default function ITSidebar({
     }
   }, [navigationItems]);
 
+  const isSidebarCollapsed = visibleOnMobile ? false : isCollapsed && !(expandOnHover && isHovering);
+  const sidebarWidth = isSidebarCollapsed
+    ? flat ? "w-[72px]" : "w-[88px]"
+    : flat ? "w-[248px]" : "w-[280px]";
+  // Icon-only rail that never expands on hover: names show in a tooltip.
+  const fixedRail = isSidebarCollapsed && !expandOnHover;
+
   const toggleExpanded = (itemId: string) => {
     const newExpanded = new Set(expandedItems);
     if (newExpanded.has(itemId)) newExpanded.delete(itemId);
@@ -137,15 +150,20 @@ export default function ITSidebar({
 
   const handleItemClick = (item: ITNavigationItem) => {
     if (item.subitems && item.subitems.length > 0) {
-      toggleExpanded(item.id);
+      if (isSidebarCollapsed && !expandOnHover) {
+        // Icon-only rail: there is no room for the submenu, so open the
+        // sidebar with this group expanded.
+        setExpandedItems((prev) => new Set(prev).add(item.id));
+        onToggleCollapse?.();
+      } else {
+        toggleExpanded(item.id);
+      }
     } else {
       if (item.action) item.action();
       if (onItemClick) onItemClick(item);
     }
   };
 
-  const isSidebarCollapsed = visibleOnMobile ? false : (!isHovering && isCollapsed);
-  const sidebarWidth = isSidebarCollapsed ? "w-[88px]" : "w-[280px]";
 
   const renderSubItem = (subitem: ITNavigationSubItem) => (
     <li key={subitem.id} className="relative">
@@ -159,7 +177,7 @@ export default function ITSidebar({
         style={{
           color: subitem.isActive ? "var(--it-sidebar-active-color, var(--color-secondary-900))" : "var(--it-sidebar-label-color, var(--color-secondary-600))",
           backgroundColor: subitem.isActive ? "var(--it-sidebar-active-bg, var(--color-secondary-50))" : 'transparent',
-          fontSize: '0.78rem',
+          fontSize: flat ? '0.84rem' : '0.78rem',
           fontWeight: subitem.isActive ? 600 : 500,
           letterSpacing: '0.01em',
           marginLeft: subitemConnector === '|' ? '-1px' : '0',
@@ -177,7 +195,7 @@ export default function ITSidebar({
           }
         }}
       >
-        {subitem.isActive && subitemConnector === '|' && (
+        {subitem.isActive && subitemConnector === '|' && !flat && (
           <div
             className="absolute left-0 top-1/3 bottom-1/3 w-[2.5px] rounded-r-full transition-all"
             style={{
@@ -318,16 +336,32 @@ export default function ITSidebar({
         ${sidebarWidth}
         ${className}
         ${!visibleOnMobile ? "hidden lg:flex" : "flex"}
-        shadow-[4px_0_32px_rgba(15,23,42,0.04)]
+        ${flat ? "" : "shadow-[4px_0_32px_rgba(15,23,42,0.04)]"}
       `}
       style={{
         zIndex: 50,
         backgroundColor: "var(--it-sidebar-bg, rgba(255, 255, 255, 0.90))",
         borderRight: "1px solid var(--it-sidebar-border, var(--color-secondary-200))",
-        WebkitBackdropFilter: 'blur(12px)',
-        backdropFilter: 'blur(12px)',
+        ...(flat ? {} : { WebkitBackdropFilter: 'blur(12px)', backdropFilter: 'blur(12px)' }),
       }}
     >
+      {brand && (brand.logo || brand.text) && (
+        <div
+          className={`flex items-center flex-shrink-0 h-[64px] ${isSidebarCollapsed ? "justify-center px-2" : "gap-2.5 px-7"}`}
+        >
+          {brand.logo && <div className="flex-shrink-0 flex items-center">{brand.logo}</div>}
+          {brand.text && !isSidebarCollapsed && (
+            <ITText
+              as="span"
+              className="text-[1.05rem] font-bold tracking-tight truncate"
+              style={{ color: "var(--it-sidebar-brand-color, var(--it-sidebar-label-color, var(--color-secondary-900)))" }}
+            >
+              {brand.text}
+            </ITText>
+          )}
+        </div>
+      )}
+
       {header && !isSidebarCollapsed && (
         <div className="px-4 pt-4 pb-1 flex-shrink-0">{header}</div>
       )}
@@ -337,12 +371,15 @@ export default function ITSidebar({
       )}
 
       {/* Navigation Items */}
-      <nav aria-label="Componentes de la librería" className="flex-1 py-4 overflow-y-auto overflow-x-hidden custom-scrollbar px-4">
+      <nav aria-label="Componentes de la librería" className={`flex-1 py-4 custom-scrollbar ${fixedRail ? "overflow-visible" : "overflow-y-auto overflow-x-hidden"} ${flat && isSidebarCollapsed ? "px-3" : "px-4"}`}>
         <ul className="space-y-1">
           {navigationItems.map((item) => {
             const hasSubmenu = !!item.subitems && item.subitems.length > 0;
             const submenuId = `it-sidebar-submenu-${item.id}`;
             const { className: badgeClassName, ...badgeRest } = item.badgeProps ?? {};
+            // Flat + expanded: a parent whose subitem is active stays plain; the
+            // subitem carries the highlight. Collapsed, the parent icon shows it.
+            const active = !!item.isActive && !(flat && hasSubmenu && !isSidebarCollapsed);
             return (
             <li key={item.id} className="relative group/navitem">
               <div
@@ -354,18 +391,18 @@ export default function ITSidebar({
                 className={`flex items-center cursor-pointer 
                   transition-all duration-300 ease-[cubic-bezier(0.2,0,0,1)]
                   rounded-xl relative overflow-visible
-                  ${isSidebarCollapsed ? "justify-center p-2 mb-1" : "justify-between px-3 py-2 mb-0.5"}
+                  ${isSidebarCollapsed ? (flat ? "justify-center h-10 mb-1" : "justify-center p-2 mb-1") : "justify-between px-3 py-2 mb-0.5"}
                 `}
                 style={{
-                  backgroundColor: item.isActive ? "var(--it-sidebar-active-bg, var(--color-secondary-50))" : 'transparent',
-                  boxShadow: item.isActive ? 'var(--shadow-xs)' : 'none',
-                  border: item.isActive ? "1px solid var(--it-sidebar-border, var(--color-secondary-200))" : '1px solid transparent'
+                  backgroundColor: active ? "var(--it-sidebar-active-bg, var(--color-secondary-50))" : 'transparent',
+                  boxShadow: active && !flat ? 'var(--shadow-xs)' : 'none',
+                  border: active && !flat ? "1px solid var(--it-sidebar-border, var(--color-secondary-200))" : '1px solid transparent'
                 }}
                 onMouseEnter={(e) => {
-                  if (!item.isActive) e.currentTarget.style.backgroundColor = "var(--it-sidebar-hover-bg, var(--color-secondary-100))";
+                  if (!active) e.currentTarget.style.backgroundColor = "var(--it-sidebar-hover-bg, var(--color-secondary-100))";
                 }}
                 onMouseLeave={(e) => {
-                  if (!item.isActive) e.currentTarget.style.backgroundColor = 'transparent';
+                  if (!active) e.currentTarget.style.backgroundColor = 'transparent';
                 }}
                 onClick={() => handleItemClick(item)}
                 onKeyDown={(e) => {
@@ -375,7 +412,7 @@ export default function ITSidebar({
                   }
                 }}
               >
-                {item.isActive && !isSidebarCollapsed && (
+                {active && !isSidebarCollapsed && !flat && (
                   <div
                     className="absolute left-0 top-1/4 bottom-1/4 w-[3px] rounded-r-full transition-all"
                     style={{ backgroundColor: "var(--it-sidebar-active-icon, var(--color-primary-500))", boxShadow: "0 0 10px var(--it-sidebar-active-icon, var(--color-primary-500))" }}
@@ -387,10 +424,10 @@ export default function ITSidebar({
                     <div
                       className={`transition-all duration-300 flex-shrink-0 flex items-center justify-center`}
                       style={{
-                        color: item.isActive ? "var(--it-sidebar-active-icon, var(--color-primary-500))" : "var(--it-sidebar-icon-color, #9ca3af)",
-                        opacity: item.isActive ? 1 : 0.8,
-                        fontSize: item.isActive ? '1.12rem' : '1.05rem',
-                        filter: item.isActive ? 'drop-shadow(0 0 8px rgba(255,255,255,0.2))' : 'none'
+                        color: active ? "var(--it-sidebar-active-icon, var(--color-primary-500))" : "var(--it-sidebar-icon-color, #9ca3af)",
+                        opacity: active ? 1 : 0.8,
+                        fontSize: flat ? '1rem' : active ? '1.12rem' : '1.05rem',
+                        filter: active && !flat ? 'drop-shadow(0 0 8px rgba(255,255,255,0.2))' : 'none'
                       }}
                     >
                       {item.icon}
@@ -401,9 +438,9 @@ export default function ITSidebar({
                     <ITText as="span"
                       className={`transition-all duration-300 truncate tracking-wide`}
                       style={{
-                        color: item.isActive ? "var(--it-sidebar-active-color, #ffffff)" : "var(--it-sidebar-label-color, var(--color-secondary-300))",
-                        fontSize: '0.8rem',
-                        fontWeight: item.isActive ? '600' : '500'
+                        color: active ? "var(--it-sidebar-active-color, #ffffff)" : "var(--it-sidebar-label-color, var(--color-secondary-300))",
+                        fontSize: flat ? '0.875rem' : '0.8rem',
+                        fontWeight: active ? '600' : '500'
                       }}
                     >
                       {item.label}
@@ -413,7 +450,7 @@ export default function ITSidebar({
 
                 {!isSidebarCollapsed && item.subitems && item.subitems.length > 0 && (
                   <div className={`flex-shrink-0 transition-transform duration-300 ease-[cubic-bezier(0.2,0,0,1)] ${expandedItems.has(item.id) ? "rotate-180" : ""}`}
-                    style={{ color: item.isActive ? "var(--it-sidebar-active-color, var(--color-secondary-900))" : "var(--it-sidebar-icon-color, var(--color-secondary-500))", opacity: 0.7 }}>
+                    style={{ color: active ? "var(--it-sidebar-active-color, var(--color-secondary-900))" : "var(--it-sidebar-icon-color, var(--color-secondary-500))", opacity: 0.7 }}>
                     <FaChevronDown className="w-3 h-3" />
                   </div>
                 )}
@@ -437,7 +474,21 @@ export default function ITSidebar({
               </div>
 
               {/* Glassmorphism Collapsed Tooltip / Submenu */}
-              {isSidebarCollapsed && (
+              {isSidebarCollapsed && flat && (
+                <div
+                  role="tooltip"
+                  className="absolute left-full top-1/2 -translate-y-1/2 ml-3 px-2.5 py-1.5 rounded-lg whitespace-nowrap opacity-0 invisible group-hover/navitem:opacity-100 group-hover/navitem:visible transition-opacity duration-150 pointer-events-none z-[70]"
+                  style={{
+                    backgroundColor: "var(--it-sidebar-tooltip-bg, var(--color-secondary-900))",
+                    color: "var(--it-sidebar-tooltip-color, #ffffff)",
+                    fontSize: "0.78rem",
+                    fontWeight: 500,
+                  }}
+                >
+                  {item.label}
+                </div>
+              )}
+              {isSidebarCollapsed && !flat && (
                 <div
                   className="absolute left-full top-0 ml-4 rounded-2xl opacity-0 invisible group-hover/navitem:opacity-100 group-hover/navitem:visible transition-all duration-300 pointer-events-none z-[70] min-w-[220px] overflow-hidden -translate-x-2 group-hover/navitem:translate-x-0 shadow-[0_10px_40px_-10px_rgba(0,0,0,0.15)]"
                   style={{
@@ -483,7 +534,7 @@ export default function ITSidebar({
               {!isSidebarCollapsed && item.subitems && item.subitems.length > 0 && (
                 <div id={submenuId} role="group" aria-label={item.label} className={`overflow-hidden transition-all duration-400 ease-[cubic-bezier(0.2,0,0,1)] ${expandedItems.has(item.id) ? "max-h-[1000px] opacity-100 mt-1" : "max-h-0 opacity-0"}`}>
                   <ul
-                    className="ml-4 flex flex-col gap-0 py-0.5"
+                    className={`${flat && subitemConnector === '|' ? "ml-[21px] pl-2" : "ml-4"} flex flex-col gap-0 py-0.5`}
                     style={{
                       borderLeft: subitemConnector === '|'
                         ? "1px solid var(--it-sidebar-border, var(--color-secondary-200))"

package/src/components/organisms/topbar/topbar.props.ts

@@ -49,4 +49,17 @@ export interface ITTopBarProps {
   showMobileMenuButton?: boolean;
   /** Callback fired when the mobile menu toggle button is clicked. */
   onToggleMobileMenu?: () => void;
+  /**
+   * Keeps the menu toggle button visible from the `lg` breakpoint up as well
+   * (it is mobile-only by default). `ITLayout` turns it on when the sidebar
+   * collapses by button instead of hover (`sidebar.expandOnHover === false`). @default false
+   */
+  showDesktopMenuButton?: boolean;
+  /**
+   * Hides the logo and `logoText` from the `lg` breakpoint up and left-aligns
+   * `centerContent`. Use it when the brand already lives somewhere else (e.g.
+   * at the top of a full-height sidebar); `ITLayout` sets it for you when
+   * `sidebarFullHeight` is on. Below `lg` the logo is still shown. @default false
+   */
+  hideBrandOnDesktop?: boolean;
 }

package/src/components/organisms/topbar/topbar.tsx

@@ -3,6 +3,7 @@ import useClickOutside from "@/hooks/useClickOutside";
 import { useRef, useState } from "react";
 import { ITTopBarProps } from "./topbar.props";
 import ITText from "@/components/atoms/text/text";
+import { useITFlatAppearance } from "@/theme/theme-context";
 
 /**
  * ITTopBar — sticky top navigation bar with logo, nav items, and user avatar dropdown.
@@ -67,7 +68,17 @@ export default function ITTopBar({
   onToggleMobileMenu,
   navItems,
   onNavItemClick,
+  hideBrandOnDesktop = false,
+  showDesktopMenuButton = false,
 }: ITTopBarProps) {
+  // Flat appearance: plain bar (no shadow/blur), initials avatar, name before it.
+  const flat = useITFlatAppearance();
+  const initials = (userMenu?.userName ?? "")
+    .trim()
+    .split(/\s+/)
+    .slice(0, 2)
+    .map((word) => word.charAt(0).toUpperCase())
+    .join("");
   const [isUserMenuOpen, setIsUserMenuOpen] = useState(false);
   const userMenuRef = useRef<HTMLDivElement>(null);
 
@@ -75,14 +86,14 @@ export default function ITTopBar({
 
   return (
     <header 
-      className="sticky top-0 z-40 backdrop-blur-md transition-all duration-300"
+      className={`sticky top-0 z-40 transition-all duration-300 ${flat ? "" : "backdrop-blur-md"}`}
       style={{
         backgroundColor: "var(--it-topbar-bg, rgba(255, 255, 255, 0.9))",
         borderBottom: "1px solid var(--it-topbar-border, rgba(15, 23, 42, 0.06))",
-        boxShadow: "var(--shadow-xs)",
+        boxShadow: flat ? "none" : "var(--shadow-xs)",
       }}
     >
-      <div className="flex items-center justify-between h-[72px] px-6 lg:px-8">
+      <div className={`flex items-center justify-between px-6 lg:px-8 ${flat ? "h-[64px]" : "h-[72px]"}`}>
 
         {/* LEFT AREA: Logo & Mobile Toggle */}
         <div className="flex items-center gap-5">
@@ -90,7 +101,9 @@ export default function ITTopBar({
           {/* Mobile Sidebar Toggle */}
           {showMobileMenuButton && (
             <button
-              className="lg:hidden p-2.5 rounded-xl transition-colors duration-200"
+              type="button"
+              aria-label="Menú"
+              className={`${showDesktopMenuButton ? "" : "lg:hidden"} p-2.5 -ml-2.5 rounded-xl transition-colors duration-200`}
               style={{
                  color: "var(--it-topbar-icon, #64748b)",
               }}
@@ -103,7 +116,7 @@ export default function ITTopBar({
           )}
 
           {/* Logo */}
-          <div className="flex items-center gap-3">
+          <div className={`items-center gap-3 ${hideBrandOnDesktop ? "flex lg:hidden" : "flex"}`}>
             {logo && (
               <div className="flex-shrink-0 drop-shadow-sm">
                  {logo}
@@ -153,7 +166,7 @@ export default function ITTopBar({
             `justify-between` has nothing left to distribute: the logo/nav and
             the user menu stay flush with the row edges. */}
         {centerContent && (
-          <div className="hidden lg:flex flex-1 min-w-0 items-center justify-center px-4">
+          <div className={`hidden lg:flex flex-1 min-w-0 items-center ${hideBrandOnDesktop ? "justify-start pr-4" : "justify-center px-4"}`}>
             <div className="w-full max-w-[420px]">{centerContent}</div>
           </div>
         )}
@@ -169,7 +182,7 @@ export default function ITTopBar({
               <div className="relative">
                 <button
                   type="button"
-                  className="flex items-center gap-3 rounded-full pl-2 pr-4 py-1.5 transition-all duration-200 ease-[cubic-bezier(0.2,0,0,1)] border border-transparent hover:border-secondary-200"
+                  className={`flex items-center gap-3 rounded-full py-1.5 transition-all duration-200 ease-[cubic-bezier(0.2,0,0,1)] border border-transparent hover:border-secondary-200 ${flat ? "flex-row-reverse pl-4 pr-2" : "pl-2 pr-4"}`}
                   style={{
                     backgroundColor: isUserMenuOpen ? "var(--it-topbar-user-hover, #f1f5f9)" : "transparent",
                   }}
@@ -189,17 +202,30 @@ export default function ITTopBar({
                         src={userMenu.userImage}
                         alt="Current user"
                       />
+                    ) : flat && initials ? (
+                      <div
+                        aria-hidden="true"
+                        className="w-9 h-9 rounded-full flex items-center justify-center text-[0.8rem] font-semibold"
+                        style={{
+                          backgroundColor: "color-mix(in srgb, var(--color-primary, #3b82f6) 14%, transparent)",
+                          color: "var(--color-primary, #2563eb)",
+                        }}
+                      >
+                        {initials}
+                      </div>
                     ) : (
                       <div className="w-9 h-9 rounded-full bg-slate-100 flex items-center justify-center ring-2 ring-white shadow-sm">
                          <FaUserCircle className="w-6 h-6" style={{ color: "var(--it-topbar-icon, #94a3b8)" }} />
                       </div>
                     )}
                     {/* Active dot indicator */}
-                    <div className="absolute bottom-0 right-0 w-2.5 h-2.5 bg-green-500 border-2 border-white rounded-full"></div>
+                    {!flat && (
+                      <div className="absolute bottom-0 right-0 w-2.5 h-2.5 bg-green-500 border-2 border-white rounded-full"></div>
+                    )}
                   </div>
 
                   {/* Name Details */}
-                  <div className="hidden sm:flex flex-col text-left py-0.5">
+                  <div className={`hidden sm:flex flex-col py-0.5 ${flat ? "text-right" : "text-left"}`}>
                     <ITText as="span" 
                       className="font-semibold text-[0.85rem] leading-tight"
                       style={{ color: "var(--it-topbar-user-text, #0f172a)" }}

package/src/components/templates/layout/layout.props.ts

@@ -12,4 +12,12 @@ export interface ITLayoutProps {
   className?: string;
   /** Additional CSS classes for the content container */
   contentClassName?: string;
+  /**
+   * App-shell arrangement. `false` (default): the top bar spans the full width
+   * and the sidebar sits below it. `true`: the sidebar spans the full viewport
+   * height and shows the brand (`topBar.logo` + `topBar.logoText`) at its top,
+   * while the top bar covers only the content column and drops the logo from
+   * the `lg` breakpoint up. Mobile is unchanged. @default false
+   */
+  sidebarFullHeight?: boolean;
 }