feat(onboarding flow): implements a comprehensive onboarding system

packages/ui/src/App.jsx

@@ -11,6 +11,8 @@ import themes from '@/themes'
 
 // project imports
 import NavigationScroll from '@/layout/NavigationScroll'
+import OnboardingGate from '@/views/onboarding/OnboardingGate'
+import { OverlayProvider } from '@/ui-component/overlay/OverlayProvider'
 
 // ==============================|| APP ||============================== //
 
@@ -21,9 +23,13 @@ const App = () => {
         <StyledEngineProvider injectFirst>
             <ThemeProvider theme={themes(customization)}>
                 <CssBaseline />
-                <NavigationScroll>
-                    <Routes />
-                </NavigationScroll>
+                <OverlayProvider>
+                    <OnboardingGate>
+                        <NavigationScroll>
+                            <Routes />
+                        </NavigationScroll>
+                    </OnboardingGate>
+                </OverlayProvider>
             </ThemeProvider>
         </StyledEngineProvider>
     )

packages/ui/src/api/onboarding.js

@@ -0,0 +1,48 @@
+import { getStateByProgress } from '../utils/overlay/onboarding'
+
+// localStorage-based API client for onboarding
+// This will be replaced with real API calls in the future
+
+export const ONBOARDING_STORAGE_KEY = 'onboarding'
+
+// Get onboarding status
+const getStatus = () => {
+    try {
+        const stored = localStorage.getItem(ONBOARDING_STORAGE_KEY)
+        if (stored) {
+            const data = JSON.parse(stored)
+            const state = getStateByProgress(data.progress)
+            return {
+                success: true,
+                data: {
+                    ...data,
+                    state
+                }
+            }
+        }
+
+        // Return default state for new users
+        return {
+            success: true,
+            data: {
+                state: 'NOT_STARTED',
+                showWelcomePage: true,
+                progress: {
+                    chatflowCreated: false,
+                    agentFlowCreated: false,
+                    documentStoreAdded: false,
+                    marketplaceExplored: false
+                }
+            }
+        }
+    } catch (error) {
+        console.error('Failed to get onboarding status:', error)
+        throw error
+    }
+}
+
+const onboardingApi = {
+    getStatus
+}
+
+export default onboardingApi