# misamu12/pikacube architecture

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

- Interactive diagram: https://gitdiagram.com/misamu12/pikacube
- Repository: https://github.com/misamu12/pikacube

## Overview

PikaCube is a browser-based 3D Rubik’s Cube game. Players enter through the home page, choose a level, play and solve the cube, then see progress and scores reflected in the local leaderboard. The game page coordinates account/session handling, level progression, the cube engine, and game effects; browser storage is local to each device. The README also describes an administrator area. The graph uses README claims for capabilities whose implementation was not sampled; it does not imply shared or server-backed scores.

Main entry points: [`src/routes/index.tsx`](https://github.com/misamu12/pikacube/blob/main/src/routes/index.tsx) (Home page), [`src/routes/jeu.tsx`](https://github.com/misamu12/pikacube/blob/main/src/routes/jeu.tsx) (Game and levels), [`src/game/store.ts`](https://github.com/misamu12/pikacube/blob/main/src/game/store.ts) (Local game store), [`src/routes/__root.tsx`](https://github.com/misamu12/pikacube/blob/main/src/routes/__root.tsx) (App shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_router["Router setup<br/>[router.tsx]"]
  node_routes["Route registry<br/>[routeTree.gen.ts]"]
  node_root["App shell<br/>[__root.tsx]"]
  node_home["Home page<br/>[index.tsx]"]
  node_gamepage["Game and levels<br/>[jeu.tsx]"]
  node_leaderboard["Scores and admin<br/>[classement.tsx]"]
end

subgraph group_game["Game and progress"]
  node_engine["Cube engine<br/>[cube-engine.ts]"]
  node_storage[("Local game store<br/>[store.ts]")]
  node_storehook["Store subscription<br/>[useStore.ts]"]
  node_effects["Audio and effects<br/>[fx.ts]"]
end

subgraph group_presentation["Shared presentation"]
  node_csscube["Decorative cube<br/>[CssCube.tsx]"]
  node_header["Site header<br/>[SiteHeader.tsx]"]
  node_ui["UI primitives"]
  node_mobile["Mobile detection<br/>[use-mobile.tsx]"]
end

subgraph group_runtime["Server runtime"]
  node_server["Request handler<br/>[server.ts]"]
  node_errorcapture["Error capture<br/>[error-capture.ts]"]
  node_errorpage["Error page<br/>[error-page.ts]"]
  node_reporting["Error reporting"]
  node_start["Start configuration<br/>[start.ts]"]
end

node_player(("Player"))

node_player -->|"opens"| node_home
node_player -->|"plays"| node_gamepage
node_player -->|"views scores"| node_leaderboard
node_router -->|"uses routes"| node_routes
node_routes -->|"registers"| node_root
node_root -->|"renders"| node_header
node_root -->|"configures"| node_reporting
node_home -->|"renders"| node_csscube
node_home -->|"reads activity"| node_storehook
node_home -->|"reads scores"| node_storage
node_home -->|"triggers effects"| node_effects
node_gamepage -->|"creates engine"| node_engine
node_gamepage -->|"reads and saves"| node_storage
node_gamepage -->|"plays effects"| node_effects
node_leaderboard -->|"subscribes"| node_storehook
node_leaderboard -->|"reads scores"| node_storage
node_storehook -->|"subscribes to changes"| node_storage
node_header -->|"sets mute"| node_effects
node_server -->|"consumes captured error"| node_errorcapture
node_server -->|"renders on failure"| node_errorpage
node_mobile -->|"supports sidebar"| node_ui
node_start -.->|"uses error page"| node_errorpage

click node_router "https://github.com/misamu12/pikacube/blob/main/src/router.tsx"
click node_routes "https://github.com/misamu12/pikacube/blob/main/src/routeTree.gen.ts"
click node_root "https://github.com/misamu12/pikacube/blob/main/src/routes/__root.tsx"
click node_home "https://github.com/misamu12/pikacube/blob/main/src/routes/index.tsx"
click node_gamepage "https://github.com/misamu12/pikacube/blob/main/src/routes/jeu.tsx"
click node_leaderboard "https://github.com/misamu12/pikacube/blob/main/src/routes/classement.tsx"
click node_engine "https://github.com/misamu12/pikacube/blob/main/src/game/cube-engine.ts"
click node_storage "https://github.com/misamu12/pikacube/blob/main/src/game/store.ts"
click node_storehook "https://github.com/misamu12/pikacube/blob/main/src/game/useStore.ts"
click node_effects "https://github.com/misamu12/pikacube/blob/main/src/game/fx.ts"
click node_csscube "https://github.com/misamu12/pikacube/blob/main/src/components/CssCube.tsx"
click node_header "https://github.com/misamu12/pikacube/blob/main/src/components/SiteHeader.tsx"
click node_ui "https://github.com/misamu12/pikacube/tree/main/src/components/ui"
click node_mobile "https://github.com/misamu12/pikacube/blob/main/src/hooks/use-mobile.tsx"
click node_server "https://github.com/misamu12/pikacube/blob/main/src/server.ts"
click node_errorcapture "https://github.com/misamu12/pikacube/blob/main/src/lib/error-capture.ts"
click node_errorpage "https://github.com/misamu12/pikacube/blob/main/src/lib/error-page.ts"
click node_reporting "https://github.com/misamu12/pikacube/blob/main/src/lib/lovable-error-reporting.ts"
click node_start "https://github.com/misamu12/pikacube/blob/main/src/start.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_router,node_routes,node_root,node_home,node_gamepage,node_leaderboard toneBlue
class node_engine,node_storage,node_storehook,node_effects toneAmber
class node_csscube,node_header,node_ui,node_mobile toneMint
class node_server,node_errorcapture,node_errorpage,node_reporting,node_start toneRose
class node_player toneIndigo
```

## Components

### Web application

- [Router setup](https://github.com/misamu12/pikacube/blob/main/src/router.tsx): `src/router.tsx`
- [Route registry](https://github.com/misamu12/pikacube/blob/main/src/routeTree.gen.ts): `src/routeTree.gen.ts`
- [App shell](https://github.com/misamu12/pikacube/blob/main/src/routes/__root.tsx): `src/routes/__root.tsx`
- [Home page](https://github.com/misamu12/pikacube/blob/main/src/routes/index.tsx): `src/routes/index.tsx`
- [Game and levels](https://github.com/misamu12/pikacube/blob/main/src/routes/jeu.tsx): `src/routes/jeu.tsx`
- [Scores and admin](https://github.com/misamu12/pikacube/blob/main/src/routes/classement.tsx): `src/routes/classement.tsx`

### Game and progress

- [Cube engine](https://github.com/misamu12/pikacube/blob/main/src/game/cube-engine.ts): `src/game/cube-engine.ts`
- [Local game store](https://github.com/misamu12/pikacube/blob/main/src/game/store.ts): `src/game/store.ts`
- [Store subscription](https://github.com/misamu12/pikacube/blob/main/src/game/useStore.ts): `src/game/useStore.ts`
- [Audio and effects](https://github.com/misamu12/pikacube/blob/main/src/game/fx.ts): `src/game/fx.ts`

### Shared presentation

- [Decorative cube](https://github.com/misamu12/pikacube/blob/main/src/components/CssCube.tsx): `src/components/CssCube.tsx`
- [Site header](https://github.com/misamu12/pikacube/blob/main/src/components/SiteHeader.tsx): `src/components/SiteHeader.tsx`
- [UI primitives](https://github.com/misamu12/pikacube/tree/main/src/components/ui): `src/components/ui`
- [Mobile detection](https://github.com/misamu12/pikacube/blob/main/src/hooks/use-mobile.tsx): `src/hooks/use-mobile.tsx`

### Server runtime

- [Request handler](https://github.com/misamu12/pikacube/blob/main/src/server.ts): `src/server.ts`
- [Error capture](https://github.com/misamu12/pikacube/blob/main/src/lib/error-capture.ts): `src/lib/error-capture.ts`
- [Error page](https://github.com/misamu12/pikacube/blob/main/src/lib/error-page.ts): `src/lib/error-page.ts`
- [Error reporting](https://github.com/misamu12/pikacube/blob/main/src/lib/lovable-error-reporting.ts): `src/lib/lovable-error-reporting.ts`
- [Start configuration](https://github.com/misamu12/pikacube/blob/main/src/start.ts): `src/start.ts`

### Other components

- **Player**

## Connections

- Player → Home page: opens
- Player → Game and levels: plays
- Player → Scores and admin: views scores
- Router setup → Route registry: uses routes (evidence: `src/router.tsx`)
- Route registry → App shell: registers (evidence: `src/routeTree.gen.ts`)
- App shell → Site header: renders (evidence: `src/routes/__root.tsx`)
- App shell → Error reporting: configures (evidence: `src/routes/__root.tsx`)
- Home page → Decorative cube: renders (evidence: `src/routes/index.tsx`)
- Home page → Store subscription: reads activity (evidence: `src/routes/index.tsx`)
- Home page → Local game store: reads scores (evidence: `src/routes/index.tsx`)
- Home page → Audio and effects: triggers effects (evidence: `src/routes/index.tsx`)
- Game and levels → Cube engine: creates engine (evidence: `src/routes/jeu.tsx`)
- Game and levels → Local game store: reads and saves (evidence: `src/routes/jeu.tsx`)
- Game and levels → Audio and effects: plays effects (evidence: `src/routes/jeu.tsx`)
- Scores and admin → Store subscription: subscribes (evidence: `src/routes/classement.tsx`)
- Scores and admin → Local game store: reads scores (evidence: `src/routes/classement.tsx`)
- Store subscription → Local game store: subscribes to changes (evidence: `src/game/useStore.ts`)
- Site header → Audio and effects: sets mute (evidence: `src/components/SiteHeader.tsx`)
- Request handler → Error capture: consumes captured error (evidence: `src/server.ts`)
- Request handler → Error page: renders on failure (evidence: `src/server.ts`)
- Mobile detection → UI primitives: supports sidebar (evidence: `src/components/ui/sidebar.tsx`)
- Start configuration → Error page: uses error page (evidence: `src/start.ts`)
