# auroravane/rbdsm-project architecture

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

- Interactive diagram: https://gitdiagram.com/auroravane/rbdsm-project
- Repository: https://github.com/auroravane/rbdsm-project

## Overview

BoardNight is a board-game collection and game-night planning application, with account management and borrowed-game views. Users enter through the React app and navigate to collection, planner, profile, and other page workflows. The planner’s shown requests create games and manage game-night events through the Express API; the API’s shown handlers persist data through PostgreSQL. The README provides no capability description, and several page implementations or backend integrations were not shown, so those components are included without speculative connections.

Main entry points: [`frontend/src/App.jsx`](https://github.com/auroravane/rbdsm-project/blob/main/frontend/src/App.jsx) (React app and routes), [`src/db.js`](https://github.com/auroravane/rbdsm-project/blob/main/src/db.js) (PostgreSQL pool), [`src/app.js`](https://github.com/auroravane/rbdsm-project/blob/main/src/app.js) (Express API), [`frontend/src/pages/GamePlanner.jsx`](https://github.com/auroravane/rbdsm-project/blob/main/frontend/src/pages/GamePlanner.jsx) (Game planner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["React app and routes<br/>[App.jsx]"]
  node_starfield["Ambient starfield"]
  node_home["Home<br/>[Home.jsx]"]
  node_login["Login<br/>[Login.jsx]"]
  node_signup["Signup<br/>[Signup.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_mygames["My games<br/>[MyGames.jsx]"]
  node_gameboard["Game board<br/>[GameBoard.jsx]"]
  node_borrowed["Borrowed games<br/>[Borrowed.jsx]"]
end

subgraph group_api["API and account"]
  node_profile["Profile and security<br/>[Profile.jsx]"]
  node_apiapp["Express API<br/>[app.js]"]
  node_auth["Authentication routes<br/>[auth.routes.js]"]
  node_chat["Chat route<br/>[chat.routes.js]"]
  node_errors["Error handler<br/>[errorHandler.js]"]
end

subgraph group_planning["Game planning"]
  node_planner["Game planner<br/>[GamePlanner.jsx]"]
  node_games["Game routes<br/>[games.route.js]"]
  node_nights["Game-night routes"]
end

subgraph group_persistence["Persistence"]
  node_dbpool["PostgreSQL pool<br/>[db.js]"]
  node_database[("PostgreSQL database")]
end

node_user(("BoardNight user"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_signup
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_mygames
node_app -->|"routes to"| node_gameboard
node_app -->|"routes to"| node_planner
node_app -->|"routes to"| node_borrowed
node_app -->|"routes to"| node_profile
node_app -->|"renders"| node_starfield
node_profile -->|"requests password change"| node_auth
node_apiapp -->|"mounts"| node_auth
node_apiapp -->|"mounts"| node_nights
node_apiapp -->|"uses"| node_errors
node_planner -->|"posts games"| node_games
node_planner -->|"manages events"| node_nights
node_auth -->|"queries"| node_dbpool
node_nights -->|"queries"| node_dbpool
node_games -->|"queries"| node_dbpool
node_chat -->|"queries"| node_dbpool
node_dbpool -->|"connects to"| node_database

click node_app "https://github.com/auroravane/rbdsm-project/blob/main/frontend/src/App.jsx"
click node_starfield "https://github.com/auroravane/rbdsm-project/blob/main/frontend/src/components/AmbientStarfield.jsx"
click node_home "https://github.com/auroravane/rbdsm-project/blob/main/frontend/src/pages/Home.jsx"
click node_login "https://github.com/auroravane/rbdsm-project/blob/main/frontend/src/pages/Login.jsx"
click node_signup "https://github.com/auroravane/rbdsm-project/blob/main/frontend/src/pages/Signup.jsx"
click node_dashboard "https://github.com/auroravane/rbdsm-project/blob/main/frontend/src/pages/Dashboard.jsx"
click node_mygames "https://github.com/auroravane/rbdsm-project/blob/main/frontend/src/pages/MyGames.jsx"
click node_gameboard "https://github.com/auroravane/rbdsm-project/blob/main/frontend/src/pages/GameBoard.jsx"
click node_planner "https://github.com/auroravane/rbdsm-project/blob/main/frontend/src/pages/GamePlanner.jsx"
click node_borrowed "https://github.com/auroravane/rbdsm-project/blob/main/frontend/src/pages/Borrowed.jsx"
click node_profile "https://github.com/auroravane/rbdsm-project/blob/main/frontend/src/pages/Profile.jsx"
click node_apiapp "https://github.com/auroravane/rbdsm-project/blob/main/src/app.js"
click node_auth "https://github.com/auroravane/rbdsm-project/blob/main/src/routes/auth.routes.js"
click node_games "https://github.com/auroravane/rbdsm-project/blob/main/src/routes/games.route.js"
click node_nights "https://github.com/auroravane/rbdsm-project/blob/main/src/routes/gameNights.routes.js"
click node_chat "https://github.com/auroravane/rbdsm-project/blob/main/src/routes/chat.routes.js"
click node_errors "https://github.com/auroravane/rbdsm-project/blob/main/src/middleware/errorHandler.js"
click node_dbpool "https://github.com/auroravane/rbdsm-project/blob/main/src/db.js"

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_starfield,node_home,node_login,node_signup,node_dashboard,node_mygames,node_gameboard,node_borrowed,node_user toneBlue
class node_profile,node_apiapp,node_auth,node_chat,node_errors toneAmber
class node_planner,node_games,node_nights toneMint
class node_dbpool,node_database toneRose
```

## Components

### Web application

- [React app and routes](https://github.com/auroravane/rbdsm-project/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Ambient starfield](https://github.com/auroravane/rbdsm-project/blob/main/frontend/src/components/AmbientStarfield.jsx): `frontend/src/components/AmbientStarfield.jsx`
- [Home](https://github.com/auroravane/rbdsm-project/blob/main/frontend/src/pages/Home.jsx): `frontend/src/pages/Home.jsx`
- [Login](https://github.com/auroravane/rbdsm-project/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Signup](https://github.com/auroravane/rbdsm-project/blob/main/frontend/src/pages/Signup.jsx): `frontend/src/pages/Signup.jsx`
- [Dashboard](https://github.com/auroravane/rbdsm-project/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [My games](https://github.com/auroravane/rbdsm-project/blob/main/frontend/src/pages/MyGames.jsx): `frontend/src/pages/MyGames.jsx`
- [Game board](https://github.com/auroravane/rbdsm-project/blob/main/frontend/src/pages/GameBoard.jsx): `frontend/src/pages/GameBoard.jsx`
- [Borrowed games](https://github.com/auroravane/rbdsm-project/blob/main/frontend/src/pages/Borrowed.jsx): `frontend/src/pages/Borrowed.jsx`

### API and account

- [Profile and security](https://github.com/auroravane/rbdsm-project/blob/main/frontend/src/pages/Profile.jsx): `frontend/src/pages/Profile.jsx`
- [Express API](https://github.com/auroravane/rbdsm-project/blob/main/src/app.js): `src/app.js`
- [Authentication routes](https://github.com/auroravane/rbdsm-project/blob/main/src/routes/auth.routes.js): `src/routes/auth.routes.js`
- [Chat route](https://github.com/auroravane/rbdsm-project/blob/main/src/routes/chat.routes.js): `src/routes/chat.routes.js`
- [Error handler](https://github.com/auroravane/rbdsm-project/blob/main/src/middleware/errorHandler.js): `src/middleware/errorHandler.js`

### Game planning

- [Game planner](https://github.com/auroravane/rbdsm-project/blob/main/frontend/src/pages/GamePlanner.jsx): `frontend/src/pages/GamePlanner.jsx`
- [Game routes](https://github.com/auroravane/rbdsm-project/blob/main/src/routes/games.route.js): `src/routes/games.route.js`
- [Game-night routes](https://github.com/auroravane/rbdsm-project/blob/main/src/routes/gameNights.routes.js): `src/routes/gameNights.routes.js`

### Persistence

- [PostgreSQL pool](https://github.com/auroravane/rbdsm-project/blob/main/src/db.js): `src/db.js`
- **PostgreSQL database**

### Other components

- **BoardNight user**

## Connections

- BoardNight user → React app and routes: uses (evidence: `frontend/src/App.jsx`)
- React app and routes → Home: routes to (evidence: `frontend/src/App.jsx`)
- React app and routes → Login: routes to (evidence: `frontend/src/App.jsx`)
- React app and routes → Signup: routes to (evidence: `frontend/src/App.jsx`)
- React app and routes → Dashboard: routes to (evidence: `frontend/src/App.jsx`)
- React app and routes → My games: routes to (evidence: `frontend/src/App.jsx`)
- React app and routes → Game board: routes to (evidence: `frontend/src/App.jsx`)
- React app and routes → Game planner: routes to (evidence: `frontend/src/App.jsx`)
- React app and routes → Borrowed games: routes to (evidence: `frontend/src/App.jsx`)
- React app and routes → Profile and security: routes to (evidence: `frontend/src/App.jsx`)
- React app and routes → Ambient starfield: renders (evidence: `frontend/src/App.jsx`)
- Profile and security → Authentication routes: requests password change (evidence: `frontend/src/pages/Profile.jsx`)
- Express API → Authentication routes: mounts (evidence: `src/app.js`)
- Express API → Game-night routes: mounts (evidence: `src/app.js`)
- Express API → Error handler: uses (evidence: `src/app.js`)
- Game planner → Game routes: posts games (evidence: `frontend/src/pages/GamePlanner.jsx`)
- Game planner → Game-night routes: manages events (evidence: `frontend/src/pages/GamePlanner.jsx`)
- Authentication routes → PostgreSQL pool: queries (evidence: `src/routes/auth.routes.js`)
- Game-night routes → PostgreSQL pool: queries (evidence: `src/routes/gameNights.routes.js`)
- Game routes → PostgreSQL pool: queries (evidence: `src/routes/games.route.js`)
- Chat route → PostgreSQL pool: queries (evidence: `src/routes/chat.routes.js`)
- PostgreSQL pool → PostgreSQL database: connects to (evidence: `src/db.js`)
