How sabzidev/visionui-dashboard works
VISION UI is a React dashboard for signing in and viewing dashboard, profile, and table pages. The user enters through the app shell and router; private routes check authentication, and page components render domain-specific sections backed by query hooks and API modules. The README also documents bilingual UI, charting, skeleton states, responsive layout, and PWA/offline support. Edges follow shown imports and calls; some feature internals and service-worker behavior are unsampled, so those relationships are omitted where not evidenced.
Main entry points: routes.jsx Route map · main.jsx React entry · Auth.jsx Auth context · useAdmin.js Admin queries
Components 31
App shell
- React entry
src/main.jsx - App providers
src/AppProviders.jsx - Router host
src/App.jsx
Access and routing
- Route map
src/routes.jsx - Private route
src/layouts/PrivateRoute.jsx - Auth context
src/contexts/Auth/Auth.jsx - Cookie state
src/hooks/useCookie.js - Sign-in page
src/pages/auth/Signin/page.jsx - Sign-in form logic
src/pages/auth/Signin/hooks/useAuthForm/useAuthForm.js
Dashboard pages
- Dashboard page
src/pages/private/Dashboard/page.jsx - Dashboard sections
src/pages/private/Dashboard/sections - Profile page
src/pages/private/Profile/page.jsx - Profile sections
src/pages/private/Profile/sections - Tables page
src/pages/private/Tables/page.jsx - Authors table
src/pages/private/Tables/sections/AuthorsTableSection/section.jsx - Projects table
src/pages/private/sections/ProjectsTableSection/section.jsx
Data and services
- Query client
src/services/queryClient.js - Admin queries
src/services/features/admin/hooks/useAdmin/useAdmin.js - Admin API
src/services/features/admin/admin.api.js - Authors query
src/services/features/authors/hooks/useAuthors/useAuthors.js - Authors API
src/services/features/authors/authors.api.js - Projects query
src/services/features/projects/hooks/useProjects/useProjects.js - Projects API
src/services/features/projects/projects.api.js - Stats query
src/services/features/stats/hooks/useStats/useStats.js - Stats API
src/services/features/stats/stats.api.js
Shared experience
- Localization setup
src/i18n/index.js - English messages
src/i18n/en.js - Persian messages
src/i18n/fa.js - Route metadata
src/layouts/components/Head.jsx - Service worker
public/sw.js
Other components
- Dashboard user
Connections 33
- Dashboard user → React entry: opens app
- React entry → Router host: renders
src/main.jsx - React entry → App providers: wraps with
src/main.jsx - React entry → Auth context: wraps with
src/main.jsx - React entry → Service worker: registers
src/main.jsx - Router host → Route map: hosts router
src/App.jsx - Route map → Private route: routes through
src/routes.jsx - Route map → Sign-in page: routes to
src/routes.jsx - Route map → Dashboard page: routes to
src/routes.jsx - Route map → Profile page: routes to
src/routes.jsx - Route map → Tables page: routes to
src/routes.jsx - Route map → Admin queries: prefetches
src/routes.jsx - Route map → Query client: uses
src/routes.jsx - Private route → Auth context: checks identity
src/layouts/PrivateRoute.jsx - Private route → Admin queries: checks admin
src/layouts/PrivateRoute.jsx - Auth context → Cookie state: persists identity
src/contexts/Auth/Auth.jsx - Sign-in page → Sign-in form logic: renders
src/pages/auth/Signin/page.jsx - Sign-in page → Auth context: reads session
src/pages/auth/Signin/page.jsx - Sign-in page → Admin queries: loads admin
src/pages/auth/Signin/page.jsx - Sign-in form logic → Auth context: sets identity
src/pages/auth/Signin/hooks/useAuthForm/useAuthForm.js - Sign-in form logic → Admin queries: loads admin
src/pages/auth/Signin/hooks/useAuthForm/useAuthForm.js - Dashboard page → Dashboard sections: renders sections
src/pages/private/Dashboard/page.jsx - Profile page → Profile sections: renders sections
src/pages/private/Profile/page.jsx - Tables page → Authors table: renders
src/pages/private/Tables/page.jsx - Tables page → Projects table: renders
src/pages/private/Tables/page.jsx - Admin queries → Admin API: calls
src/services/features/admin/hooks/useAdmin/useAdmin.js - Authors query → Authors API: calls
src/services/features/authors/hooks/useAuthors/useAuthors.js - Projects query → Projects API: calls
src/services/features/projects/hooks/useProjects/useProjects.js - Stats query → Stats API: calls
src/services/features/stats/hooks/useStats/useStats.js - Query client → Localization setup: translates notices
src/services/queryClient.js - Localization setup → English messages: loads messages
src/i18n/index.js - Localization setup → Persian messages: loads messages
src/i18n/index.js - Route map → Route metadata: provides route data
src/routes.jsx