# itays/bindecy-interview architecture

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

- Interactive diagram: https://gitdiagram.com/itays/bindecy-interview
- Repository: https://github.com/itays/bindecy-interview

## Overview

This is a client-side React file explorer designed for 10k–100k nodes. Users browse a virtualized, paginated folder tree, filter by name/size/category, preview selected files, and create or delete nodes. The README documents the loader/store/API flow and the major capabilities; several state and tree implementations are not excerpted, so their relationships below rely on that documentation rather than claims of source inspection.

Main entry points: [`app/features/file-explorer/ui/file-explorer.tsx`](https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/file-explorer.tsx) (Explorer screen), [`app/features/file-explorer/ui/preview/file-preview.tsx`](https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/preview/file-preview.tsx) (Preview panel), [`app/features/file-explorer/state/loader.ts`](https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/state/loader.ts) (Listing loader), [`app/features/file-explorer/state/explorer-store.ts`](https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/state/explorer-store.ts) (Explorer store)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browse["Browse and filter"]
  node_explorer["Explorer screen<br/>[file-explorer.tsx]"]
  node_filter["Filter toolbar<br/>[filter-toolbar.tsx]"]
  node_treepanel["Tree panel<br/>[tree-panel.tsx]"]
  node_virtualtree["Virtual tree<br/>[virtual-tree.tsx]"]
  node_treerow["Tree rows<br/>[tree-row.tsx]"]
  node_keyboard["Tree keyboard<br/>[tree-keyboard.ts]"]
end

subgraph group_preview["File preview"]
  node_preview["Preview panel<br/>[file-preview.tsx]"]
  node_detail["Node detail hook<br/>[use-node-detail.ts]"]
  node_media["Media renderers<br/>[preview-media.tsx]"]
  node_fallback["Preview fallback"]
  node_url["Preview URL check<br/>[preview-url.ts]"]
end

subgraph group_changes["Node changes"]
  node_actions["Tree actions<br/>[tree-actions.tsx]"]
  node_create["Create dialog"]
  node_delete["Delete dialog"]
end

subgraph group_runtime["Explorer runtime"]
  node_visible["Visible rows<br/>[visible-rows.ts]"]
  node_domain["Filter and sort rules<br/>[filters.ts]"]
  node_store[("Explorer store<br/>[explorer-store.ts]")]
  node_loader["Listing loader<br/>[loader.ts]"]
  node_api["Mock explorer API"]
  node_mutations["Mutation handlers<br/>[mutations.ts]"]
  node_provider["Explorer provider"]
end

node_user(("User"))

node_user -->|"opens"| node_explorer
node_explorer -->|"renders"| node_filter
node_explorer -->|"renders"| node_treepanel
node_explorer -->|"renders"| node_preview
node_filter -->|"applies filters"| node_loader
node_filter -->|"reads counts"| node_store
node_treepanel -->|"renders"| node_virtualtree
node_virtualtree -->|"renders"| node_treerow
node_virtualtree -->|"delegates keys"| node_keyboard
node_virtualtree -->|"displays rows"| node_visible
node_treerow -->|"requests pages"| node_loader
node_treerow -->|"reads node state"| node_store
node_loader -->|"lists children"| node_api
node_api -->|"returns pages"| node_loader
node_loader -->|"writes results"| node_store
node_store -->|"uses filter rules"| node_domain
node_preview -->|"loads selection"| node_detail
node_detail -->|"fetches node"| node_api
node_preview -->|"renders media"| node_media
node_preview -->|"shows fallback"| node_fallback
node_preview -->|"validates URL"| node_url
node_actions -->|"opens dialog"| node_create
node_actions -->|"opens dialog"| node_delete
node_create -->|"creates node"| node_mutations
node_delete -->|"deletes node"| node_mutations
node_mutations -->|"sends changes"| node_api
node_mutations -->|"patches listings"| node_store
node_explorer -.->|"uses context"| node_provider

click node_explorer "https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/file-explorer.tsx"
click node_filter "https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/filter-toolbar/filter-toolbar.tsx"
click node_treepanel "https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/tree/tree-panel.tsx"
click node_virtualtree "https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/tree/virtual-tree.tsx"
click node_treerow "https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/tree/tree-row.tsx"
click node_keyboard "https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/tree/tree-keyboard.ts"
click node_visible "https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/state/visible-rows.ts"
click node_domain "https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/domain/filters.ts"
click node_store "https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/state/explorer-store.ts"
click node_loader "https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/state/loader.ts"
click node_api "https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/api/file-explorer-api.ts"
click node_preview "https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/preview/file-preview.tsx"
click node_detail "https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/preview/use-node-detail.ts"
click node_media "https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/preview/preview-media.tsx"
click node_fallback "https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/preview/preview-fallback.tsx"
click node_url "https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/preview/preview-url.ts"
click node_actions "https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/tree/tree-actions.tsx"
click node_create "https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/crud/create-node-dialog.tsx"
click node_delete "https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/crud/delete-node-dialog.tsx"
click node_mutations "https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/state/mutations.ts"
click node_provider "https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/state/explorer-provider.tsx"

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_explorer,node_filter,node_treepanel,node_virtualtree,node_treerow,node_keyboard,node_user toneBlue
class node_preview,node_detail,node_media,node_fallback,node_url toneAmber
class node_actions,node_create,node_delete toneMint
class node_visible,node_domain,node_store,node_loader,node_api,node_mutations,node_provider toneRose
```

## Components

### Browse and filter

- [Explorer screen](https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/file-explorer.tsx): `app/features/file-explorer/ui/file-explorer.tsx`
- [Filter toolbar](https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/filter-toolbar/filter-toolbar.tsx): `app/features/file-explorer/ui/filter-toolbar/filter-toolbar.tsx`
- [Tree panel](https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/tree/tree-panel.tsx): `app/features/file-explorer/ui/tree/tree-panel.tsx`
- [Virtual tree](https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/tree/virtual-tree.tsx): `app/features/file-explorer/ui/tree/virtual-tree.tsx`
- [Tree rows](https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/tree/tree-row.tsx): `app/features/file-explorer/ui/tree/tree-row.tsx`
- [Tree keyboard](https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/tree/tree-keyboard.ts): `app/features/file-explorer/ui/tree/tree-keyboard.ts`

### File preview

- [Preview panel](https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/preview/file-preview.tsx): `app/features/file-explorer/ui/preview/file-preview.tsx`
- [Node detail hook](https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/preview/use-node-detail.ts): `app/features/file-explorer/ui/preview/use-node-detail.ts`
- [Media renderers](https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/preview/preview-media.tsx): `app/features/file-explorer/ui/preview/preview-media.tsx`
- [Preview fallback](https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/preview/preview-fallback.tsx): `app/features/file-explorer/ui/preview/preview-fallback.tsx`
- [Preview URL check](https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/preview/preview-url.ts): `app/features/file-explorer/ui/preview/preview-url.ts`

### Node changes

- [Tree actions](https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/tree/tree-actions.tsx): `app/features/file-explorer/ui/tree/tree-actions.tsx`
- [Create dialog](https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/crud/create-node-dialog.tsx): `app/features/file-explorer/ui/crud/create-node-dialog.tsx`
- [Delete dialog](https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/ui/crud/delete-node-dialog.tsx): `app/features/file-explorer/ui/crud/delete-node-dialog.tsx`

### Explorer runtime

- [Visible rows](https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/state/visible-rows.ts): `app/features/file-explorer/state/visible-rows.ts`
- [Filter and sort rules](https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/domain/filters.ts): `app/features/file-explorer/domain/filters.ts`
- [Explorer store](https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/state/explorer-store.ts): `app/features/file-explorer/state/explorer-store.ts`
- [Listing loader](https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/state/loader.ts): `app/features/file-explorer/state/loader.ts`
- [Mock explorer API](https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/api/file-explorer-api.ts): `app/features/file-explorer/api/file-explorer-api.ts`
- [Mutation handlers](https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/state/mutations.ts): `app/features/file-explorer/state/mutations.ts`
- [Explorer provider](https://github.com/itays/bindecy-interview/blob/main/app/features/file-explorer/state/explorer-provider.tsx): `app/features/file-explorer/state/explorer-provider.tsx`

### Other components

- **User**

## Connections

- User → Explorer screen: opens
- Explorer screen → Filter toolbar: renders (evidence: `app/features/file-explorer/ui/file-explorer.tsx`)
- Explorer screen → Tree panel: renders (evidence: `app/features/file-explorer/ui/file-explorer.tsx`)
- Explorer screen → Preview panel: renders (evidence: `app/features/file-explorer/ui/file-explorer.tsx`)
- Filter toolbar → Listing loader: applies filters
- Filter toolbar → Explorer store: reads counts (evidence: `app/features/file-explorer/ui/filter-toolbar/filter-toolbar.tsx`)
- Tree panel → Virtual tree: renders (evidence: `app/features/file-explorer/ui/tree/tree-panel.tsx`)
- Virtual tree → Tree rows: renders (evidence: `app/features/file-explorer/ui/tree/virtual-tree.tsx`)
- Virtual tree → Tree keyboard: delegates keys (evidence: `app/features/file-explorer/ui/tree/virtual-tree.tsx`)
- Virtual tree → Visible rows: displays rows
- Tree rows → Listing loader: requests pages (evidence: `app/features/file-explorer/ui/tree/tree-row.tsx`)
- Tree rows → Explorer store: reads node state (evidence: `app/features/file-explorer/ui/tree/tree-row.tsx`)
- Listing loader → Mock explorer API: lists children
- Mock explorer API → Listing loader: returns pages
- Listing loader → Explorer store: writes results (evidence: `app/features/file-explorer/state/loader.ts`)
- Explorer store → Filter and sort rules: uses filter rules (evidence: `app/features/file-explorer/state/explorer-store.ts`)
- Preview panel → Node detail hook: loads selection (evidence: `app/features/file-explorer/ui/preview/file-preview.tsx`)
- Node detail hook → Mock explorer API: fetches node
- Preview panel → Media renderers: renders media (evidence: `app/features/file-explorer/ui/preview/file-preview.tsx`)
- Preview panel → Preview fallback: shows fallback (evidence: `app/features/file-explorer/ui/preview/file-preview.tsx`)
- Preview panel → Preview URL check: validates URL (evidence: `app/features/file-explorer/ui/preview/file-preview.tsx`)
- Tree actions → Create dialog: opens dialog (evidence: `app/features/file-explorer/ui/tree/tree-actions.tsx`)
- Tree actions → Delete dialog: opens dialog (evidence: `app/features/file-explorer/ui/tree/tree-actions.tsx`)
- Create dialog → Mutation handlers: creates node
- Delete dialog → Mutation handlers: deletes node
- Mutation handlers → Mock explorer API: sends changes
- Mutation handlers → Explorer store: patches listings (evidence: `app/features/file-explorer/state/mutations.ts`)
- Explorer screen → Explorer provider: uses context
