# dhruvinpatel1407/geniecart architecture

> Architecture diagram of the GitHub repository dhruvinpatel1407/geniecart, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dhruvinpatel1407/geniecart
- Repository: https://github.com/dhruvinpatel1407/geniecart

## Overview

##### Project type and purpose
- This is a single-page E-Commerce Frontend application (GenieCart) built with React and Vite.
- It implements core e-commerce features (product listing/detail, cart, wishlist, authentication) and uses Redux for state management.

##### File structure
- Top-level:
- public/ – static assets (images, redirects)
- src/
– components/ – reusable presentational components (Navbar, Footer, CategoryMenu, ProfileMenu, SearchMenu)
– pages/ – route-based containers (Dashboard, CartPage, ProductDetailPage, SignIn, SignUp, Wishlist)
– setup/ – app bootstrapping (ErrorBoundary, NotFound, routes-manager, Redux store setup)
– __tests__/ – unit tests for components, pages, reducers
– App.jsx, main.jsx – root component and ReactDOM.render
- Configuration files for ESLint, Tailwind, Vite, and Redux (actiontypes, actions, reducers, store, Redux-Persist).

##### README for additional insights
- Features: error boundaries, responsive design, authentication, persistence.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Static Hosting Layer
    subgraph "Static Assets & Hosting"
        direction TB
        Public["public/"]:::infra
        Index["index.html"]:::infra
    end

    %% App Bootstrapping
    subgraph "App Bootstrapping"
        direction TB
        Main["src/main.jsx"]:::infra
        AppShell["src/App.jsx"]:::infra
    end

    %% Setup Layer
    subgraph "Setup & Routing"
        direction TB
        ErrorBoundary["ErrorBoundary"]:::ui
        NotFound["NotFound"]:::ui
        RoutesManager["routes-manager"]:::ui
    end

    %% UI Layer - Pages
    subgraph "Pages (Containers)" 
        direction TB
        Dashboard["Dashboard Page"]:::ui
        CartPage["Cart Page"]:::ui
        ProductDetail["Product Detail Page"]:::ui
        SignIn["Sign-In Page"]:::ui
        SignUp["Sign-Up Page"]:::ui
        Wishlist["Wishlist Page"]:::ui
    end

    %% UI Layer - Components
    subgraph "Presentational Components"
        direction TB
        Navbar["Navbar & Header"]:::ui
        CategoryMenu["CategoryMenu"]:::ui
        SearchMenu["SearchMenu"]:::ui
        ProfileMenu["ProfileMenu"]:::ui
        Footer["Footer"]:::ui
    end

    %% Dashboard Subcomponents
    subgraph "Dashboard Subcomponents"
        direction TB
        Banner["Banner & Promotions"]:::ui
        OurProducts["OurProducts Banner"]:::ui
        SaleTimer["Sale End Timer"]:::ui
        TopSale["Top Sale Section"]:::ui
        Discount["Discount Banner"]:::ui
        CategoryList["Category List"]:::ui
        FAQ["FAQ Section"]:::ui
        Deco["Decoration Section"]:::ui
        Electronics["Electronics Section"]:::ui
        Groceries["Groceries Section"]:::ui
        MenSection["Men's Section"]:::ui
        Sport["Sport Section"]:::ui
        WomenSection["Women's Section"]:::ui
        ProductCard["ProductCard"]:::ui
        Filter["Filter"]:::ui
        CartButton["CartButton"]:::ui
        WishlistButton["WishlistButton"]:::ui
    end

    %% State Management Layer
    subgraph "State Management" 
        direction TB
        StoreInit["Store Initialization"]:::state
        ActionTypes["Action Types"]:::state
        Actions["Actions & Thunks"]:::state
        Reducers["Reducers"]:::state
        Persistor["Redux-Persist"]:::persist
    end

    %% Persistence
    LocalStorage["LocalStorage"]:::persist

    %% External Services
    ExternalAPI["REST API"]:::external

    %% Connections
    Public -->|serves| Index
    Index -->|loads| Main
    Main -->|mounts| AppShell
    AppShell -->|wraps with| ErrorBoundary
    ErrorBoundary -->|routes via| RoutesManager
    RoutesManager -->|renders| Dashboard
    RoutesManager -->|renders| CartPage
    RoutesManager -->|renders| ProductDetail
    RoutesManager -->|renders| SignIn
    RoutesManager -->|renders| SignUp
    RoutesManager -->|renders| Wishlist

    Dashboard -->|uses| Banner
    Dashboard -->|uses| OurProducts
    Dashboard -->|uses| SaleTimer
    Dashboard -->|uses| TopSale
    Dashboard -->|uses| Discount
    Dashboard -->|uses| CategoryList
    Dashboard -->|uses| FAQ
    Dashboard -->|uses| Deco
    Dashboard -->|uses| Electronics
    Dashboard -->|uses| Groceries
    Dashboard -->|uses| MenSection
    Dashboard -->|uses| Sport
    Dashboard -->|uses| WomenSection
    Dashboard -->|uses| ProductCard
    Dashboard -->|uses| Filter
    Dashboard -->|uses| CartButton
    Dashboard -->|uses| WishlistButton

    AppShell -->|includes| Navbar
    AppShell -->|includes| CategoryMenu
    AppShell -->|includes| SearchMenu
    AppShell -->|includes| ProfileMenu
    AppShell -->|includes| Footer

    Dashboard -->|dispatches| Actions
    CartPage -->|dispatches| Actions
    ProductDetail -->|dispatches| Actions
    SignIn -->|dispatches| Actions
    SignUp -->|dispatches| Actions
    Wishlist -->|dispatches| Actions

    Actions -->|uses thunk| ExternalAPI
    ExternalAPI -->|returns data| Actions
    Actions -->|dispatches| Reducers
    Reducers -->|updates| StoreInit
    StoreInit -->|provides state to| Dashboard
    StoreInit -->|provides state to| CartPage
    StoreInit -->|provides state to| ProductDetail
    StoreInit -->|provides state to| SignIn
    StoreInit -->|provides state to| SignUp
    StoreInit -->|provides state to| Wishlist

    StoreInit -->|persists| Persistor
    Persistor -->|syncs| LocalStorage
    LocalStorage -->|rehydrates| Persistor

    %% Click Events
    click Public "https://github.com/dhruvinpatel1407/geniecart/tree/main/public/"
    click Index "https://github.com/dhruvinpatel1407/geniecart/blob/main/index.html"
    click Main "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/main.jsx"
    click AppShell "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/App.jsx"
    click ErrorBoundary "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/setup/Error Boundary/index.jsx"
    click NotFound "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/setup/Not Found/index.jsx"
    click RoutesManager "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/setup/routes-manager/index.jsx"
    click StoreInit "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/setup/store/store.js"
    click ActionTypes "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/setup/store/actiontypes.js"
    click Actions "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/setup/store/actions/index.js"
    click Reducers "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/setup/store/reducers/reducer.js"
    click Dashboard "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/pages/dashboard/index.jsx"
    click Banner "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/pages/dashboard/components/Banner/index.jsx"
    click OurProducts "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/pages/dashboard/components/Banner/OurProducts.jsx"
    click SaleTimer "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/pages/dashboard/components/Banner/SaleEndTimer.jsx"
    click TopSale "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/pages/dashboard/components/Banner/TopSale.jsx"
    click Discount "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/pages/dashboard/components/Banner/discount.jsx"
    click CategoryList "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/pages/dashboard/components/CategoryList/index.jsx"
    click FAQ "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/pages/dashboard/components/FAQ/index.jsx"
    click Deco "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/pages/dashboard/components/products/Decoration.jsx"
    click Electronics "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/pages/dashboard/components/products/Electronics.jsx"
    click Groceries "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/pages/dashboard/components/products/Groceries.jsx"
    click MenSection "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/pages/dashboard/components/products/MenSection.jsx"
    click Sport "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/pages/dashboard/components/products/Sport.jsx"
    click WomenSection "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/pages/dashboard/components/products/WomenSection.jsx"
    click ProductCard "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/pages/dashboard/components/products/components/ProductCard.jsx"
    click Filter "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/pages/dashboard/components/products/components/Filter.jsx"
    click CartButton "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/pages/dashboard/components/products/components/CartButton.jsx"
    click WishlistButton "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/pages/dashboard/components/products/components/WishlistButton.jsx"
    click CartPage "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/pages/cart-page/index.jsx"
    click ProductDetail "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/pages/product-detail-page/index.jsx"
    click SignIn "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/pages/sign-in/index.jsx"
    click SignUp "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/pages/sign-up/index.jsx"
    click Wishlist "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/pages/wishlist/index.jsx"
    click Navbar "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/components/header/index.jsx"
    click CategoryMenu "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/components/header/component/CategoryMenu.jsx"
    click SearchMenu "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/components/header/component/SearchMenu.jsx"
    click ProfileMenu "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/components/header/component/ProfileMenu.jsx"
    click Footer "https://github.com/dhruvinpatel1407/geniecart/blob/main/src/components/footer/index.jsx"

    %% Styles
    classDef ui fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef state fill:#90EE90,stroke:#333,stroke-width:1px
    classDef persist fill:#FFFF99,stroke:#333,stroke-width:1px
    classDef external fill:#D3D3D3,stroke:#333,stroke-width:1px
    classDef infra fill:#F0F8FF,stroke:#333,stroke-width:1px
```
