# thekovie/palatepicks architecture

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

- Interactive diagram: https://gitdiagram.com/thekovie/palatepicks
- Repository: https://github.com/thekovie/palatepicks

## Overview

##### Project type and purpose
- PalatePicks is a full-stack, server-side-rendered (SSR) web application built on Nuxt.js.
- It targets students who want to discover and review budget-friendly restaurants.
- It leverages Supabase for authentication, database (PostgreSQL), and file storage.

##### File structure
Top level
- nuxt.config.ts, package.json, pnpm-lock.yaml – Nuxt configuration and dependencies
- tsconfig.json, server/tsconfig.json – TypeScript settings for client and any server folders
- tailwind.config.js, assets/css/main.css – UI styling setup
- public/ – static, public-facing files (favicon, robots.txt, etc.)
- .github/, .gitignore, .npmrc, .editorconfig, .vscode/ – repo tooling & CI/CD configs

Nuxt folders
- pages/ – route definitions (Login.vue, Register.vue, profile/[id].vue, restaurant/[id].vue, etc.)
- layouts/ – layout templates (default.vue)
- components/ – reusable UI components (NavUser.vue, ReviewBox.vue, UploadPicture.vue, etc.)
- server/ – (empty except tsconfig) placeholder for server middleware or API routes if needed

##### README for additional insights
- Confirms tech stack: NuxtJS + Supabase
- Highlights use of Supabase for both database & authentication
- Notes deployment via Vercel (live site redirect on “forgot password”)
- Mentions environment variables stored in .env for local dev

##### Detail and component separation
- Break the front end into “Routing (pages/)”, “UI Components (components/)”, “Layouts (layouts/)”, and “Assets (public/ & assets/)”
- Server or API folder as a distinct microservice or function group (even if empty today)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Front-end Layer
    subgraph "Front-end Layer"
        Browser["Client / Browser"]:::frontend
        subgraph "Static Assets"
            Assets["assets/"]:::frontend
            Public["public/"]:::frontend
        end
        subgraph "Routing (pages/)"
            Pages["pages/"]:::frontend
        end
        subgraph "Layout Templates"
            Layouts["layouts/default.vue"]:::frontend
        end
        subgraph "UI Components"
            Components["components/"]:::frontend
        end
    end

    %% SSR Server
    SSR["Nuxt SSR Server (nuxt.config.ts)"]:::frontend

    %% CDN
    CDN["Static CDN"]:::cdn

    %% Backend BaaS Layer
    subgraph "Supabase Services"
        Auth["Supabase Auth"]:::auth
        DB["Supabase Database (PostgreSQL)"]:::db
        Storage["Supabase Storage"]:::db
    end

    %% Configuration & Build Tools
    subgraph "CI/CD & Build Tools"
        TSConfig["tsconfig.json"]:::grey
        NPMRC[".npmrc"]:::grey
        Lockfile["pnpm-lock.yaml"]:::grey
        Package["package.json"]:::grey
        Tailwind["tailwind.config.js"]:::grey
        Prettier["prettier.config.cjs"]:::grey
        EditorConfig[".editorconfig"]:::grey
        GitIgnore[".gitignore"]:::grey
        ServerDir["server/"]:::grey
    end

    %% Connections
    Browser -->|"HTTPS (load SSR HTML)"| SSR
    SSR -->|"SSR + Hydration"| Browser
    Browser -->|"GET CSS/JS/assets"| Assets
    Browser -->|"GET static files"| Public
    Browser -->|"navigate routes"| Pages
    Pages --> Components
    Pages --> Layouts

    Browser -->|"CDN fetch"| CDN
    SSR --> CDN
    Assets --> CDN
    Public --> CDN

    Browser -->|"JS SDK: POST /auth"| Auth
    Browser -->|"JS SDK: DB CRUD"| DB
    Browser -->|"JS SDK: Storage ops"| Storage

    SSR --> Auth
    SSR --> DB
    SSR --> Storage

    SSR --> ToolsConfig["Environment vars (.env)"]:::grey

    TSConfig --> SSR
    NPMRC --> SSR
    Lockfile --> SSR
    Package --> SSR
    Tailwind --> SSR
    Prettier --> SSR
    EditorConfig --> SSR
    GitIgnore --> SSR
    ServerDir --> SSR

    %% Click Events
    click Assets "https://github.com/thekovie/palatepicks/tree/main/assets/"
    click Public "https://github.com/thekovie/palatepicks/tree/main/public/"
    click Pages "https://github.com/thekovie/palatepicks/tree/main/pages/"
    click Layouts "https://github.com/thekovie/palatepicks/blob/main/layouts/default.vue"
    click Components "https://github.com/thekovie/palatepicks/tree/main/components/"
    click SSR "https://github.com/thekovie/palatepicks/blob/main/nuxt.config.ts"
    click ServerDir "https://github.com/thekovie/palatepicks/tree/main/server/"
    click TSConfig "https://github.com/thekovie/palatepicks/blob/main/tsconfig.json"
    click NPMRC "https://github.com/thekovie/palatepicks/blob/main/.npmrc"
    click Lockfile "https://github.com/thekovie/palatepicks/blob/main/pnpm-lock.yaml"
    click Package "https://github.com/thekovie/palatepicks/blob/main/package.json"
    click Tailwind "https://github.com/thekovie/palatepicks/blob/main/tailwind.config.js"
    click Prettier "https://github.com/thekovie/palatepicks/blob/main/prettier.config.cjs"
    click EditorConfig "https://github.com/thekovie/palatepicks/blob/main/.editorconfig"
    click GitIgnore "https://github.com/thekovie/palatepicks/blob/main/.gitignore"

    %% Styles
    classDef frontend fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef auth fill:#FFA500,stroke:#333,stroke-width:1px
    classDef db fill:#90EE90,stroke:#333,stroke-width:1px
    classDef cdn fill:#D3D3D3,stroke:#333,stroke-width:1px
    classDef grey fill:#F0F0F0,stroke:#333,stroke-width:1px
```
