# osanseviero/geminicoder architecture

> Architecture diagram of the GitHub repository osanseviero/geminicoder, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/osanseviero/geminicoder
- Repository: https://github.com/osanseviero/geminicoder

## Overview

##### Main Components

a) Frontend Layer:
- Next.js Application (App Router)
- Main interface (/app/(main))
- Sharing functionality (/app/share)
- UI Components (components/)
- Sandpack Code Sandbox integration

b) Backend Layer:
- API Routes (/app/api)
- Code Generation endpoint (/api/generateCode)
- OG Image generation endpoint (/api/og)

c) External Services:
- Gemini API (Google AI)
- Database (Prisma with likely PostgreSQL)

**[Client Layer]**

**[Application Layer]**

**[External Services Layer]**

##### Component Relationships

a) Frontend Flow:
**Main Page → Code Generation Interface → Sandpack Viewer**
- ↓
**Sharing Interface**

b) Backend Integration:
**Frontend → API Routes → Gemini API**
- ↓
- Database

##### Key Technical Elements to Highlight

- Next.js App Router architecture
- API route handlers
- Prisma ORM integration
- Gemini API integration
- Sandpack code sandbox implementation

##### Specific Implementation Details

a) Core Application:
**Main Layout (/app/(main)/layout.tsx)**
- ↓
**Page Components**
- ↓
**Shared Components (Header, Footer, CodeViewer)**

b) API Layer:
**Generate Code Route**
- ↓
**OG Image Generation**

c) Database Schema:
**Prisma Schema → Database Tables**

##### Important Architectural Notes

- Separation between the frontend and API routes in Next.js
- How the Gemini API integration works with the code generation
- Database interactions through Prisma
- Demonstrate how the Sandpack integration fits into the frontend

Remember to include a section showing the static assets and utility functions, as they play a supporting role in the application's architecture. The shadcn UI components should be represented as a utility layer that feeds into the main component structure.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Client
        MainLayout["Main Layout"]
        MainInterface["Main Interface"]
        SharingInterface["Sharing Interface"]
        CodeViewer["Code Viewer"]
        Header["Header Component"]
        Footer["Footer Component"]
        GlobalStyles["Global Styles"]
        
        MainLayout --> MainInterface
        MainLayout --> SharingInterface
        MainInterface --> CodeViewer
        MainLayout --> Header
        MainLayout --> Footer
    end

    subgraph API
        CodeGenAPI["Code Generation API"]
        OGImageAPI["OG Image Generation"]
    end

    subgraph Database
        PrismaORM["Prisma ORM"]
        DBSchema["Database Schema"]
        DBMigrations["Database Migrations"]
        PostgreSQL[(PostgreSQL)]
    end

    subgraph External
        GeminiAPI["Google Gemini API"]
        SandpackAPI["Sandpack API"]
    end

    subgraph Utils
        DomainUtils["Domain Utilities"]
        CustomHooks["Custom Hooks"]
        ShadcnUI["Shadcn UI Components"]
    end

    MainInterface --> CodeGenAPI
    MainInterface --> SandpackAPI
    SharingInterface --> OGImageAPI
    CodeGenAPI --> GeminiAPI
    CodeGenAPI --> PrismaORM
    OGImageAPI --> PrismaORM
    PrismaORM --> DBSchema
    DBSchema --> PostgreSQL
    DBMigrations --> PostgreSQL

    %% Component Mappings
    click MainLayout "https://github.com/osanseviero/geminicoder/blob/main/app/(main)/layout.tsx"
    click MainInterface "https://github.com/osanseviero/geminicoder/blob/main/app/(main)/page.tsx"
    click SharingInterface "https://github.com/osanseviero/geminicoder/blob/main/app/share/[id]/page.tsx"
    click CodeGenAPI "https://github.com/osanseviero/geminicoder/blob/main/app/api/generateCode/route.ts"
    click OGImageAPI "https://github.com/osanseviero/geminicoder/blob/main/app/api/og/route.tsx"
    click PrismaORM "https://github.com/osanseviero/geminicoder/blob/main/lib/prisma.ts"
    click DBSchema "https://github.com/osanseviero/geminicoder/blob/main/prisma/schema.prisma"
    click Header "https://github.com/osanseviero/geminicoder/blob/main/components/Header.tsx"
    click Footer "https://github.com/osanseviero/geminicoder/blob/main/components/Footer.tsx"
    click CodeViewer "https://github.com/osanseviero/geminicoder/blob/main/components/code-viewer.tsx"
    click ShadcnUI "https://github.com/osanseviero/geminicoder/tree/main/utils/shadcn-docs"
    click GlobalStyles "https://github.com/osanseviero/geminicoder/blob/main/app/globals.css"
    click DomainUtils "https://github.com/osanseviero/geminicoder/blob/main/utils/domain.ts"
    click CustomHooks "https://github.com/osanseviero/geminicoder/blob/main/hooks/use-scroll-to.ts"
    click DBMigrations "https://github.com/osanseviero/geminicoder/blob/main/prisma/migrations/20240808195804_first/migration.sql"

    classDef default fill:#f9f9f9,stroke:#333,stroke-width:2px
    classDef client fill:#e1f5fe,stroke:#0288d1
    classDef api fill:#e8f5e9,stroke:#388e3c
    classDef database fill:#fff3e0,stroke:#f57c00
    classDef external fill:#f3e5f5,stroke:#7b1fa2
    classDef utils fill:#fce4ec,stroke:#c2185b

    class MainLayout,MainInterface,SharingInterface,CodeViewer,Header,Footer,GlobalStyles client
    class CodeGenAPI,OGImageAPI api
    class PrismaORM,DBSchema,DBMigrations,PostgreSQL database
    class GeminiAPI,SandpackAPI external
    class DomainUtils,CustomHooks,ShadcnUI utils
```
