# esx-framework/esx_core architecture

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

- Interactive diagram: https://gitdiagram.com/esx-framework/esx_core
- Repository: https://github.com/esx-framework/esx_core

## Overview

ESX Legacy is a FiveM roleplay framework; the supplied tree samples its in-game browser interfaces rather than the server-side framework. The visible workflows cover identity entry, character selection and actions, skin customization and configuration import/export, and menu interaction. Separate resources provide chat styling, loading, notifications, progress, and text UI. The excerpts establish several component calls and NUI request/event boundaries, but do not show how the server registers or connects these resources; those links are therefore omitted.

Main entry points: [`[core]/esx_multicharacter/web/src/components/CharacterSelection.tsx`](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_multicharacter/web/src/components/CharacterSelection.tsx) (Character Selection), [`[core]/esx_multicharacter/web/src/App.tsx`](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_multicharacter/web/src/App.tsx) (Character App), [`[core]/esx_skin/web/src/App.svelte`](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_skin/web/src/App.svelte) (Skin Editor), [`[core]/esx_skin/web/src/components/CategoryRail.svelte`](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_skin/web/src/components/CategoryRail.svelte) (Category Rail)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity UI"]
  node_identity_app["Identity App<br/>[App.vue]"]
  node_identity_form["Identity Form<br/>[Identity.vue]"]
end

subgraph group_character["Character Selection"]
  node_character_app["Character App<br/>[App.tsx]"]
  node_character_selection["Character Selection"]
  node_character_card["Character Card<br/>[CharacterCard.tsx]"]
  node_character_info["Character Info<br/>[CharacterInfo.tsx]"]
  node_character_types["Character Types<br/>[Character.ts]"]
  node_character_fetch["NUI Requests<br/>[fetchNui.ts]"]
  node_character_events["NUI Events<br/>[useNuiEvent.tsx]"]
end

subgraph group_customization["Skin Customization"]
  node_skin_app["Skin Editor<br/>[App.svelte]"]
  node_skin_data["Skin Catalog<br/>[data.ts]"]
  node_skin_types["Skin Types<br/>[types.ts]"]
  node_skin_rail["Category Rail"]
  node_skin_stepper["Value Stepper<br/>[Stepper.svelte]"]
  node_skin_icon["Asset Icon<br/>[AssetIcon.svelte]"]
  node_skin_camera["Camera Dock<br/>[CameraDock.svelte]"]
end

subgraph group_interface["Shared Interfaces"]
  node_default_menu_app["Menu App<br/>[App.tsx]"]
  node_default_menu["Menu Renderer<br/>[menu.tsx]"]
  node_menu_button["Menu Button<br/>[menu-button.tsx]"]
  node_menu_slider["Menu Slider<br/>[menu-slider.tsx]"]
  node_dialog_menu["Dialog Menu<br/>[app.js]"]
  node_list_menu["List Menu<br/>[app.js]"]
  node_notifications["Notifications<br/>[script.js]"]
  node_progress["Progress Bar<br/>[script.js]"]
  node_text_ui["Text UI<br/>[script.js]"]
  node_loading["Loading Screen<br/>[script.js]"]
  node_chat_theme["Chat Theme<br/>[shadow.js]"]
  node_extended_ui["Extended UI<br/>[app.js]"]
  node_extended_wrapper["Extended Wrapper<br/>[wrapper.js]"]
  node_locale["Locale Data<br/>[locale.js]"]
  node_medal["Medal UI<br/>[medal.js]"]
end

node_identity_app -->|"renders"| node_identity_form
node_character_app -->|"listens via"| node_character_events
node_character_app -->|"uses types"| node_character_types
node_character_app -->|"requests ready"| node_character_fetch
node_character_app -->|"renders"| node_character_selection
node_character_selection -->|"uses types"| node_character_types
node_character_selection -->|"renders"| node_character_card
node_character_selection -->|"renders"| node_character_info
node_character_selection -->|"sends actions"| node_character_fetch
node_skin_app -->|"uses catalog"| node_skin_data
node_skin_app -->|"uses types"| node_skin_types
node_skin_app -->|"renders"| node_skin_rail
node_skin_app -->|"renders"| node_skin_stepper
node_skin_rail -->|"renders"| node_skin_icon
node_skin_rail -->|"renders"| node_skin_camera
node_skin_camera -->|"uses"| node_skin_icon
node_default_menu_app -->|"renders"| node_default_menu
node_default_menu -->|"uses"| node_menu_button
node_default_menu -->|"uses"| node_menu_slider

click node_identity_app "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_identity/web/src/App.vue"
click node_identity_form "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_identity/web/src/components/Identity.vue"
click node_character_app "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_multicharacter/web/src/App.tsx"
click node_character_selection "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_multicharacter/web/src/components/CharacterSelection.tsx"
click node_character_card "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_multicharacter/web/src/components/CharacterCard.tsx"
click node_character_info "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_multicharacter/web/src/components/CharacterInfo.tsx"
click node_character_types "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_multicharacter/web/src/types/Character.ts"
click node_character_fetch "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_multicharacter/web/src/utils/fetchNui.ts"
click node_character_events "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_multicharacter/web/src/utils/useNuiEvent.tsx"
click node_skin_app "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_skin/web/src/App.svelte"
click node_skin_data "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_skin/web/src/data.ts"
click node_skin_types "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_skin/web/src/types.ts"
click node_skin_rail "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_skin/web/src/components/CategoryRail.svelte"
click node_skin_stepper "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_skin/web/src/components/Stepper.svelte"
click node_skin_icon "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_skin/web/src/components/AssetIcon.svelte"
click node_skin_camera "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_skin/web/src/components/CameraDock.svelte"
click node_default_menu_app "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_menu_default/web/src/app/App.tsx"
click node_default_menu "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_menu_default/web/src/components/menu.tsx"
click node_menu_button "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_menu_default/web/src/components/menu-button.tsx"
click node_menu_slider "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_menu_default/web/src/components/menu-slider.tsx"
click node_dialog_menu "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_menu_dialog/html/js/app.js"
click node_list_menu "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_menu_list/html/js/app.js"
click node_notifications "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_notify/nui/js/script.js"
click node_progress "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_progressbar/nui/js/script.js"
click node_text_ui "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_textui/nui/js/script.js"
click node_loading "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_loadingscreen/web/script.js"
click node_chat_theme "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_chat_theme/shadow.js"
click node_extended_ui "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/es_extended/html/js/app.js"
click node_extended_wrapper "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/es_extended/html/js/wrapper.js"
click node_locale "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/es_extended/locale.js"
click node_medal "https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_lib/html/medal.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_identity_app,node_identity_form toneBlue
class node_character_app,node_character_selection,node_character_card,node_character_info,node_character_types,node_character_fetch,node_character_events toneAmber
class node_skin_app,node_skin_data,node_skin_types,node_skin_rail,node_skin_stepper,node_skin_icon,node_skin_camera toneMint
class node_default_menu_app,node_default_menu,node_menu_button,node_menu_slider,node_dialog_menu,node_list_menu,node_notifications,node_progress,node_text_ui,node_loading,node_chat_theme,node_extended_ui,node_extended_wrapper,node_locale,node_medal toneRose
```

## Components

### Identity UI

- [Identity App](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_identity/web/src/App.vue): `[core]/esx_identity/web/src/App.vue`
- [Identity Form](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_identity/web/src/components/Identity.vue): `[core]/esx_identity/web/src/components/Identity.vue`

### Character Selection

- [Character App](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_multicharacter/web/src/App.tsx): `[core]/esx_multicharacter/web/src/App.tsx`
- [Character Selection](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_multicharacter/web/src/components/CharacterSelection.tsx): `[core]/esx_multicharacter/web/src/components/CharacterSelection.tsx`
- [Character Card](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_multicharacter/web/src/components/CharacterCard.tsx): `[core]/esx_multicharacter/web/src/components/CharacterCard.tsx`
- [Character Info](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_multicharacter/web/src/components/CharacterInfo.tsx): `[core]/esx_multicharacter/web/src/components/CharacterInfo.tsx`
- [Character Types](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_multicharacter/web/src/types/Character.ts): `[core]/esx_multicharacter/web/src/types/Character.ts`
- [NUI Requests](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_multicharacter/web/src/utils/fetchNui.ts): `[core]/esx_multicharacter/web/src/utils/fetchNui.ts`
- [NUI Events](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_multicharacter/web/src/utils/useNuiEvent.tsx): `[core]/esx_multicharacter/web/src/utils/useNuiEvent.tsx`

### Skin Customization

- [Skin Editor](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_skin/web/src/App.svelte): `[core]/esx_skin/web/src/App.svelte`
- [Skin Catalog](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_skin/web/src/data.ts): `[core]/esx_skin/web/src/data.ts`
- [Skin Types](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_skin/web/src/types.ts): `[core]/esx_skin/web/src/types.ts`
- [Category Rail](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_skin/web/src/components/CategoryRail.svelte): `[core]/esx_skin/web/src/components/CategoryRail.svelte`
- [Value Stepper](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_skin/web/src/components/Stepper.svelte): `[core]/esx_skin/web/src/components/Stepper.svelte`
- [Asset Icon](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_skin/web/src/components/AssetIcon.svelte): `[core]/esx_skin/web/src/components/AssetIcon.svelte`
- [Camera Dock](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_skin/web/src/components/CameraDock.svelte): `[core]/esx_skin/web/src/components/CameraDock.svelte`

### Shared Interfaces

- [Menu App](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_menu_default/web/src/app/App.tsx): `[core]/esx_menu_default/web/src/app/App.tsx`
- [Menu Renderer](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_menu_default/web/src/components/menu.tsx): `[core]/esx_menu_default/web/src/components/menu.tsx`
- [Menu Button](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_menu_default/web/src/components/menu-button.tsx): `[core]/esx_menu_default/web/src/components/menu-button.tsx`
- [Menu Slider](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_menu_default/web/src/components/menu-slider.tsx): `[core]/esx_menu_default/web/src/components/menu-slider.tsx`
- [Dialog Menu](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_menu_dialog/html/js/app.js): `[core]/esx_menu_dialog/html/js/app.js`
- [List Menu](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_menu_list/html/js/app.js): `[core]/esx_menu_list/html/js/app.js`
- [Notifications](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_notify/nui/js/script.js): `[core]/esx_notify/nui/js/script.js`
- [Progress Bar](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_progressbar/nui/js/script.js): `[core]/esx_progressbar/nui/js/script.js`
- [Text UI](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_textui/nui/js/script.js): `[core]/esx_textui/nui/js/script.js`
- [Loading Screen](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_loadingscreen/web/script.js): `[core]/esx_loadingscreen/web/script.js`
- [Chat Theme](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_chat_theme/shadow.js): `[core]/esx_chat_theme/shadow.js`
- [Extended UI](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/es_extended/html/js/app.js): `[core]/es_extended/html/js/app.js`
- [Extended Wrapper](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/es_extended/html/js/wrapper.js): `[core]/es_extended/html/js/wrapper.js`
- [Locale Data](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/es_extended/locale.js): `[core]/es_extended/locale.js`
- [Medal UI](https://github.com/esx-framework/esx_core/blob/main/%5Bcore%5D/esx_lib/html/medal.js): `[core]/esx_lib/html/medal.js`

## Connections

- Identity App → Identity Form: renders (evidence: `[core]/esx_identity/web/src/App.vue`)
- Character App → NUI Events: listens via (evidence: `[core]/esx_multicharacter/web/src/App.tsx`)
- Character App → Character Types: uses types (evidence: `[core]/esx_multicharacter/web/src/App.tsx`)
- Character App → NUI Requests: requests ready (evidence: `[core]/esx_multicharacter/web/src/App.tsx`)
- Character App → Character Selection: renders (evidence: `[core]/esx_multicharacter/web/src/App.tsx`)
- Character Selection → Character Types: uses types (evidence: `[core]/esx_multicharacter/web/src/components/CharacterSelection.tsx`)
- Character Selection → Character Card: renders (evidence: `[core]/esx_multicharacter/web/src/components/CharacterSelection.tsx`)
- Character Selection → Character Info: renders (evidence: `[core]/esx_multicharacter/web/src/components/CharacterSelection.tsx`)
- Character Selection → NUI Requests: sends actions (evidence: `[core]/esx_multicharacter/web/src/components/CharacterSelection.tsx`)
- Skin Editor → Skin Catalog: uses catalog (evidence: `[core]/esx_skin/web/src/App.svelte`)
- Skin Editor → Skin Types: uses types (evidence: `[core]/esx_skin/web/src/App.svelte`)
- Skin Editor → Category Rail: renders (evidence: `[core]/esx_skin/web/src/App.svelte`)
- Skin Editor → Value Stepper: renders (evidence: `[core]/esx_skin/web/src/App.svelte`)
- Category Rail → Asset Icon: renders (evidence: `[core]/esx_skin/web/src/components/CategoryRail.svelte`)
- Category Rail → Camera Dock: renders (evidence: `[core]/esx_skin/web/src/components/CategoryRail.svelte`)
- Camera Dock → Asset Icon: uses (evidence: `[core]/esx_skin/web/src/components/CategoryRail.svelte`)
- Menu App → Menu Renderer: renders (evidence: `[core]/esx_menu_default/web/src/app/App.tsx`)
- Menu Renderer → Menu Button: uses (evidence: `[core]/esx_menu_default/web/src/components/menu.tsx`)
- Menu Renderer → Menu Slider: uses (evidence: `[core]/esx_menu_default/web/src/components/menu.tsx`)
