# jacksonkasi1/flexisheet architecture

> Architecture diagram of the GitHub repository jacksonkasi1/flexisheet, 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/jacksonkasi1/flexisheet
- Repository: https://github.com/jacksonkasi1/flexisheet

## Overview

##### Main Components

A. Client-Side Layer
- Pages/Routes (from src/app directory)
- Components (from src/components)
- Client-side Utils (from src/lib)

B. Next.js Framework Layer
- App Router
- Server Components
- Client Components
- Static/Dynamic Rendering

C. Build & Configuration Layer
- TypeScript Configuration
- Tailwind CSS
- ESLint
- PostCSS

**┌─────────────────────────────────────────┐**
- Client Browser               │
- ┘
- ↕️
**┌─────────────────────────────────────────┐**
- Next.js App                  │
- ┌─────────┐  ┌─────────┐  ┌─────────┐ │
- Pages  │  │  Comps  │  │  Utils  │ │
- ┘  └─────────┘  └─────────┘ │
- ┘
- ↕️
**┌─────────────────────────────────────────┐**
- Build & Configuration           │
- ┘

##### Detailed Component Breakdown

Pages Layer:
- Route structure (/normal, root page)
- Layout.tsx as the root layout
- Global styles and configurations

Components Layer:
- Sheet-table component structure
- UI components (table.tsx)
- Backup components
- Relationship with schemas (row-data-schema.ts)

Utils Layer:
- Utility functions and their relationships
- How they connect to components

##### Additional Elements

- Static file handling (public directory)
- Configuration files (next.config.ts, tailwind.config.ts)
- Build process flow
- Development server setup

##### Client-server boundary in the Next.js context

Key Relationships to Highlight:

- How pages use components
- How components utilize utilities
- How schemas validate data
- How styles are applied (Tailwind CSS integration)

Remember to:

- Use consistent styling and spacing
- Version information for key dependencies
- Document any important architectural decisions

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Client
        Browser["Web Browser"]
    end

    subgraph NextApp["Next.js Application"]
        subgraph Pages
            RootLayout["Root Layout"]:::server
            GlobalStyles["Global Styles"]:::styles
            MainPage["Main Page Route"]:::server
            NormalPage["Normal Page Route"]:::server
        end

        subgraph Components
            SheetTable["Sheet Table Component"]:::client
            BackupComps["Backup Components"]:::client
            UITable["UI Components"]:::client
        end

        subgraph Utils
            UtilsFn["Utility Functions"]:::utils
            CompUtils["Component Utils"]:::utils
            DataSchema["Data Schema"]:::utils
        end
    end

    subgraph Config["Build & Configuration"]
        TSConfig["TypeScript Config"]:::config
        NextConfig["Next.js Config"]:::config
        TailwindConfig["Tailwind Config"]:::config
        ESLintConfig["ESLint Config"]:::config
        PostCSSConfig["PostCSS Config"]:::config
    end

    %% Relationships
    Browser <--> RootLayout
    RootLayout --> GlobalStyles
    RootLayout --> MainPage
    RootLayout --> NormalPage
    
    MainPage --> SheetTable
    NormalPage --> SheetTable
    SheetTable --> BackupComps
    SheetTable --> UITable
    
    SheetTable --> CompUtils
    SheetTable --> UtilsFn
    SheetTable --> DataSchema

    %% Click Events
    click RootLayout "https://github.com/jacksonkasi1/FlexiSheet/blob/main/src/app/layout.tsx"
    click GlobalStyles "https://github.com/jacksonkasi1/FlexiSheet/blob/main/src/app/globals.css"
    click MainPage "https://github.com/jacksonkasi1/FlexiSheet/blob/main/src/app/page.tsx"
    click NormalPage "https://github.com/jacksonkasi1/FlexiSheet/blob/main/src/app/normal/page.tsx"
    click SheetTable "https://github.com/jacksonkasi1/FlexiSheet/blob/main/src/components/sheet-table/index.tsx"
    click BackupComps "https://github.com/jacksonkasi1/FlexiSheet/blob/main/src/components/backup/sheet-table.tsx"
    click UITable "https://github.com/jacksonkasi1/FlexiSheet/blob/main/src/components/ui/table.tsx"
    click UtilsFn "https://github.com/jacksonkasi1/FlexiSheet/blob/main/src/lib/utils.ts"
    click CompUtils "https://github.com/jacksonkasi1/FlexiSheet/blob/main/src/components/sheet-table/utils.ts"
    click DataSchema "https://github.com/jacksonkasi1/FlexiSheet/blob/main/src/schemas/row-data-schema.ts"
    click TSConfig "https://github.com/jacksonkasi1/FlexiSheet/blob/main/tsconfig.json"
    click NextConfig "https://github.com/jacksonkasi1/FlexiSheet/blob/main/next.config.ts"
    click TailwindConfig "https://github.com/jacksonkasi1/FlexiSheet/blob/main/tailwind.config.ts"
    click ESLintConfig "https://github.com/jacksonkasi1/FlexiSheet/blob/main/eslint.config.mjs"
    click PostCSSConfig "https://github.com/jacksonkasi1/FlexiSheet/blob/main/postcss.config.mjs"

    %% Styles
    classDef default fill:#f9f9f9,stroke:#333,stroke-width:2px
    classDef server fill:#90EE90,stroke:#333
    classDef client fill:#87CEEB,stroke:#333
    classDef utils fill:#FFB6C1,stroke:#333
    classDef config fill:#D3D3D3,stroke:#333
    classDef styles fill:#FFA500,stroke:#333

    %% Legend
    subgraph Legend
        ServerComp["Server Component"]:::server
        ClientComp["Client Component"]:::client
        UtilsComp["Utilities"]:::utils
        ConfigComp["Configuration"]:::config
        StylesComp["Styles"]:::styles
    end
```
