jekyll-theme-zer0 1.19.1 → 1.20.2

data/_sass/components/_ui-enhancements.scss

@@ -0,0 +1,570 @@
+// ============================================================================
+
+// UI/UX enhancements — Bootstrap component polish (buttons, cards, hero, etc.)
+
+// ----------------------------------------------------------------------------
+
+// Extracted from custom.scss (Phase 5). Global element/loading styles plus the
+
+// interaction/animation polish layered on top of Bootstrap components.
+
+// ============================================================================
+
+img {
+    display: inline-block;
+    max-width: 100%;
+    height: auto;
+}
+
+// MOVED → _sass/core/_navbar.scss — navbar-brand logo sizing + the #navbar
+// fixed/auto-hide desktop grid + responsive/mobile navbar layout now live with
+// the rest of the navbar styling.
+
+// MOVED → _sass/components/_search-modal.scss (search modal + folder tree).
+
+// ==============================================================================
+// UI/UX ENHANCEMENTS - Modern, polished interactions
+// ==============================================================================
+
+// Hero Section Enhancements
+// NOTE: Exclude .zer0-bg-hero so skin-specific gradients from _backgrounds.scss take precedence
+.bg-primary:not(.zer0-bg-hero) {
+  position: relative;
+  overflow: hidden;
+  
+  &::before {
+    content: '';
+    position: absolute;
+    top: 0;
+    left: 0;
+    right: 0;
+    bottom: 0;
+    background: linear-gradient(135deg, rgba(255,255,255,0.1) 0%, rgba(255,255,255,0) 100%);
+    pointer-events: none;
+  }
+}
+
+// Hero content animations
+.bg-primary .container-xl {
+  animation: fadeInUp 0.8s ease-out;
+}
+
+@keyframes fadeInUp {
+  from {
+    opacity: 0;
+    transform: translateY(30px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+// Enhanced Button Styles
+.btn {
+  transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+  position: relative;
+  overflow: hidden;
+  
+  &::before {
+    content: '';
+    position: absolute;
+    top: 50%;
+    left: 50%;
+    width: 0;
+    height: 0;
+    border-radius: 50%;
+    background: rgba(255, 255, 255, 0.2);
+    transform: translate(-50%, -50%);
+    transition: width 0.6s, height 0.6s;
+  }
+  
+  &:hover::before {
+    width: 300px;
+    height: 300px;
+  }
+  
+  &:hover {
+    transform: translateY(-2px);
+    box-shadow: 0 8px 16px rgba(0, 0, 0, 0.2);
+  }
+  
+  &:active {
+    transform: translateY(0);
+    box-shadow: 0 4px 8px rgba(0, 0, 0, 0.15);
+  }
+  
+  &.btn-lg {
+    padding: 0.75rem 1.5rem;
+    font-size: 1.125rem;
+  }
+}
+
+.btn-outline-light:hover {
+  background-color: rgba(255, 255, 255, 0.95);
+  color: var(--bs-primary);
+  border-color: rgba(255, 255, 255, 0.95);
+}
+
+.btn-light:hover {
+  background-color: rgba(255, 255, 255, 0.9);
+  transform: translateY(-2px);
+}
+
+// Enhanced Card Styles
+.card {
+  transition: all 0.4s cubic-bezier(0.4, 0, 0.2, 1);
+  border: 1px solid rgba(0, 0, 0, 0.08);
+  
+  &:hover {
+    transform: translateY(-8px);
+    box-shadow: 0 12px 24px rgba(0, 0, 0, 0.15);
+    border-color: rgba(var(--bs-primary-rgb), 0.2);
+  }
+  
+  .card-header {
+    transition: all 0.3s ease;
+  }
+  
+  &:hover .card-header {
+    background-color: rgba(255, 255, 255, 0.1);
+  }
+}
+
+// Feature Cards - Icon Animation
+.card-body {
+  .rounded-circle {
+    transition: all 0.4s cubic-bezier(0.4, 0, 0.2, 1);
+  }
+  
+  i {
+    transition: transform 0.4s cubic-bezier(0.4, 0, 0.2, 1);
+  }
+}
+
+.card:hover .rounded-circle {
+  transform: scale(1.1) rotate(5deg);
+  box-shadow: 0 8px 16px rgba(0, 0, 0, 0.2);
+}
+
+.card:hover .rounded-circle i {
+  transform: scale(1.2);
+}
+
+// Code Block Enhancements
+pre {
+  position: relative;
+  transition: all 0.3s ease;
+  border: 1px solid rgba(0, 0, 0, 0.1);
+  
+  &:hover {
+    border-color: rgba(var(--bs-primary-rgb), 0.3);
+    box-shadow: 0 4px 12px rgba(0, 0, 0, 0.1);
+  }
+  
+  code {
+    font-family: 'SF Mono', Monaco, 'Cascadia Code', 'Roboto Mono', Consolas, 'Courier New', monospace;
+    font-size: 0.875rem;
+    line-height: 1.6;
+  }
+}
+
+// Quick Links Bar Enhancements
+.bg-dark {
+  .btn-outline-light {
+    transition: all 0.3s ease;
+    border-width: 2px;
+    
+    &:hover {
+      background-color: rgba(255, 255, 255, 0.95);
+      color: var(--bs-dark);
+      transform: translateY(-2px);
+      box-shadow: 0 4px 8px rgba(255, 255, 255, 0.2);
+    }
+  }
+}
+
+// Smooth Scroll Enhancement
+html {
+  scroll-behavior: smooth;
+  scroll-padding-top: 80px; // Account for fixed navbar
+}
+
+// Section Spacing Improvements
+// Ensure anchored elements clear the fixed navbar when scrolled to
+section,
+.py-5,
+[id] {
+  scroll-margin-top: 80px;
+}
+
+// Landing Page Quick Links Animation
+.bg-dark {
+  animation: slideDown 0.6s ease-out;
+}
+
+@keyframes slideDown {
+  from {
+    opacity: 0;
+    transform: translateY(-20px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+// Feature Section Cards Stagger Animation
+.bg-body-tertiary .row.g-4 > * {
+  animation: fadeInUp 0.6s ease-out backwards;
+  
+  &:nth-child(1) { animation-delay: 0.1s; }
+  &:nth-child(2) { animation-delay: 0.2s; }
+  &:nth-child(3) { animation-delay: 0.3s; }
+}
+
+// Installation Cards Enhancement
+#get-started .card {
+  border-top: 3px solid transparent;
+  transition: all 0.4s cubic-bezier(0.4, 0, 0.2, 1);
+  
+  &:hover {
+    border-top-color: var(--bs-primary);
+  }
+  
+  &.card-header.bg-primary ~ .card-body {
+    border-top-color: var(--bs-primary);
+  }
+  
+  &.card-header.bg-info ~ .card-body {
+    border-top-color: var(--bs-info);
+  }
+  
+  &.card-header.bg-secondary ~ .card-body {
+    border-top-color: var(--bs-secondary);
+  }
+}
+
+// Mobile Responsiveness Improvements
+@media (max-width: 768px) {
+  .bg-primary .display-4 {
+    font-size: 2rem;
+  }
+  
+  .bg-primary .lead {
+    font-size: 1rem;
+  }
+  
+  .btn-lg {
+    padding: 0.625rem 1.25rem;
+    font-size: 1rem;
+  }
+  
+  .card {
+    margin-bottom: 1rem;
+  }
+  
+  // Reduce hover effects on mobile for better performance
+  .card:hover {
+    transform: translateY(-4px);
+  }
+  
+  .btn:hover {
+    transform: none;
+  }
+}
+
+// Loading State for Images
+img {
+  transition: opacity 0.3s ease;
+  
+  &[loading="lazy"] {
+    opacity: 0;
+    
+    &.loaded {
+      opacity: 1;
+    }
+  }
+}
+
+// Focus States for Accessibility
+.btn:focus-visible,
+.card:focus-visible,
+a:focus-visible {
+  outline: 3px solid rgba(var(--bs-primary-rgb), 0.5);
+  outline-offset: 2px;
+}
+
+// Reduce Motion: the global `*,*::before,*::after` reduced-motion reset lives in
+// _sass/utilities/_motion.scss (imported earlier, identical `!important` body).
+// This duplicate was removed — no compiled change. The navbar-scoped
+// `#navbar { transition: none }` reduced-motion rule above is kept (it targets a
+// specific element, not the universal reset).
+
+// Table Enhancements
+.table {
+  transition: all 0.3s ease;
+  
+  tbody tr {
+    transition: background-color 0.2s ease;
+    
+    &:hover {
+      background-color: rgba(var(--bs-primary-rgb), 0.05);
+    }
+  }
+}
+
+// Badge Enhancements
+.badge {
+  transition: all 0.3s ease;
+  
+  &:hover {
+    transform: scale(1.05);
+  }
+}
+
+// Feature category badges on /features/
+.feature-categories {
+  .badge {
+    &:hover,
+    &:focus-visible {
+      color: var(--bs-badge-color, #fff);
+      text-decoration: none;
+      filter: brightness(1.12);
+      transform: scale(1.05);
+      outline: 2px solid rgba(var(--bs-primary-rgb), 0.55);
+      outline-offset: 2px;
+    }
+  }
+}
+
+// Link Enhancements
+a:not(.btn) {
+  transition: color 0.2s ease;
+  text-decoration: none;
+  
+  &:hover {
+    text-decoration: underline;
+    text-underline-offset: 3px;
+  }
+}
+
+// Container Enhancements
+.container-xl {
+  position: relative;
+}
+
+// Hero Image Animation
+.bg-primary img {
+  animation: fadeInRight 1s ease-out 0.3s backwards;
+  filter: drop-shadow(0 10px 30px rgba(0, 0, 0, 0.3));
+  transition: transform 0.3s ease;
+  
+  &:hover {
+    transform: scale(1.02);
+  }
+}
+
+@keyframes fadeInRight {
+  from {
+    opacity: 0;
+    transform: translateX(30px);
+  }
+  to {
+    opacity: 1;
+    transform: translateX(0);
+  }
+}
+
+// Improved Shadow Utilities
+.shadow-sm {
+  box-shadow: 0 2px 4px rgba(0, 0, 0, 0.08) !important;
+}
+
+.shadow {
+  box-shadow: 0 4px 8px rgba(0, 0, 0, 0.12) !important;
+}
+
+.shadow-lg {
+  box-shadow: 0 8px 16px rgba(0, 0, 0, 0.15) !important;
+}
+
+// Button Ripple Effect — JS-injected `.ripple` click element.
+// `position: relative` / `overflow: hidden` are already set on `.btn` by the
+// "Enhanced Button Styles" block above; the duplicate declarations here were
+// removed (no compiled change — they resolved to the same values).
+.btn {
+  .ripple {
+    position: absolute;
+    border-radius: 50%;
+    background: rgba(255, 255, 255, 0.6);
+    transform: scale(0);
+    animation: ripple-animation 0.6s ease-out;
+    pointer-events: none;
+  }
+}
+
+@keyframes ripple-animation {
+  to {
+    transform: scale(4);
+    opacity: 0;
+  }
+}
+
+// Mobile Navigation Enhancements
+@media (max-width: 991.98px) {
+  .navbar-collapse {
+    background-color: var(--bs-body-bg);
+    border-radius: 0.5rem;
+    margin-top: 1rem;
+    padding: 1rem;
+    box-shadow: 0 4px 12px rgba(0, 0, 0, 0.1);
+  }
+  
+  .navbar-nav .nav-link {
+    padding: 0.75rem 1rem;
+    border-radius: 0.375rem;
+    transition: all 0.2s ease;
+    
+    &:hover {
+      background-color: rgba(var(--bs-primary-rgb), 0.1);
+    }
+  }
+}
+
+// Improved Mobile Hero Section
+@media (max-width: 768px) {
+  .bg-primary {
+    padding: 2rem 0 !important;
+    
+    .display-4 {
+      font-size: 1.75rem;
+      line-height: 1.3;
+    }
+    
+    .lead {
+      font-size: 0.95rem;
+    }
+    
+    .btn-lg {
+      width: 100%;
+      margin-bottom: 0.5rem;
+    }
+  }
+  
+  // Better card spacing on mobile
+  .row.g-4 > * {
+    margin-bottom: 1rem;
+  }
+  
+  // Improved code block readability on mobile
+  pre {
+    font-size: 0.8rem;
+    overflow-x: auto;
+    -webkit-overflow-scrolling: touch;
+
+    &:not(.highlight) {
+      padding: var(--zer0-space-2);
+    }
+  }
+
+  .highlight:not(pre) pre,
+  pre.highlight {
+    padding: 0;
+  }
+}
+
+// Touch-friendly tap targets
+@media (hover: none) and (pointer: coarse) {
+  .btn,
+  .card,
+  a {
+    min-height: 44px; // iOS HIG recommendation
+    min-width: 44px;
+  }
+  
+  // Disable hover effects on touch devices
+  .card:hover {
+    transform: none;
+  }
+  
+  .btn:hover {
+    transform: none;
+  }
+}
+
+// Improved focus visibility for keyboard navigation
+*:focus-visible {
+  outline: 2px solid var(--bs-primary);
+  outline-offset: 2px;
+  border-radius: 0.25rem;
+}
+
+// Enhanced active link states
+.nav-link.active,
+.btn.active {
+  position: relative;
+  
+  &::after {
+    content: '';
+    position: absolute;
+    bottom: 0;
+    left: 50%;
+    transform: translateX(-50%);
+    width: 80%;
+    height: 2px;
+    background-color: currentColor;
+    border-radius: 2px;
+  }
+}
+
+// Better table responsiveness
+@media (max-width: 768px) {
+  .table-responsive {
+    border-radius: 0.5rem;
+    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+  }
+  
+  .table {
+    font-size: 0.875rem;
+    
+    th, td {
+      padding: 0.5rem;
+    }
+  }
+}
+
+// Improved badge styling
+.badge {
+  font-weight: 500;
+  letter-spacing: 0.025em;
+  padding: 0.35em 0.65em;
+}
+
+// Enhanced form controls
+.form-control:focus,
+.form-select:focus {
+  border-color: var(--bs-primary);
+  box-shadow: 0 0 0 0.25rem rgba(var(--bs-primary-rgb), 0.25);
+  transform: translateY(-1px);
+  transition: all 0.2s ease;
+}
+
+// MOVED → _sass/components/_skeleton.scss (token-aware, dark-mode-safe)
+
+// Print optimizations
+@media print {
+  .btn,
+  .card:hover,
+  .navbar,
+  .footer {
+    box-shadow: none !important;
+    transform: none !important;
+  }
+  
+  a[href^="#"]::after {
+    content: " (" attr(href) ")";
+    font-size: 0.8em;
+    color: #666;
+  }
+}