# griff1n-afk/kainprends architecture

> Architecture diagram of the GitHub repository griff1n-afk/kainprends, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/griff1n-afk/kainprends
- Repository: https://github.com/griff1n-afk/kainprends

## Overview

KainPrends is a React recipe-discovery and sharing application. Visitors browse and filter recipes, open recipe details, and can sign in to save favorites or manage a profile and recipes. App.tsx routes the principal pages and provides shared authentication and modal contexts. Supabase supplies authentication, PostgreSQL-backed recipe/profile/favorite data, and notification updates. The README documents search, category filtering, sorting, password recovery, responsive layouts, and Row Level Security; unsampled page implementations are represented by their exact tree paths, with only documented or indexed relationships shown.

Main entry points: [`src/App.tsx`](https://github.com/griff1n-afk/kainprends/blob/main/src/App.tsx) (App routes), [`src/supabaseClient.ts`](https://github.com/griff1n-afk/kainprends/blob/main/src/supabaseClient.ts) (Supabase client), [`src/ProfilePage.tsx`](https://github.com/griff1n-afk/kainprends/blob/main/src/ProfilePage.tsx) (User profile), [`src/hooks/useFavorites.ts`](https://github.com/griff1n-afk/kainprends/blob/main/src/hooks/useFavorites.ts) (Favorites state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["App and navigation"]
  node_app["App routes<br/>[App.tsx]"]
  node_navbar["Navigation bar<br/>[NavBar.tsx]"]
end

subgraph group_discovery["Recipe discovery"]
  node_home["Home feed<br/>[HomePage.tsx]"]
  node_browse["Recipe search<br/>[RecipesPage.tsx]"]
  node_recipe["Recipe details<br/>[RecipeDetails.tsx]"]
  node_recipe_card["Recipe card"]
  node_favorite_button["Favorite control<br/>[FavoriteButton.tsx]"]
  node_form["Recipe editor"]
  node_form_sections["Recipe form sections"]
end

subgraph group_identity["Identity and profiles"]
  node_auth_page["Sign-in page<br/>[Auth.tsx]"]
  node_auth_card["Sign-in and signup<br/>[AuthCard.tsx]"]
  node_auth_modal["Auth modal<br/>[AuthModal.tsx]"]
  node_auth_context["Auth state<br/>[AuthContext.tsx]"]
  node_auth_modal_context["Auth modal state"]
  node_protected["Recovery guard<br/>[ProtectedRoute.tsx]"]
  node_reset["Password recovery"]
  node_profile["User profile<br/>[ProfilePage.tsx]"]
  node_profile_edit["Profile editor"]
end

subgraph group_data["Data and shared services"]
  node_favorites_hook["Favorites state<br/>[useFavorites.ts]"]
  node_notifications["Notification state"]
  node_supabase_client["Supabase client<br/>[supabaseClient.ts]"]
end

node_visitor(("Visitor"))
node_supabase[("Supabase backend")]

node_visitor -->|"opens app"| node_app
node_app -->|"renders"| node_navbar
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_browse
node_app -->|"routes to"| node_recipe
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_auth_page
node_app -->|"routes to"| node_reset
node_app -->|"guards recovery"| node_protected
node_app -->|"provides auth"| node_auth_context
node_app -->|"provides modal state"| node_auth_modal_context
node_app -->|"renders"| node_auth_modal
node_auth_page -->|"renders"| node_auth_card
node_auth_modal -->|"renders"| node_auth_card
node_auth_modal -->|"reads state"| node_auth_modal_context
node_auth_card -->|"authenticates with"| node_supabase_client
node_auth_context -->|"reads session"| node_supabase_client
node_protected -->|"checks state"| node_auth_context
node_home -->|"loads recipes"| node_supabase_client
node_browse -->|"queries recipes"| node_supabase_client
node_recipe -->|"loads recipe"| node_supabase_client
node_profile -->|"loads profile data"| node_supabase_client
node_profile -->|"opens editor"| node_profile_edit
node_profile -->|"opens recipe editor"| node_form
node_form -->|"renders sections"| node_form_sections
node_form -->|"saves recipes"| node_supabase_client
node_home -->|"uses favorites"| node_favorites_hook
node_browse -->|"uses favorites"| node_favorites_hook
node_recipe -->|"uses favorites"| node_favorites_hook
node_profile -->|"uses favorites"| node_favorites_hook
node_favorites_hook -->|"reads and writes"| node_supabase_client
node_notifications -->|"syncs notifications"| node_supabase_client
node_navbar -->|"uses notifications"| node_notifications
node_favorite_button -->|"requests login"| node_auth_modal_context
node_home -->|"displays recipes"| node_recipe_card
node_recipe_card -->|"renders control"| node_favorite_button
node_supabase_client -->|"connects"| node_supabase

click node_app "https://github.com/griff1n-afk/kainprends/blob/main/src/App.tsx"
click node_navbar "https://github.com/griff1n-afk/kainprends/blob/main/src/NavBar.tsx"
click node_home "https://github.com/griff1n-afk/kainprends/blob/main/src/HomePage.tsx"
click node_browse "https://github.com/griff1n-afk/kainprends/blob/main/src/RecipesPage.tsx"
click node_recipe "https://github.com/griff1n-afk/kainprends/blob/main/src/RecipeDetails.tsx"
click node_recipe_card "https://github.com/griff1n-afk/kainprends/blob/main/src/components/ExploreRecipeCard.tsx"
click node_favorite_button "https://github.com/griff1n-afk/kainprends/blob/main/src/components/FavoriteButton.tsx"
click node_form "https://github.com/griff1n-afk/kainprends/blob/main/src/components/RecipeFormModal/RecipeFormModal.tsx"
click node_form_sections "https://github.com/griff1n-afk/kainprends/tree/main/src/components/RecipeFormModal/sections"
click node_auth_page "https://github.com/griff1n-afk/kainprends/blob/main/src/Auth.tsx"
click node_auth_card "https://github.com/griff1n-afk/kainprends/blob/main/src/components/Auth/AuthCard.tsx"
click node_auth_modal "https://github.com/griff1n-afk/kainprends/blob/main/src/components/Auth/AuthModal.tsx"
click node_auth_context "https://github.com/griff1n-afk/kainprends/blob/main/src/context/AuthContext.tsx"
click node_auth_modal_context "https://github.com/griff1n-afk/kainprends/blob/main/src/context/AuthModalContext.tsx"
click node_protected "https://github.com/griff1n-afk/kainprends/blob/main/src/components/ProtectedRoute.tsx"
click node_reset "https://github.com/griff1n-afk/kainprends/blob/main/src/ResetPasswordPage.tsx"
click node_profile "https://github.com/griff1n-afk/kainprends/blob/main/src/ProfilePage.tsx"
click node_profile_edit "https://github.com/griff1n-afk/kainprends/blob/main/src/EditProfileModal.tsx"
click node_favorites_hook "https://github.com/griff1n-afk/kainprends/blob/main/src/hooks/useFavorites.ts"
click node_notifications "https://github.com/griff1n-afk/kainprends/blob/main/src/hooks/useNotifications.ts"
click node_supabase_client "https://github.com/griff1n-afk/kainprends/blob/main/src/supabaseClient.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_navbar toneBlue
class node_home,node_browse,node_recipe,node_recipe_card,node_favorite_button,node_form,node_form_sections,node_supabase toneAmber
class node_auth_page,node_auth_card,node_auth_modal,node_auth_context,node_auth_modal_context,node_protected,node_reset,node_profile,node_profile_edit toneMint
class node_favorites_hook,node_notifications,node_supabase_client toneRose
class node_visitor toneIndigo
```

## Components

### App and navigation

- [App routes](https://github.com/griff1n-afk/kainprends/blob/main/src/App.tsx): `src/App.tsx`
- [Navigation bar](https://github.com/griff1n-afk/kainprends/blob/main/src/NavBar.tsx): `src/NavBar.tsx`

### Recipe discovery

- [Home feed](https://github.com/griff1n-afk/kainprends/blob/main/src/HomePage.tsx): `src/HomePage.tsx`
- [Recipe search](https://github.com/griff1n-afk/kainprends/blob/main/src/RecipesPage.tsx): `src/RecipesPage.tsx`
- [Recipe details](https://github.com/griff1n-afk/kainprends/blob/main/src/RecipeDetails.tsx): `src/RecipeDetails.tsx`
- [Recipe card](https://github.com/griff1n-afk/kainprends/blob/main/src/components/ExploreRecipeCard.tsx): `src/components/ExploreRecipeCard.tsx`
- [Favorite control](https://github.com/griff1n-afk/kainprends/blob/main/src/components/FavoriteButton.tsx): `src/components/FavoriteButton.tsx`
- [Recipe editor](https://github.com/griff1n-afk/kainprends/blob/main/src/components/RecipeFormModal/RecipeFormModal.tsx): `src/components/RecipeFormModal/RecipeFormModal.tsx`
- [Recipe form sections](https://github.com/griff1n-afk/kainprends/tree/main/src/components/RecipeFormModal/sections): `src/components/RecipeFormModal/sections`

### Identity and profiles

- [Sign-in page](https://github.com/griff1n-afk/kainprends/blob/main/src/Auth.tsx): `src/Auth.tsx`
- [Sign-in and signup](https://github.com/griff1n-afk/kainprends/blob/main/src/components/Auth/AuthCard.tsx): `src/components/Auth/AuthCard.tsx`
- [Auth modal](https://github.com/griff1n-afk/kainprends/blob/main/src/components/Auth/AuthModal.tsx): `src/components/Auth/AuthModal.tsx`
- [Auth state](https://github.com/griff1n-afk/kainprends/blob/main/src/context/AuthContext.tsx): `src/context/AuthContext.tsx`
- [Auth modal state](https://github.com/griff1n-afk/kainprends/blob/main/src/context/AuthModalContext.tsx): `src/context/AuthModalContext.tsx`
- [Recovery guard](https://github.com/griff1n-afk/kainprends/blob/main/src/components/ProtectedRoute.tsx): `src/components/ProtectedRoute.tsx`
- [Password recovery](https://github.com/griff1n-afk/kainprends/blob/main/src/ResetPasswordPage.tsx): `src/ResetPasswordPage.tsx`
- [User profile](https://github.com/griff1n-afk/kainprends/blob/main/src/ProfilePage.tsx): `src/ProfilePage.tsx`
- [Profile editor](https://github.com/griff1n-afk/kainprends/blob/main/src/EditProfileModal.tsx): `src/EditProfileModal.tsx`

### Data and shared services

- [Favorites state](https://github.com/griff1n-afk/kainprends/blob/main/src/hooks/useFavorites.ts): `src/hooks/useFavorites.ts`
- [Notification state](https://github.com/griff1n-afk/kainprends/blob/main/src/hooks/useNotifications.ts): `src/hooks/useNotifications.ts`
- [Supabase client](https://github.com/griff1n-afk/kainprends/blob/main/src/supabaseClient.ts): `src/supabaseClient.ts`

### Other components

- **Visitor**
- **Supabase backend**

## Connections

- Visitor → App routes: opens app (evidence: `README.md`)
- App routes → Navigation bar: renders (evidence: `src/App.tsx`)
- App routes → Home feed: routes to (evidence: `src/App.tsx`)
- App routes → Recipe search: routes to (evidence: `src/App.tsx`)
- App routes → Recipe details: routes to (evidence: `src/App.tsx`)
- App routes → User profile: routes to (evidence: `src/App.tsx`)
- App routes → Sign-in page: routes to (evidence: `src/App.tsx`)
- App routes → Password recovery: routes to (evidence: `src/App.tsx`)
- App routes → Recovery guard: guards recovery (evidence: `src/App.tsx`)
- App routes → Auth state: provides auth (evidence: `src/App.tsx`)
- App routes → Auth modal state: provides modal state (evidence: `src/App.tsx`)
- App routes → Auth modal: renders (evidence: `src/App.tsx`)
- Sign-in page → Sign-in and signup: renders (evidence: `src/Auth.tsx`)
- Auth modal → Sign-in and signup: renders (evidence: `src/components/Auth/AuthModal.tsx`)
- Auth modal → Auth modal state: reads state (evidence: `src/components/Auth/AuthModal.tsx`)
- Sign-in and signup → Supabase client: authenticates with (evidence: `src/components/Auth/AuthCard.tsx`)
- Auth state → Supabase client: reads session (evidence: `src/context/AuthContext.tsx`)
- Recovery guard → Auth state: checks state (evidence: `src/components/ProtectedRoute.tsx`)
- Home feed → Supabase client: loads recipes (evidence: `src/HomePage.tsx`)
- Recipe search → Supabase client: queries recipes (evidence: `src/RecipesPage.tsx`)
- Recipe details → Supabase client: loads recipe (evidence: `src/RecipeDetails.tsx`)
- User profile → Supabase client: loads profile data (evidence: `src/ProfilePage.tsx`)
- User profile → Profile editor: opens editor (evidence: `src/ProfilePage.tsx`)
- User profile → Recipe editor: opens recipe editor (evidence: `src/ProfilePage.tsx`)
- Recipe editor → Recipe form sections: renders sections (evidence: `src/components/RecipeFormModal/RecipeFormModal.tsx`)
- Recipe editor → Supabase client: saves recipes (evidence: `src/components/RecipeFormModal/RecipeFormModal.tsx`)
- Home feed → Favorites state: uses favorites (evidence: `src/HomePage.tsx`)
- Recipe search → Favorites state: uses favorites (evidence: `src/RecipesPage.tsx`)
- Recipe details → Favorites state: uses favorites (evidence: `src/RecipeDetails.tsx`)
- User profile → Favorites state: uses favorites (evidence: `src/ProfilePage.tsx`)
- Favorites state → Supabase client: reads and writes (evidence: `src/hooks/useFavorites.ts`)
- Notification state → Supabase client: syncs notifications (evidence: `src/hooks/useNotifications.ts`)
- Navigation bar → Notification state: uses notifications (evidence: `src/NavBar.tsx`)
- Favorite control → Auth modal state: requests login (evidence: `src/components/FavoriteButton.tsx`)
- Home feed → Recipe card: displays recipes (evidence: `src/HomePage.tsx`)
- Recipe card → Favorite control: renders control (evidence: `src/components/ExploreRecipeCard.tsx`)
- Supabase client → Supabase backend: connects (evidence: `src/supabaseClient.ts`)
