# sakatai11/todoapp-next architecture

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

- Interactive diagram: https://gitdiagram.com/sakatai11/todoapp-next
- Repository: https://github.com/sakatai11/todoapp-next

## Overview

##### Project type and purpose
- This is a full-stack Next.js application (“TodoApp-Next”) for task management.
- It provides user authentication (NextAuth.js + Firebase Auth), CRUD operations on tasks stored in Firestore, drag-and-drop ordering, modals, real-time updates, and responsive UI.

##### File structure
- Top-level “app/” folder uses Next.js App Router: page routes, layout, API endpoints under “app/api/”.
- “features/” directory follows a feature-based modular pattern: each feature (todo, sign, top, shared components) encapsulates components, templates, hooks, contexts, and utilities.
- “app/libs/” and “features/libs/” expose shared client/server utilities (API clients, Firebase Admin helpers, markdown processing).
- “app/utils/” and “features/utils/” contain pure functions and validation logic.
- “types/” houses TypeScript interfaces.
- Configuration and deployment files include next.config.ts, middleware.ts, vercel.json.

##### README for additional insights
- Confirms Next.js + React + Tailwind + MUI on front end.
- Backend logic lives in Next.js API routes calling Firebase (Auth & Firestore).
- Data fetching uses SWR; drag-and-drop uses @dnd-kit/core; validation via Zod.
- Deployed on Vercel.

##### Main components and interactions (to show
a. Frontend (Browser/Client)
- Next.js React components under “app/” and “features/”.
- React Context (TodoContext) for in-page state.
- SWR hook layer for data fetching and caching.
- Drag-and-drop UI (@dnd-kit/core), modals, MUI UI elements, Tailwind styling.
b. Next.js Server (Vercel Edge / Node)
- App Router handles SSR/SSG for UI pages: / (landing), /auth/(signin, signup), /dashboard/todo.
- API Routes under app/api/… implement server handlers:
– /auth/[...nextauth] → NextAuth.js
– /auth/refresh, server-login → custom token flows
– /todos, /lists, /user, /info → CRUD against Firestore via Firebase Admin SDK
c. External Services
- Firebase Authentication (sign in/up, token issuance)
- Firestore (tasks, lists, user profiles)
- NextAuth.js for session management
d. Data flows
- Browser → Next.js pages → SWR → Next.js API → Firebase → Next.js → Browser updates.
- Browser → NextAuth.js endpoints → Firebase Auth → JWT/Session cookie → Browser.

##### Architectural patterns and design principles
- Feature-based modularity: each feature isolates its UI, logic, and hooks.
- App Router with nested layouts: shared headers, loading states, grouping of auth vs. dashboard routes.
- API-route-as-backend: Next.js functions act as microservices connecting to Firebase.
- React Context for ephemeral UI state; SWR for remote state caching.
- Separation of concerns: libs for data layer, utils for pure helpers.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Browser/Client" 
        direction TB
        subgraph "Pages & Layouts" 
            direction TB
            Home["Home Page"]:::frontend
            click Home "https://github.com/sakatai11/todoapp-next/blob/main/app/page.tsx"
            SignIn["Sign In Page"]:::frontend
            click SignIn "https://github.com/sakatai11/todoapp-next/blob/main/app/(auth)/signin/page.tsx"
            SignUp["Sign Up Page"]:::frontend
            click SignUp "https://github.com/sakatai11/todoapp-next/blob/main/app/(auth)/signup/page.tsx"
            Dashboard["Dashboard Todo Page"]:::frontend
            click Dashboard "https://github.com/sakatai11/todoapp-next/blob/main/app/(dashboard)/todo/page.tsx"
            GlobalLayout["Global Layout"]:::frontend
            click GlobalLayout "https://github.com/sakatai11/todoapp-next/blob/main/app/layout.tsx"
            RootTemplate["Root Template"]:::frontend
            click RootTemplate "https://github.com/sakatai11/todoapp-next/blob/main/app/template.tsx"
        end
        subgraph "Feature Wrappers" 
            direction TB
            HeaderWrapper["Header Wrapper"]:::frontend
            click HeaderWrapper "https://github.com/sakatai11/todoapp-next/blob/main/features/shared/templates/HeaderWrapper.tsx"
            ContactWrapper["Sign Wrapper"]:::frontend
            click ContactWrapper "https://github.com/sakatai11/todoapp-next/blob/main/features/sign/templates/ContactWrapper.tsx"
            TodoWrapper["Todo Wrapper"]:::frontend
            click TodoWrapper "https://github.com/sakatai11/todoapp-next/blob/main/features/todo/templates/TodoWrapper.tsx"
            TopWrapper["Top Wrapper"]:::frontend
            click TopWrapper "https://github.com/sakatai11/todoapp-next/blob/main/features/top/templates/TopWrapper.tsx"
        end
        subgraph "UI & State" 
            direction TB
            MUI["MUI UI"]:::frontend
            Tailwind["Tailwind Styles"]:::frontend
            DnD["@dnd-kit DnD"]:::frontend
            Context["React Context"]:::frontend
            SWR["SWR Data Fetch"]:::frontend
        end
    end

    subgraph "Next.js Server" 
        direction TB
        AppRouter["App Router (SSR/SSG)"]:::backend
        subgraph "API Routes" 
            direction TB
            NextAuthRoute["NextAuth.js Endpoint"]:::backend
            click NextAuthRoute "https://github.com/sakatai11/todoapp-next/blob/main/app/api/auth/[...nextauth]/route.ts"
            RefreshRoute["Refresh Token Endpoint"]:::backend
            click RefreshRoute "https://github.com/sakatai11/todoapp-next/blob/main/app/api/auth/refresh/route.ts"
            ServerLogin["Server-Login Endpoint"]:::backend
            click ServerLogin "https://github.com/sakatai11/todoapp-next/blob/main/app/api/auth/server-login/route.ts"
            TodosRoute["Todos CRUD Endpoint"]:::backend
            click TodosRoute "https://github.com/sakatai11/todoapp-next/blob/main/app/api/todos/route.ts"
            ListsRoute["Lists CRUD Endpoint"]:::backend
            click ListsRoute "https://github.com/sakatai11/todoapp-next/blob/main/app/api/lists/route.ts"
            UserRoute["User Profile Endpoint"]:::backend
            click UserRoute "https://github.com/sakatai11/todoapp-next/blob/main/app/api/user/route.ts"
            InfoRoute["Info Endpoint"]:::backend
            click InfoRoute "https://github.com/sakatai11/todoapp-next/blob/main/app/api/info/route.ts"
        end
        subgraph "Server Utilities" 
            direction TB
            FirebaseAdmin["Firebase Admin Helpers"]:::backend
            click FirebaseAdmin "https://github.com/sakatai11/todoapp-next/blob/main/app/libs/firebaseAdmin.ts"
            ApisClient["API Client"]:::backend
            click ApisClient "https://github.com/sakatai11/todoapp-next/blob/main/app/libs/apis.ts"
            AuthUtils["Auth Utilities"]:::backend
            click AuthUtils "https://github.com/sakatai11/todoapp-next/blob/main/app/utils/authUtils.ts"
            WithAuth["HOC Auth Wrapper"]:::backend
            click WithAuth "https://github.com/sakatai11/todoapp-next/blob/main/app/libs/withAuth.ts"
        end
    end

    subgraph "External Services" 
        direction TB
        AuthService["Firebase Auth"]:::external
        FirestoreDB["Firestore DB"]:::external
    end

    %% Connections
    Home -->|“SSR/SSG”| AppRouter
    SignIn -->|“SSR/SSG”| AppRouter
    SignUp -->|“SSR/SSG”| AppRouter
    Dashboard -->|“SSR/SSG”| AppRouter

    Context -->|“useContext”| AppRouter
    SWR -->|“fetch data”| TodosRoute
    SWR -->|“fetch data”| ListsRoute
    SWR -->|“fetch user”| UserRoute

    NextAuthRoute -->|“Admin SDK”| AuthService
    RefreshRoute -->|“Admin SDK”| AuthService
    ServerLogin -->|“Admin SDK”| AuthService
    NextAuthRoute -->|“session”| AppRouter

    TodosRoute -->|“Firebase Admin SDK”| FirebaseAdmin
    ListsRoute -->|“Firebase Admin SDK”| FirebaseAdmin
    UserRoute -->|“Firebase Admin SDK”| FirebaseAdmin
    InfoRoute -->|“Firebase Admin SDK”| FirebaseAdmin

    FirebaseAdmin -->|“reads/writes”| FirestoreDB

    AppRouter -->|“calls API”| TodosRoute
    AppRouter -->|“calls API”| ListsRoute
    AppRouter -->|“calls API”| UserRoute
    AppRouter -->|“calls API”| InfoRoute

    %% Styles
    classDef frontend fill:#E0F7FA,stroke:#00796B,stroke-width:1px;
    classDef backend fill:#E8F5E9,stroke:#388E3C,stroke-width:1px;
    classDef external fill:#FFF3E0,stroke:#F57C00,stroke-width:1px;
```
