# ronixa584/twitter architecture

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

- Interactive diagram: https://gitdiagram.com/ronixa584/twitter
- Repository: https://github.com/ronixa584/twitter

## Overview

##### Main Components

A. Frontend Layer (Twitter Client):
- Next.js Application Container
- Components Module (FeedCard, Layout, PostTweet)
- Pages/Routing (Dynamic routes with [id])
- GraphQL Client Integration
- Hooks Layer (tweet.ts, user.ts)

B. Backend Layer (Twitter Server):
- Express.js Server
- GraphQL API Layer
- Service Layer
- Tweet Service
- User Service
- JWT Service
- Database Layer (Prisma ORM)

C. External Services:
- Supabase Database
- GCP Storage
- GraphQL API Gateway

##### Component Relationships

**[Frontend] ←→ [GraphQL API Gateway] ←→ [Backend Services] ←→ [Database]**

##### Important Architectural Patterns to Highlight

- GraphQL-based communication between frontend and backend
- Service-based architecture in the backend
- Type-safe data flow (TypeScript throughout)
- ORM abstraction layer
- JWT-based authentication flow

##### Technical Details

Frontend:
**[Next.js App]**
- Component Layer
- GraphQL Client
- React Query
- TailwindCSS

Backend:
**[Express Server]**
- GraphQL API
- Services
- Resolvers
- Prisma Client

Database:
**[Supabase]**
- User Data
- Tweet Data
- Relationships

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Frontend
        NextApp["Next.js Application"]:::frontend
        click NextApp "https://github.com/Ronixa584/Twitter/tree/main/twitter-client/"
        
        subgraph FrontendComponents
            UIComp["UI Components"]:::frontend
            click UIComp "https://github.com/Ronixa584/Twitter/tree/main/twitter-client/app/Componenet/"
            GQLClient["GraphQL Client"]:::frontend
            click GQLClient "https://github.com/Ronixa584/Twitter/blob/main/twitter-client/clients/api.ts"
            Hooks["Hooks Layer"]:::frontend
            click Hooks "https://github.com/Ronixa584/Twitter/tree/main/twitter-client/hooks/"
            GQLOps["GraphQL Operations"]:::frontend
            click GQLOps "https://github.com/Ronixa584/Twitter/tree/main/twitter-client/graphql/"
        end
        
        NextApp --> FrontendComponents
    end

    subgraph Backend
        Express["Express.js Server"]:::backend
        click Express "https://github.com/Ronixa584/Twitter/tree/main/twitter-server/src/app/"
        
        subgraph Services
            TweetSvc["Tweet Service"]:::service
            click TweetSvc "https://github.com/Ronixa584/Twitter/blob/main/twitter-server/src/app/services/tweet.ts"
            UserSvc["User Service"]:::service
            click UserSvc "https://github.com/Ronixa584/Twitter/blob/main/twitter-server/src/app/services/user.ts"
            JWTSvc["JWT Service"]:::service
            click JWTSvc "https://github.com/Ronixa584/Twitter/blob/main/twitter-server/src/app/services/jwt.ts"
        end
        
        subgraph GraphQLAPI
            TweetModule["Tweet Module"]:::api
            click TweetModule "https://github.com/Ronixa584/Twitter/tree/main/twitter-server/src/app/tweet/"
            UserModule["User Module"]:::api
            click UserModule "https://github.com/Ronixa584/Twitter/tree/main/twitter-server/src/app/user/"
            
            TweetTypes["Tweet Types"]:::types
            click TweetTypes "https://github.com/Ronixa584/Twitter/blob/main/twitter-server/src/app/tweet/types.ts"
            UserTypes["User Types"]:::types
            click UserTypes "https://github.com/Ronixa584/Twitter/blob/main/twitter-server/src/app/user/types.ts"
        end
        
        Express --> Services
        Express --> GraphQLAPI
    end

    subgraph DataLayer
        PrismaORM["Prisma ORM"]:::database
        click PrismaORM "https://github.com/Ronixa584/Twitter/tree/main/twitter-server/prisma/"
        DBClient["Database Client"]:::database
        click DBClient "https://github.com/Ronixa584/Twitter/tree/main/twitter-server/src/app/clients/db/"
        Schema["Schema Definition"]:::database
        click Schema "https://github.com/Ronixa584/Twitter/blob/main/twitter-server/prisma/schema.prisma"
        
        Supabase["Supabase Database"]:::external
        GCPStorage["GCP Storage"]:::external
    end

    GQLClient --> Express
    Services --> PrismaORM
    PrismaORM --> DBClient
    DBClient --> Supabase
    Services --> GCPStorage

    classDef frontend fill:#3498db,stroke:#2980b9,color:white
    classDef backend fill:#2ecc71,stroke:#27ae60,color:white
    classDef service fill:#e74c3c,stroke:#c0392b,color:white
    classDef api fill:#9b59b6,stroke:#8e44ad,color:white
    classDef database fill:#34495e,stroke:#2c3e50,color:white
    classDef external fill:#f1c40f,stroke:#f39c12,color:black
    classDef types fill:#1abc9c,stroke:#16a085,color:white
```
