# kleneway/next-ai-starter architecture

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

- Interactive diagram: https://gitdiagram.com/kleneway/next-ai-starter
- Repository: https://github.com/kleneway/next-ai-starter

## Overview

##### Project type and purpose
- This is a full-stack Next.js 14 “Modern Stack” web application template optimized for AI-driven development.
- It provides an App-Router-based React frontend, serverless API routes (tRPC + Next.js handlers), a Prisma/Supabase Postgres database, background jobs (Inngest), and integrations with AI providers, email (Resend), and AWS S3 storage.

##### File structure
- Top-level:
- Configuration: next.config.ts, tsconfig.json, postcss.config.mjs, tailwind.config.ts, vercel.json
- CI / scripts: scripts/init.sh
- Infrastructure: prisma/schema.prisma, .env.example
- Storybook: .storybook/
- src/app – Next.js App Router pages & API endpoints
- /api/auth – NextAuth routes
- /api/trpc – tRPC endpoint
- /api/inngest, /api/transcribe, /api/upload – custom serverless handlers
- /auth, /layout.tsx, /page.tsx – React page structure
- src/components – reusable UI (Button, Toasts, SpeechToTextArea)
- src/lib – domain logic & integrations
- /api – server tRPC routers
- /auth – NextAuth helpers
- /db.ts – Prisma client
- /email – Resend integration
- /inngest.ts – Inngest client config
- /storage.ts – AWS S3 helper
- /trpc – client & server setup
- /utils, /zod – shared utilities & validation
- Other: public/ (static assets), screenshots/, stories/ (Storybook stories)

##### Extract additional insights from README
- Key patterns:
- App Router (file-based routing for pages and API)
- End-to-end typesafe tRPC
- Prisma ORM with Supabase Postgres
- NextAuth for authentication (adapter via Prisma)
- Inngest for event-driven background jobs
- Modular AI client abstraction (OpenAI, Anthropic, etc.)
- Deployment target: Vercel with environment variables.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend (Next.js App Router)"
        FR["Next.js App Router\n(src/app)"]:::frontend
    end

    %% Serverless API Layer
    subgraph "Serverless / Next.js API"
        AUTH["/api/auth\n(NextAuth.js)"]:::api
        TRPC_EP["/api/trpc\n(tRPC Endpoint)"]:::api
        INNGEST_H["/api/inngest\n(Inngest Enqueue)"]:::api
        TRANSCRIBE["/api/transcribe\n(Transcription)"]:::api
        UPLOAD["/api/upload\n(File Upload)"]:::api
    end

    %% Domain Logic & Integrations
    subgraph "Domain & Integrations"
        PRISMA_CLIENT["Prisma Client\n(src/lib/db.ts)"]:::component
        DB_SCHEMA["DB Schema\n(prisma/schema.prisma)"]:::component
        INNGEST_CLIENT["Inngest Client\n(src/lib/inngest.ts)"]:::component
        AI_CLIENT["AI Client\n(src/lib/aiClient.ts)"]:::component
        STORAGE_HELPER["AWS S3 Helper\n(src/lib/storage.ts)"]:::component
        EMAIL_SEND["Resend Email\n(src/lib/email/sendEmail.ts)"]:::component
        EMAIL_TPL["Email Templates\n(src/lib/email/templates/WelcomeEmail.tsx)"]:::component
        TRPC_ROUTER["tRPC Routers\n(src/lib/api/root.ts)"]:::component
        TRPC_CLIENT["tRPC Client & Hooks\n(src/lib/trpc/client.tsx)"]:::component
        NEXTAUTH_HELP["NextAuth Helpers\n(src/lib/auth/index.ts)"]:::component
        ZOD["Zod Schemas\n(src/lib/zod/userSchemas.ts)"]:::component
        UTILS["Shared Utilities\n(src/lib/utils.ts)"]:::component
    end

    %% Background Worker
    subgraph "Background Worker"
        WN["Inngest Worker\n(ingnest.config.ts)"]:::worker
    end

    %% Database
    DB["Supabase (Postgres)\nvia Prisma"]:::db

    %% External Services
    subgraph "External Services"
        AI["AI Providers\n(OpenAI, Anthropic)"]:::external
        RESEND["Resend\n(Email)"]:::external
        S3["AWS S3\n(Storage)"]:::external
    end

    %% Client to Frontend
    Browser-->FR
    Browser-->|HTTP|FR

    %% Frontend to API
    FR-->|tRPC Client|TRPC_EP
    FR-->|REST Upload|UPLOAD
    FR-->|REST Transcribe|TRANSCRIBE
    FR-->|REST Inngest|INNGEST_H
    FR-->|Auth Flow|AUTH

    %% API to Domain Logic
    TRPC_EP-->TRPC_ROUTER
    TRPC_ROUTER-->PRISMA_CLIENT
    PRISMA_CLIENT-->DB
    AUTH-->NEXTAUTH_HELP
    NEXTAUTH_HELP-->PRISMA_CLIENT
    INNGEST_H-->INNGEST_CLIENT
    TRANSCRIBE-->AI_CLIENT
    UPLOAD-->STORAGE_HELPER

    %% Domain to External
    STORAGE_HELPER-->S3
    AI_CLIENT-->AI

    %% Event Flow to Worker
    INNGEST_CLIENT-.->|enqueue event|WN
    WN-->AI_CLIENT
    WN-->PRISMA_CLIENT
    WN-->EMAIL_SEND
    EMAIL_SEND-->RESEND

    %% Worker DB update
    PRISMA_CLIENT-->DB

    %% Domain Helpers
    ZOD---TRPC_ROUTER
    UTILS---AUTH
    UTILS---TRPC_EP

    %% Click Events
    click FR "https://github.com/kleneway/next-ai-starter/tree/main/src/app"
    click AUTH "https://github.com/kleneway/next-ai-starter/blob/main/src/app/api/auth/[...nextauth]/route.ts"
    click TRPC_EP "https://github.com/kleneway/next-ai-starter/blob/main/src/app/api/trpc/[trpc]/route.ts"
    click INNGEST_H "https://github.com/kleneway/next-ai-starter/blob/main/src/app/api/inngest/handler.ts"
    click TRANSCRIBE "https://github.com/kleneway/next-ai-starter/blob/main/src/app/api/transcribe/route.ts"
    click UPLOAD "https://github.com/kleneway/next-ai-starter/blob/main/src/app/api/upload/route.ts"
    click WN "https://github.com/kleneway/next-ai-starter/blob/main/inngest.config.ts"
    click INNGEST_CLIENT "https://github.com/kleneway/next-ai-starter/blob/main/src/lib/inngest.ts"
    click DB_SCHEMA "https://github.com/kleneway/next-ai-starter/blob/main/prisma/schema.prisma"
    click PRISMA_CLIENT "https://github.com/kleneway/next-ai-starter/blob/main/src/lib/db.ts"
    click AI_CLIENT "https://github.com/kleneway/next-ai-starter/blob/main/src/lib/aiClient.ts"
    click EMAIL_SEND "https://github.com/kleneway/next-ai-starter/blob/main/src/lib/email/sendEmail.ts"
    click EMAIL_TPL "https://github.com/kleneway/next-ai-starter/blob/main/src/lib/email/templates/WelcomeEmail.tsx"
    click STORAGE_HELPER "https://github.com/kleneway/next-ai-starter/blob/main/src/lib/storage.ts"
    click TRPC_ROUTER "https://github.com/kleneway/next-ai-starter/blob/main/src/lib/api/root.ts"
    click TRPC_CLIENT "https://github.com/kleneway/next-ai-starter/blob/main/src/lib/trpc/client.tsx"
    click NEXTAUTH_HELP "https://github.com/kleneway/next-ai-starter/blob/main/src/lib/auth/index.ts"
    click ZOD "https://github.com/kleneway/next-ai-starter/blob/main/src/lib/zod/userSchemas.ts"
    click UTILS "https://github.com/kleneway/next-ai-starter/blob/main/src/lib/utils.ts"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#0366d6,color:#0366d6;
    classDef api fill:#DFFFE0,stroke:#28a745,color:#28a745;
    classDef worker fill:#FFE8CC,stroke:#FF8C00,color:#FF8C00;
    classDef db fill:#E8D0FF,stroke:#6f42c1,color:#6f42c1;
    classDef external fill:#F0F0F0,stroke:#6a737d,color:#6a737d;
    classDef component fill:#FFF5D0,stroke:#e36209,color:#e36209;
```
