# saharadem/star-wars architecture

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

- Interactive diagram: https://gitdiagram.com/saharadem/star-wars
- Repository: https://github.com/saharadem/star-wars

## Overview

##### Main Application Components

A. Frontend Layer (Next.js Application)
- Client-side Components
- Server-side Components (Next.js App Router)
- State Management (Redux Store)
- UI Components
- API Integration Layer

##### Component Breakdown

A. Route Structure (Top Level)
- Home (/)
- Characters (/character)
- Squads (/squads)

- Navbar (Global Navigation)
- Character Components
- CharacterCard
- CharactersList
- CharacterDescriptionItem
- Squad Components
- SquadsList
- SquadModal (with sub-components)
- UI Components Library
- Button
- Card
- Input
- Modal
- SearchInput
- Skeletons

C. State Management (Redux)
- Store
- Species Characters Slice
- Squads Slice

D. API Integration Layer
- Characters API
- Films API
- Species API

##### Data Flow Representation

- User interactions → Components
- Components → Redux Store
- Components → API Layer
- API Layer → External Services
- Session Storage Interactions

##### Technical Stack Indicators

- Next.js
- TypeScript
- Redux
- Tailwind CSS

##### Key Architectural Patterns to Highlight

- Next.js App Router Architecture
- Component Composition Pattern
- Feature-based Directory Structure
- Type-safe Development (TypeScript)

##### Important Details

- Session Storage Integration
- Loading States
- Error Boundaries
- Type Definitions
- API Integration Points

##### The modular nature of the application with clear separation between
- Routing logic
- UI components
- Business logic
- State management
- Data fetching

##### The relationship between
- Components and their respective routes
- Components and the Redux store
- API integration layer and external services
- Session storage and state management

##### Special attention to
- The squad management feature (seems to be a core functionality)
- Character browsing and display
- Species-related functionality
- Film-related data integration

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph "Frontend Layer"
        Router["Next.js App Router"]
        Home["Home Page"]:::route
        Characters["Characters Page"]:::route
        Squads["Squads Page"]:::route
        
        Router --> Home
        Router --> Characters
        Router --> Squads
    end
    
    subgraph "Core Components"
        Navbar["Navbar"]:::component
        
        subgraph "Character Components"
            CharCard["Character Card"]:::component
            CharList["Characters List"]:::component
            CharDesc["Character Description"]:::component
        end
        
        subgraph "Squad Components"
            SquadList["Squads List"]:::component
            SquadModal["Squad Modal"]:::component
        end
        
        subgraph "UI Library"
            Button["Button"]:::ui
            Card["Card"]:::ui
            Input["Input"]:::ui
            Modal["Modal"]:::ui
            Search["Search Input"]:::ui
            Skeleton["Skeletons"]:::ui
        end
    end
    
    subgraph "State Management"
        Store["Redux Store"]:::state
        SpeciesSlice["Species Characters Slice"]:::state
        SquadsSlice["Squads Slice"]:::state
        
        Store --> SpeciesSlice
        Store --> SquadsSlice
    end
    
    subgraph "Data Layer"
        SessionStorage["Session Storage"]:::storage
        
        subgraph "API Integration"
            CharAPI["Characters API"]:::api
            FilmsAPI["Films API"]:::api
            SpeciesAPI["Species API"]:::api
        end
    end
    
    %% Relationships
    Characters --> CharList
    CharList --> CharCard
    CharCard --> CharDesc
    Squads --> SquadList
    SquadList --> SquadModal
    
    CharList -.-> Store
    SquadList -.-> Store
    Store -.-> SessionStorage
    
    CharList -.-> CharAPI
    CharList -.-> FilmsAPI
    CharList -.-> SpeciesAPI
    
    %% Click Events
    click Home "https://github.com/saharAdem/Star-Wars/blob/main/src/app/page.tsx"
    click Characters "https://github.com/saharAdem/Star-Wars/blob/main/src/app/(routes)/character/page.tsx"
    click Squads "https://github.com/saharAdem/Star-Wars/blob/main/src/app/(routes)/squads/page.tsx"
    click Navbar "https://github.com/saharAdem/Star-Wars/blob/main/src/app/components/Nabar/index.tsx"
    click CharCard "https://github.com/saharAdem/Star-Wars/blob/main/src/app/components/characters/characterCard.tsx"
    click CharList "https://github.com/saharAdem/Star-Wars/blob/main/src/app/components/characters/charactersList.tsx"
    click CharDesc "https://github.com/saharAdem/Star-Wars/blob/main/src/app/components/characters/characterDescriptionItem.tsx"
    click SquadList "https://github.com/saharAdem/Star-Wars/blob/main/src/app/components/squads/squadsList.tsx"
    click SquadModal "https://github.com/saharAdem/Star-Wars/blob/main/src/app/components/squads/squadModal/index.tsx"
    click Button "https://github.com/saharAdem/Star-Wars/blob/main/src/app/components/ui/button.tsx"
    click Card "https://github.com/saharAdem/Star-Wars/blob/main/src/app/components/ui/card.tsx"
    click Input "https://github.com/saharAdem/Star-Wars/blob/main/src/app/components/ui/input.tsx"
    click Modal "https://github.com/saharAdem/Star-Wars/blob/main/src/app/components/ui/modal.tsx"
    click Search "https://github.com/saharAdem/Star-Wars/blob/main/src/app/components/ui/SearchInput.tsx"
    click Skeleton "https://github.com/saharAdem/Star-Wars/blob/main/src/app/components/ui/skeletons.tsx"
    click Store "https://github.com/saharAdem/Star-Wars/blob/main/src/app/store/store.ts"
    click SpeciesSlice "https://github.com/saharAdem/Star-Wars/blob/main/src/app/store/features/speciesCharactersSlice.ts"
    click SquadsSlice "https://github.com/saharAdem/Star-Wars/blob/main/src/app/store/features/squadsSlice.ts"
    click CharAPI "https://github.com/saharAdem/Star-Wars/blob/main/src/lib/api/characters.ts"
    click FilmsAPI "https://github.com/saharAdem/Star-Wars/blob/main/src/lib/api/films.ts"
    click SpeciesAPI "https://github.com/saharAdem/Star-Wars/blob/main/src/lib/api/species.ts"
    click SessionStorage "https://github.com/saharAdem/Star-Wars/tree/main/src/lib/helpers/sessionStorage"
    
    %% Styling
    classDef route fill:#2563eb,color:white
    classDef component fill:#3b82f6,color:white
    classDef ui fill:#f97316,color:white
    classDef state fill:#9333ea,color:white
    classDef api fill:#22c55e,color:white
    classDef storage fill:#64748b,color:white
    
    %% Legend
    subgraph Legend
        L1["Routes"]:::route
        L2["Components"]:::component
        L3["UI Elements"]:::ui
        L4["State Management"]:::state
        L5["API Layer"]:::api
        L6["Storage"]:::storage
    end
```
