# adrianhajdin/social_media_app architecture

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

- Interactive diagram: https://gitdiagram.com/adrianhajdin/social_media_app
- Repository: https://github.com/adrianhajdin/social_media_app

## Overview

##### Project type and purpose
- From the file tree and README, this is a single-page, full-stack social media application.
- Frontend: React.js + TypeScript + Tailwind CSS + Shadcn UI.
- Backend: Appwrite (BaaS) providing Authentication, Database (users, posts, saves), and Storage (file uploads).
- State & data fetching: React Query (TanStack Query).

##### File structure
- Top-level config files (.eslintrc.json, tsconfig.json, vite.config.ts, tailwind.config.js, vercel.json).
- src/: main codebase
- src/main.tsx: app entry point.
- src/App.tsx: root component with router/providers.
- src/_auth & src/_root: layout + page folders (Signin, Signup, Home, Explore, Profile, AllUsers, Create/Edit Post, etc.).
- src/components: reusable UI components (forms, shared UI, shadcn UI primitives).
- src/context/AuthContext.tsx: React context for auth state.
- src/hooks: custom hooks (useDebounce).
- src/lib/appwrite: Appwrite SDK config + API wrappers.
- src/lib/react-query: QueryProvider + custom queries & keys.
- src/lib/utils.ts: helpers (class names, date formatting).
- src/types: TypeScript types/interfaces.

##### README for additional insights
- Confirms use of React, Appwrite, React Query, TypeScript, Tailwind CSS, Shadcn.
- Lists features: authentication, create/edit posts, like/save, explore, infinite scrolling, responsive UI.
- Backend responsibilities (Appwrite): auth, database, file storage.

##### Elements
- Clear component labels (e.g., “React Query Provider”, “AuthContext”, “Appwrite Database”)
- Annotations for key technologies/frameworks at each layer

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Zone
    subgraph "Frontend"
        subgraph "UI Layer"
            Main["Entry Point\n(main.tsx)"]:::frontend
            App["App Shell\n(App.tsx)"]:::frontend
            AuthLayout["Authentication Layout\n(AuthLayout.tsx)"]:::frontend
            SigninForm["Sign-In Form\n(SigninForm.tsx)"]:::frontend
            SignupForm["Sign-Up Form\n(SignupForm.tsx)"]:::frontend
            RootLayout["Root Layout\n(RootLayout.tsx)"]:::frontend
            subgraph "Pages"
                Home["Home Page\n(Home.tsx)"]:::frontend
                Explore["Explore Page\n(Explore.tsx)"]:::frontend
                AllUsers["All Users Page\n(AllUsers.tsx)"]:::frontend
                Profile["Profile Page\n(Profile.tsx)"]:::frontend
                Saved["Saved Posts Page\n(Saved.tsx)"]:::frontend
                LikedPosts["Liked Posts Page\n(LikedPosts.tsx)"]:::frontend
                PostDetails["Post Details Page\n(PostDetails.tsx)"]:::frontend
                CreatePost["Create Post Page\n(CreatePost.tsx)"]:::frontend
                EditPost["Edit Post Page\n(EditPost.tsx)"]:::frontend
                UpdateProfile["Update Profile Page\n(UpdateProfile.tsx)"]:::frontend
                Index["Root Index\n(index.ts)"]:::frontend
            end
            subgraph "Shared UI Components"
                Topbar["Top Navigation Bar\n(Topbar.tsx)"]:::frontend
                Bottombar["Bottom Navigation Bar\n(Bottombar.tsx)"]:::frontend
                LeftSidebar["Left Sidebar\n(LeftSidebar.tsx)"]:::frontend
                PostCard["Post Card\n(PostCard.tsx)"]:::frontend
                PostStats["Post Statistics\n(PostStats.tsx)"]:::frontend
                GridPostList["Grid Post List\n(GridPostList.tsx)"]:::frontend
                FileUploader["File Uploader\n(FileUploader.tsx)"]:::frontend
                ProfileUploader["Profile Image Uploader\n(ProfileUploader.tsx)"]:::frontend
                Loader["Loader/Spinner\n(Loader.tsx)"]:::frontend
                UserCard["User Card\n(UserCard.tsx)"]:::frontend
            end
            PostForm["Post Form\n(PostForm.tsx)"]:::frontend
            AuthContext["Authentication Context\n(AuthContext.tsx)"]:::frontend
        end

        subgraph "State & Data Layer"
            QueryProvider["React Query Provider\n(QueryProvider.tsx)"]:::query
            QueryKeys["Query Keys\n(queryKeys.ts)"]:::query
            Queries["Queries & Mutations\n(queries.ts)"]:::query
            Debounce["Debounce Hook\n(useDebounce.ts)"]:::query
        end

        subgraph "API Layer"
            Config["SDK Configuration\n(config.ts)"]:::sdk
            API["API Wrappers\n(api.ts)"]:::sdk
        end

        Utility["Utility Functions\n(utils.ts)"]:::frontend
        Types["Type Definitions\n(index.ts)"]:::frontend
    end

    %% Backend Zone
    subgraph "Appwrite BaaS"
        AuthService["Auth Service"]:::backend
        DBService["Database Service\n(Collections: users, posts, saves)"]:::backend
        StorageService["Storage Service"]:::backend
    end

    %% Data Flow Connections
    User["User"] --> Main
    Main --> App
    App --> QueryProvider
    QueryProvider --> AuthLayout
    QueryProvider --> RootLayout

    AuthLayout --> SigninForm
    AuthLayout --> SignupForm

    RootLayout --> Topbar
    RootLayout --> LeftSidebar
    RootLayout --> Bottombar
    RootLayout --> Pages

    Pages --> Home
    Pages --> Explore
    Pages --> AllUsers
    Pages --> Profile
    Pages --> Saved
    Pages --> LikedPosts
    Pages --> PostDetails
    Pages --> CreatePost
    Pages --> EditPost
    Pages --> UpdateProfile
    Pages --> Index

    Home --> Queries
    Explore --> Queries
    AllUsers --> Queries
    Profile --> Queries
    Saved --> Queries
    LikedPosts --> Queries
    PostDetails --> Queries
    CreatePost --> Queries
    EditPost --> Queries
    UpdateProfile --> Queries

    SigninForm --> Queries
    SignupForm --> Queries
    PostForm --> Queries

    Queries --> API
    API --> Config
    API --> AuthService
    API --> DBService
    API --> StorageService

    AuthService --> API
    DBService --> API
    StorageService --> API

    API --> Queries
    Queries --> Pages

    AuthContext --> Pages

    %% Click Events
    click Main "https://github.com/adrianhajdin/social_media_app/blob/main/src/main.tsx"
    click App "https://github.com/adrianhajdin/social_media_app/blob/main/src/App.tsx"
    click AuthLayout "https://github.com/adrianhajdin/social_media_app/blob/main/src/_auth/AuthLayout.tsx"
    click SigninForm "https://github.com/adrianhajdin/social_media_app/blob/main/src/_auth/forms/SigninForm.tsx"
    click SignupForm "https://github.com/adrianhajdin/social_media_app/blob/main/src/_auth/forms/SignupForm.tsx"
    click RootLayout "https://github.com/adrianhajdin/social_media_app/blob/main/src/_root/RootLayout.tsx"
    click Home "https://github.com/adrianhajdin/social_media_app/blob/main/src/_root/pages/Home.tsx"
    click Explore "https://github.com/adrianhajdin/social_media_app/blob/main/src/_root/pages/Explore.tsx"
    click AllUsers "https://github.com/adrianhajdin/social_media_app/blob/main/src/_root/pages/AllUsers.tsx"
    click Profile "https://github.com/adrianhajdin/social_media_app/blob/main/src/_root/pages/Profile.tsx"
    click Saved "https://github.com/adrianhajdin/social_media_app/blob/main/src/_root/pages/Saved.tsx"
    click LikedPosts "https://github.com/adrianhajdin/social_media_app/blob/main/src/_root/pages/LikedPosts.tsx"
    click PostDetails "https://github.com/adrianhajdin/social_media_app/blob/main/src/_root/pages/PostDetails.tsx"
    click CreatePost "https://github.com/adrianhajdin/social_media_app/blob/main/src/_root/pages/CreatePost.tsx"
    click EditPost "https://github.com/adrianhajdin/social_media_app/blob/main/src/_root/pages/EditPost.tsx"
    click UpdateProfile "https://github.com/adrianhajdin/social_media_app/blob/main/src/_root/pages/UpdateProfile.tsx"
    click Index "https://github.com/adrianhajdin/social_media_app/blob/main/src/_root/pages/index.ts"
    click Topbar "https://github.com/adrianhajdin/social_media_app/blob/main/src/components/shared/Topbar.tsx"
    click Bottombar "https://github.com/adrianhajdin/social_media_app/blob/main/src/components/shared/Bottombar.tsx"
    click LeftSidebar "https://github.com/adrianhajdin/social_media_app/blob/main/src/components/shared/LeftSidebar.tsx"
    click PostCard "https://github.com/adrianhajdin/social_media_app/blob/main/src/components/shared/PostCard.tsx"
    click PostStats "https://github.com/adrianhajdin/social_media_app/blob/main/src/components/shared/PostStats.tsx"
    click GridPostList "https://github.com/adrianhajdin/social_media_app/blob/main/src/components/shared/GridPostList.tsx"
    click FileUploader "https://github.com/adrianhajdin/social_media_app/blob/main/src/components/shared/FileUploader.tsx"
    click ProfileUploader "https://github.com/adrianhajdin/social_media_app/blob/main/src/components/shared/ProfileUploader.tsx"
    click Loader "https://github.com/adrianhajdin/social_media_app/blob/main/src/components/shared/Loader.tsx"
    click UserCard "https://github.com/adrianhajdin/social_media_app/blob/main/src/components/shared/UserCard.tsx"
    click PostForm "https://github.com/adrianhajdin/social_media_app/blob/main/src/components/forms/PostForm.tsx"
    click AuthContext "https://github.com/adrianhajdin/social_media_app/blob/main/src/context/AuthContext.tsx"
    click Debounce "https://github.com/adrianhajdin/social_media_app/blob/main/src/hooks/useDebounce.ts"
    click Config "https://github.com/adrianhajdin/social_media_app/blob/main/src/lib/appwrite/config.ts"
    click API "https://github.com/adrianhajdin/social_media_app/blob/main/src/lib/appwrite/api.ts"
    click QueryProvider "https://github.com/adrianhajdin/social_media_app/blob/main/src/lib/react-query/QueryProvider.tsx"
    click QueryKeys "https://github.com/adrianhajdin/social_media_app/blob/main/src/lib/react-query/queryKeys.ts"
    click Queries "https://github.com/adrianhajdin/social_media_app/blob/main/src/lib/react-query/queries.ts"
    click Utility "https://github.com/adrianhajdin/social_media_app/blob/main/src/lib/utils.ts"
    click Types "https://github.com/adrianhajdin/social_media_app/blob/main/src/types/index.ts"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#0366d6,color:#000
    classDef query fill:#FFE5B4,stroke:#FF8C00,color:#000
    classDef sdk fill:#E5D4ED,stroke:#800080,color:#000
    classDef backend fill:#DFF2BF,stroke:#4F8A10,color:#000
```
