chore(release): 4.48.2 [skip ci]

## [4.48.2](https://github.com/antialias/soroban-abacus-flashcards/compare/v4.48.1...v4.48.2) (2025-10-20)

### Bug Fixes

* **nav:** ensure nav bar appears above tutorial tooltips ([cc31564](cc315645de))

### Styles

* **hero:** unify background with rest of homepage ([035d831](035d8312c7))

CHANGELOG.md

@@ -1,3 +1,22 @@
+## [4.48.2](https://github.com/antialias/soroban-abacus-flashcards/compare/v4.48.1...v4.48.2) (2025-10-20)
+
+
+### Bug Fixes
+
+* **nav:** ensure nav bar appears above tutorial tooltips ([cc31564](https://github.com/antialias/soroban-abacus-flashcards/commit/cc315645de30218d1b034da3e130458fe2961a69))
+
+
+### Styles
+
+* **hero:** unify background with rest of homepage ([035d831](https://github.com/antialias/soroban-abacus-flashcards/commit/035d8312c707cbf5b0e2a725d7b1d8ff406f842d))
+
+## [4.48.1](https://github.com/antialias/soroban-abacus-flashcards/compare/v4.48.0...v4.48.1) (2025-10-20)
+
+
+### Bug Fixes
+
+* **hero:** prevent SSR hydration mismatch for subtitle ([1bfde8f](https://github.com/antialias/soroban-abacus-flashcards/commit/1bfde8fb251b227ccd2528bfe1c47acffd79fa49))
+
 ## [4.48.0](https://github.com/antialias/soroban-abacus-flashcards/compare/v4.47.2...v4.48.0) (2025-10-20)
 
 

apps/web/src/components/AppNavBar.tsx

@@ -584,7 +584,7 @@ export function AppNavBar({ variant = 'full', navSlot }: AppNavBarProps) {
           top: 0,
           left: 0,
           right: 0,
-          zIndex: 30,
+          zIndex: 1000,
           transition: 'all 0.3s ease',
         })}
       >

apps/web/src/components/HeroAbacus.tsx

@@ -6,7 +6,14 @@ import { css } from '../../styled-system/css'
 import { useHomeHero } from '../contexts/HomeHeroContext'
 
 export function HeroAbacus() {
-  const { subtitle, abacusValue, setAbacusValue, setIsHeroVisible, isAbacusLoaded } = useHomeHero()
+  const {
+    subtitle,
+    abacusValue,
+    setAbacusValue,
+    setIsHeroVisible,
+    isAbacusLoaded,
+    isSubtitleLoaded,
+  } = useHomeHero()
   const appConfig = useAbacusConfig()
   const heroRef = useRef<HTMLDivElement>(null)
 
@@ -52,8 +59,7 @@ export function HeroAbacus() {
         flexDirection: 'column',
         alignItems: 'center',
         justifyContent: 'space-between',
-        background:
-          'linear-gradient(135deg, rgba(17, 24, 39, 1) 0%, rgba(88, 28, 135, 0.3) 50%, rgba(17, 24, 39, 1) 100%)',
+        bg: 'gray.900',
         position: 'relative',
         overflow: 'hidden',
         px: '4',
@@ -101,6 +107,8 @@ export function HeroAbacus() {
             color: 'purple.300',
             fontStyle: 'italic',
             marginBottom: '8',
+            opacity: isSubtitleLoaded ? 1 : 0,
+            transition: 'opacity 0.5s ease-in-out',
           })}
         >
           {subtitle.text}

apps/web/src/contexts/HomeHeroContext.tsx

@@ -12,6 +12,7 @@ interface HomeHeroContextValue {
   isHeroVisible: boolean
   setIsHeroVisible: (visible: boolean) => void
   isAbacusLoaded: boolean
+  isSubtitleLoaded: boolean
 }
 
 const HomeHeroContext = createContext<HomeHeroContextValue | null>(null)
@@ -21,6 +22,7 @@ export { HomeHeroContext }
 export function HomeHeroProvider({ children }: { children: React.ReactNode }) {
   // Use first subtitle for SSR, then select random one on client mount
   const [subtitle, setSubtitle] = useState<Subtitle>(subtitles[0])
+  const [isSubtitleLoaded, setIsSubtitleLoaded] = useState(false)
 
   // Select random subtitle only on client side, persist per-session
   useEffect(() => {
@@ -32,6 +34,7 @@ export function HomeHeroProvider({ children }: { children: React.ReactNode }) {
       const index = parseInt(storedIndex, 10)
       if (!Number.isNaN(index) && index >= 0 && index < subtitles.length) {
         setSubtitle(subtitles[index])
+        setIsSubtitleLoaded(true)
         return
       }
     }
@@ -40,6 +43,7 @@ export function HomeHeroProvider({ children }: { children: React.ReactNode }) {
     const randomIndex = Math.floor(Math.random() * subtitles.length)
     sessionStorage.setItem('heroSubtitleIndex', randomIndex.toString())
     setSubtitle(subtitles[randomIndex])
+    setIsSubtitleLoaded(true)
   }, [])
 
   // Shared abacus value - always start at 0 for SSR/hydration consistency
@@ -106,8 +110,9 @@ export function HomeHeroProvider({ children }: { children: React.ReactNode }) {
       isHeroVisible,
       setIsHeroVisible,
       isAbacusLoaded,
+      isSubtitleLoaded,
     }),
-    [subtitle, abacusValue, isHeroVisible, isAbacusLoaded]
+    [subtitle, abacusValue, isHeroVisible, isAbacusLoaded, isSubtitleLoaded]
   )
 
   return <HomeHeroContext.Provider value={value}>{children}</HomeHeroContext.Provider>

package.json

@@ -1,6 +1,6 @@
 {
   "name": "soroban-monorepo",
-  "version": "4.48.0",
+  "version": "4.48.2",
   "private": true,
   "description": "Beautiful Soroban Flashcard Generator - Monorepo",
   "workspaces": [