# khuongduy354/unsleepable architecture

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

- Interactive diagram: https://gitdiagram.com/khuongduy354/unsleepable
- Repository: https://github.com/khuongduy354/unsleepable

## Overview

##### Project type and purpose
- From the file tree and README, this is a full-stack web application built with Next.js (app router) and TypeScript, using Supabase (PostgreSQL + Auth) as its backend.
- It provides user authentication (login, register, OAuth via Google) and a “post” API for creating/reading content.

##### File structure
- Top-level:
- next.config.ts, tsconfig.json, package.json – build & config for Next.js + TS
- public/ – static assets
- middleware.ts – global auth or routing middleware
- src/app/ – Next.js App Router pages & API routes
· src/app/page.tsx, layout.tsx, globals.css – root layout & styling
· src/app/auth/… – login, logout, signup pages & UI components
· src/app/api/auth/… – auth callback handlers
· src/app/api/post/route.ts – CRUD API for posts
- src/lib/ – core business & infrastructure code
· services/post.service.ts – domain logic
· repositories/supabase.repository.ts – DB abstraction
· auth-actions.ts – helpers for login/register flows
· setup/… – environment and production setup
· types/ – domain TypeScript types
- src/utils/supabase/ – raw Supabase client and server wrappers
- Architectural patterns:
- “App Router” for pages + API routes
- Layered approach: UI → services → repositories → Supabase
- Middleware for auth enforcement

##### Detailed capture of essential elements
- UI Components (SignInWithGoogleButton, LoginForm, etc.)
- Next.js App Router pages (page.tsx under /auth, /post, root page)
- API Route handlers (route.ts files)
- Middleware.ts (global auth guard)
- Domain Services (post.service.ts)
- Repositories (supabase.repository.ts)
- Supabase client utils (client.ts, server.ts, middleware.ts)
- External: Supabase Database + Supabase Auth + Google OAuth

Putting it all together:
[User Browser]
│
▼
[Next.js App Router] ──(middleware.ts)
- Pages & Components
- fetch("/api/post")
│
▼
[API Routes (/api/auth, /api/post)]
│
▼
[Domain Services Layer]
- auth-actions.ts
- post.service.ts
│
▼
[Repositories Layer]
- supabase.repository.ts
│
▼
[Supabase Infra]
- PostgreSQL
- Auth (JWT)
- OAuth Google

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% User
    User["User Browser"]:::external

    %% Frontend Layer
    subgraph "Frontend (UI Layer)"
        direction TB
        Pages["page.tsx"]:::frontend
        Layout["layout.tsx"]:::frontend
        Styles["globals.css"]:::frontend

        subgraph "Auth Pages"
            direction TB
            LoginPage["login/page.tsx"]:::frontend
            LogoutPage["logout/page.tsx"]:::frontend
            RegisterPage["register/page.tsx"]:::frontend
            SignupPage["signup/page.tsx"]:::frontend
        end

        subgraph "Auth UI Components"
            direction TB
            GoogleButton["SignInWithGoogleButton.tsx"]:::frontend
            LoginForm["loginForm.tsx"]:::frontend
            SignUpForm["SignUpForm.tsx"]:::frontend
            ButtonUI["button.tsx"]:::frontend
            CardUI["card.tsx"]:::frontend
            InputUI["input.tsx"]:::frontend
            LabelUI["label.tsx"]:::frontend
        end
    end

    %% Utils Layer
    subgraph "Utilities"
        direction TB
        ClientUtil["client.ts"]:::util
        ServerUtil["server.ts"]:::util
        SupabaseMiddleware["middleware.ts"]:::util
    end

    %% Next.js Server
    subgraph "Next.js Server"
        direction TB
        GlobalMiddleware["middleware.ts"]:::server
    end

    %% API Routes
    subgraph "API Routes" 
        direction TB
        AuthCallback["/api/auth/callback"]:::api
        PostRoute["/api/post"]:::api
    end

    %% Domain Services
    subgraph "Domain Services"
        direction TB
        AuthActions["auth-actions.ts"]:::service
        PostService["post.service.ts"]:::service
    end

    %% Repositories
    subgraph "Repositories"
        direction TB
        SupabaseRepo["supabase.repository.ts"]:::repo
    end

    %% Supabase Infrastructure
    subgraph "Supabase Infrastructure"
        direction TB
        PostgresDB["PostgreSQL"]:::external
        AuthService["Supabase Auth"]:::external
        GoogleOAuth["Google OAuth"]:::external
    end

    %% Connections
    User -->|"navigates to"| Pages
    Pages -->|"uses Layout"| Layout
    Pages -->|"imports Styles"| Styles
    Pages -->|"renders"| LoginPage
    Pages -->|"renders"| LogoutPage
    Pages -->|"renders"| RegisterPage
    Pages -->|"renders"| SignupPage
    LoginPage -->|"uses"| GoogleButton
    LoginPage -->|"uses"| LoginForm
    SignupPage -->|"uses"| SignUpForm
    GoogleButton -->|"imports util"| ClientUtil

    User -->|"requests"| GlobalMiddleware
    GlobalMiddleware -->|"calls"| SupabaseMiddleware

    User -->|"fetch /api/auth/callback"| AuthCallback
    User -->|"fetch /api/post"| PostRoute

    AuthCallback -->|"invokes"| AuthActions
    PostRoute -->|"invokes"| PostService

    AuthActions -->|"calls"| SupabaseRepo
    PostService -->|"calls"| SupabaseRepo

    SupabaseRepo -->|"query"| ClientUtil
    SupabaseRepo -->|"query"| ServerUtil

    SupabaseRepo -->|"connects to"| PostgresDB
    SupabaseRepo -->|"uses"| AuthService
    AuthService -->|"OAuth flow"| GoogleOAuth

    %% Click Events
    click Pages "https://github.com/khuongduy354/unsleepable/blob/master/src/app/page.tsx"
    click Layout "https://github.com/khuongduy354/unsleepable/blob/master/src/app/layout.tsx"
    click Styles "https://github.com/khuongduy354/unsleepable/blob/master/src/app/globals.css"
    click LoginPage "https://github.com/khuongduy354/unsleepable/blob/master/src/app/auth/login/page.tsx"
    click LogoutPage "https://github.com/khuongduy354/unsleepable/blob/master/src/app/auth/logout/page.tsx"
    click RegisterPage "https://github.com/khuongduy354/unsleepable/blob/master/src/app/auth/register/page.tsx"
    click SignupPage "https://github.com/khuongduy354/unsleepable/blob/master/src/app/auth/signup/page.tsx"
    click GoogleButton "https://github.com/khuongduy354/unsleepable/blob/master/src/app/auth/login/components/SignInWithGoogleButton.tsx"
    click LoginForm "https://github.com/khuongduy354/unsleepable/blob/master/src/app/auth/login/components/loginForm.tsx"
    click SignUpForm "https://github.com/khuongduy354/unsleepable/blob/master/src/app/auth/signup/components/SignUpForm.tsx"
    click ButtonUI "https://github.com/khuongduy354/unsleepable/blob/master/src/app/auth/ui/button.tsx"
    click CardUI "https://github.com/khuongduy354/unsleepable/blob/master/src/app/auth/ui/card.tsx"
    click InputUI "https://github.com/khuongduy354/unsleepable/blob/master/src/app/auth/ui/input.tsx"
    click LabelUI "https://github.com/khuongduy354/unsleepable/blob/master/src/app/auth/ui/label.tsx"
    click SupabaseMiddleware "https://github.com/khuongduy354/unsleepable/blob/master/src/utils/supabase/middleware.ts"
    click ClientUtil "https://github.com/khuongduy354/unsleepable/blob/master/src/utils/supabase/client.ts"
    click ServerUtil "https://github.com/khuongduy354/unsleepable/blob/master/src/utils/supabase/server.ts"
    click GlobalMiddleware "https://github.com/khuongduy354/unsleepable/blob/master/middleware.ts"
    click AuthCallback "https://github.com/khuongduy354/unsleepable/blob/master/src/app/api/auth/callback/route.ts"
    click PostRoute "https://github.com/khuongduy354/unsleepable/blob/master/src/app/api/post/route.ts"
    click AuthActions "https://github.com/khuongduy354/unsleepable/blob/master/src/lib/auth-actions.ts"
    click PostService "https://github.com/khuongduy354/unsleepable/blob/master/src/lib/services/post.service.ts"
    click SupabaseRepo "https://github.com/khuongduy354/unsleepable/blob/master/src/lib/repositories/supabase.repository.ts"

    %% Styles
    classDef frontend fill:#cfe2f3,stroke:#084298,stroke-width:1px
    classDef server fill:#d1e7dd,stroke:#0f5132,stroke-width:1px
    classDef api fill:#cff4fc,stroke:#055160,stroke-width:1px
    classDef service fill:#fff3cd,stroke:#664d03,stroke-width:1px
    classDef repo fill:#ffe5d9,stroke:#a71d2a,stroke-width:1px
    classDef util fill:#e2e3e5,stroke:#6c757d,stroke-width:1px
    classDef external fill:#f8d7da,stroke:#842029,stroke-width:1px
```
