# adiwanwade/everynote architecture

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

- Interactive diagram: https://gitdiagram.com/adiwanwade/everynote
- Repository: https://github.com/adiwanwade/everynote

## Overview

##### Project Type and Purpose
- This is a full-stack monorepo starter built with Turborepo (“T3 Turbo”), featuring two front-ends (a Next.js web app and an Expo mobile app) and a shared backend API.
- It demonstrates a modular, package-based architecture: front-ends in `apps/`, shared business logic and services in `packages/`, plus centralized tooling in `tooling/`.

##### High-Level Architecture Components
a. Frontend Apps
- apps/nextjs – Next.js 14 web application, serves pages, static assets, and tRPC API routes.
- apps/expo – Expo SDK React Native mobile application, uses Expo Router and NativeWind.
b. Shared Backend & Business Logic
- packages/api – tRPC v11 router definitions (auth, notes, post) used by Next.js to serve JSON-RPC.
- packages/auth – Better Auth server/client code (JWT, middleware, environment).
- packages/db – Drizzle ORM schema and client configured for Supabase (edge runtime).
- packages/validators – Shared Zod or custom validators for input sanitization.
- packages/ui – Shadcn-style React UI components consumed by both front-ends.
c. External Services
- Supabase / Vercel Postgres – hosted database for Drizzle ORM.
- Vercel – hosts Next.js; indispensible for API and tRPC endpoints.
- Expo / EAS – mobile build, OTA update, and App Store distribution.
d. Tooling
- Turborepo (turbo.json) – orchestrates builds, lint, tests across packages/apps.
- pnpm – workspace package manager (pnpm-workspace.yaml).
- Shared ESLint/Prettier/Tailwind/TypeScript configs in `tooling/`.

##### Component Interactions & Data Flows
- Next.js App
→ imports `packages/api` to expose tRPC endpoint under `/api/trpc`.
→ uses `packages/auth` middleware to secure routes and issue JWTs.
→ uses `packages/db` to read/write from Supabase (edge).
→ consumes `packages/ui` for consistent UI.
- Expo App
→ imports `packages/api` as a dev-only dependency for typesafety.
→ uses a custom `getBaseUrl` to call tRPC endpoints on the deployed Next.js server.
→ stores session via `session-store`, fetches via `AuthContext` powered by Better Auth.
→ consumes `packages/ui` for mobile UI components.
- Database & Auth
→ `packages/db` and `packages/auth` coordinate to enforce schema and auth rules.
→ tRPC resolvers call into `packages/db` and `packages/auth` to perform business operations.

##### Architectural Patterns & Design Principles
- Monorepo with strict module boundaries: each package has its own `tsconfig`, `package.json`, build outputs.
- Layered architecture: front-end → API layer (tRPC) → services (auth, db) → external systems.
- Code sharing via packages: UI, validation, API contracts are single-sourced.
- Edge-first patterns: Next.js API routes configured with `export const runtime = "edge"`.
- Convention-based routing in Next.js and Expo Router.

##### Essential Elements to Capture
- Monorepo root orchestrated by Turborepo & pnpm.
- Two app entry points: Next.js (web, server + client) and Expo (native mobile).
- API layer (tRPC) sitting inside Next.js, backed by packages/api, packages/auth, packages/db.
- Shared packages: ui, validators.
- External dependencies: Supabase, Vercel, EAS/Expo build services.
- Data flows: Front-end → tRPC → Auth/DB → External DB.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Monorepo Root"
        Root["Turborepo + pnpm"]:::root
    end

    %% Frontend Apps
    subgraph "Web Application"
        direction TB
        NextApp["Next.js Web App"]:::frontend
        NextUI["UI Layer (React/Tailwind)"]:::frontend
        NextAPIClient["tRPC Client"]:::frontend
        NextApp --> NextUI
        NextApp --> NextAPIClient
    end

    subgraph "Mobile Application"
        direction TB
        ExpoApp["Expo Mobile App"]:::frontend
        ExpoUI["UI Layer (NativeWind)"]:::frontend
        ExpoAPIClient["tRPC Client"]:::frontend
        ExpoApp --> ExpoUI
        ExpoApp --> ExpoAPIClient
    end

    %% Backend
    subgraph "Backend: Next.js API Server"
        direction TB
        APIIndex["packages/api/src/index.ts"]:::backend
        TRPCSetup["packages/api/src/trpc.ts"]:::backend
        APIRoot["packages/api/src/root.ts"]:::backend
        APIRouter["tRPC Router\n(packages/api/src/router/)"]:::backend
        APIIndex --> TRPCSetup
        TRPCSetup --> APIRoot
        APIRoot --> APIRouter
    end

    %% Shared Packages
    subgraph "Shared Packages"
        direction TB
        AuthPkg["packages/auth (Auth Services)"]:::package
        DBPkg["packages/db (Drizzle ORM)"]:::package
        Validators["packages/validators"]:::package
        UIPkg["packages/ui (Shadcn UI)"]:::package
    end

    %% External Services
    subgraph "External Services"
        direction TB
        Supabase["Supabase / Postgres"]:::external
        Vercel["Vercel"]:::external
        EAS["Expo / EAS"]:::external
    end

    %% Monorepo Root Connections
    Root --> NextApp
    Root --> ExpoApp
    Root --> APIIndex

    %% Frontend to Backend
    NextAPIClient -->|"tRPC calls"| APIIndex
    ExpoAPIClient -.->|"dev types only"| APIRoot

    %% Frontend consumes shared UI
    UIPkg --> NextUI
    UIPkg --> ExpoUI

    %% Backend packages interactions
    APIRouter --> Validators
    APIRoot --> AuthPkg
    APIRoot --> DBPkg

    %% Database calls
    DBPkg --> Supabase
    %% Hosting
    NextApp --> Vercel
    APIIndex --> Vercel
    ExpoApp --> EAS

    %% Click Events
    click NextApp "https://github.com/adiwanwade/everynote/tree/main/apps/nextjs/"
    click ExpoApp "https://github.com/adiwanwade/everynote/tree/main/apps/expo/"
    click APIRouter "https://github.com/adiwanwade/everynote/tree/main/packages/api/src/router/"
    click APIIndex "https://github.com/adiwanwade/everynote/blob/main/packages/api/src/index.ts"
    click TRPCSetup "https://github.com/adiwanwade/everynote/blob/main/packages/api/src/trpc.ts"
    click APIRoot "https://github.com/adiwanwade/everynote/blob/main/packages/api/src/root.ts"
    click AuthPkg "https://github.com/adiwanwade/everynote/blob/main/packages/auth/src/auth.ts"
    click DBPkg "https://github.com/adiwanwade/everynote/blob/main/packages/db/src/client.ts"
    click Validators "https://github.com/adiwanwade/everynote/blob/main/packages/validators/src/index.ts"
    click UIPkg "https://github.com/adiwanwade/everynote/blob/main/packages/ui/src/index.ts"

    %% Styles
    classDef frontend fill:#cfe2ff,stroke:#084298,color:#084298
    classDef package fill:#d1e7dd,stroke:#0f5132,color:#0f5132
    classDef backend fill:#ffe5b4,stroke:#a64d00,color:#a64d00
    classDef external fill:#e2e3e5,stroke:#6c757d,color:#6c757d
    classDef root fill:#f8d7da,stroke:#842029,color:#842029
```
