# marmelab/react-admin architecture

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

- Interactive diagram: https://gitdiagram.com/marmelab/react-admin
- Repository: https://github.com/marmelab/react-admin

## Overview

react-admin is a React framework for building browser-based administration apps over REST or GraphQL APIs. The principal workflow configures an Admin with Resources, routes a user to a resource page, loads and displays records, and lets the user create or edit them through forms and a data-provider adapter. The graph also preserves documented capabilities such as access control, filtering, relationships, export, internationalization, notifications, and theming. Most relationships are grounded in README statements or SOURCE INDEX references; unsampled subsystems are shown without speculative call chains.

Main entry points: [`packages/ra-core/src/controller/list/useListController.ts`](https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/controller/list/useListController.ts) (List controller), [`packages/ra-core/src/dataProvider/useGetList.ts`](https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/dataProvider/useGetList.ts) (Data operations), [`packages/ra-core/src/core/Resource.tsx`](https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/core/Resource.tsx) (Resource routes), [`packages/ra-core/src/controller/edit/useEditController.ts`](https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/controller/edit/useEditController.ts) (Create edit show)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Admin application"]
  node_admin["Admin entry<br/>[Admin.tsx]"]
  node_resources["Resource routes<br/>[Resource.tsx]"]
  node_router["Router providers"]
end

subgraph group_records["Resource workflows"]
  node_list["List controller"]
  node_liststate["List query state<br/>[queryReducer.ts]"]
  node_datagrid["Data grid<br/>[Datagrid.tsx]"]
  node_recordviews["Create edit show"]
  node_forms["Forms and validation<br/>[Form.tsx]"]
  node_references["Related records"]
  node_export["Bulk export<br/>[useBulkExport.ts]"]
end

subgraph group_platform["Core services"]
  node_auth["Authentication access"]
  node_providerhooks["Data operations<br/>[useGetList.ts]"]
  node_mutations["Mutation behavior"]
  node_notifications["Notifications"]
  node_i18n["Internationalization"]
  node_preferences["Preferences<br/>[usePreference.ts]"]
end

subgraph group_integrations["Adapters and UI"]
  node_rest["REST providers<br/>[index.ts]"]
  node_graphql["GraphQL providers<br/>[buildQuery.ts]"]
  node_material["Material UI<br/>[Datagrid.tsx]"]
end

node_user(("Admin user"))
node_api{{"REST GraphQL API"}}

node_user -->|"opens app"| node_admin
node_admin -->|"configures resources"| node_resources
node_resources -.->|"routes pages"| node_router
node_resources -->|"renders list"| node_list
node_resources -->|"renders record pages"| node_recordviews
node_list -->|"uses query state"| node_liststate
node_list -->|"loads records"| node_providerhooks
node_list -->|"checks access"| node_auth
node_list -->|"provides list data"| node_datagrid
node_datagrid -->|"renders with"| node_material
node_recordviews -->|"loads record"| node_providerhooks
node_recordviews -->|"saves changes"| node_mutations
node_recordviews -->|"uses form"| node_forms
node_references -->|"loads related records"| node_providerhooks
node_export -.->|"fetches export data"| node_providerhooks
node_providerhooks -.->|"dispatches REST calls"| node_rest
node_providerhooks -.->|"dispatches GraphQL calls"| node_graphql
node_rest -->|"queries"| node_api
node_graphql -->|"queries"| node_api
node_auth -.->|"reports access errors"| node_notifications
node_admin -.->|"configures translations"| node_i18n
node_list -.->|"supports saved queries"| node_preferences

click node_admin "https://github.com/marmelab/react-admin/blob/master/packages/react-admin/src/Admin.tsx"
click node_resources "https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/core/Resource.tsx"
click node_router "https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/routing/RouterProviderContext.tsx"
click node_list "https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/controller/list/useListController.ts"
click node_liststate "https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/controller/list/queryReducer.ts"
click node_datagrid "https://github.com/marmelab/react-admin/blob/master/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx"
click node_recordviews "https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/controller/edit/useEditController.ts"
click node_forms "https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/form/Form.tsx"
click node_references "https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts"
click node_export "https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/export/useBulkExport.ts"
click node_auth "https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/auth/WithPermissions.tsx"
click node_providerhooks "https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/dataProvider/useGetList.ts"
click node_mutations "https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/dataProvider/useMutationWithMutationMode.ts"
click node_notifications "https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/notification/NotificationContextProvider.tsx"
click node_i18n "https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/i18n/I18nContextProvider.tsx"
click node_preferences "https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/preferences/usePreference.ts"
click node_rest "https://github.com/marmelab/react-admin/blob/master/packages/ra-data-simple-rest/src/index.ts"
click node_graphql "https://github.com/marmelab/react-admin/blob/master/packages/ra-data-graphql-simple/src/buildQuery.ts"
click node_material "https://github.com/marmelab/react-admin/blob/master/packages/ra-ui-materialui/src/list/datagrid/Datagrid.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_admin,node_resources,node_router,node_user toneBlue
class node_list,node_liststate,node_datagrid,node_recordviews,node_forms,node_references,node_export toneAmber
class node_auth,node_providerhooks,node_mutations,node_notifications,node_i18n,node_preferences,node_api toneMint
class node_rest,node_graphql,node_material toneRose
```

## Components

### Admin application

- [Admin entry](https://github.com/marmelab/react-admin/blob/master/packages/react-admin/src/Admin.tsx): `packages/react-admin/src/Admin.tsx`
- [Resource routes](https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/core/Resource.tsx): `packages/ra-core/src/core/Resource.tsx`
- [Router providers](https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/routing/RouterProviderContext.tsx): `packages/ra-core/src/routing/RouterProviderContext.tsx`

### Resource workflows

- [List controller](https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/controller/list/useListController.ts): `packages/ra-core/src/controller/list/useListController.ts`
- [List query state](https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/controller/list/queryReducer.ts): `packages/ra-core/src/controller/list/queryReducer.ts`
- [Data grid](https://github.com/marmelab/react-admin/blob/master/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx): `packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx`
- [Create edit show](https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/controller/edit/useEditController.ts): `packages/ra-core/src/controller/edit/useEditController.ts`
- [Forms and validation](https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/form/Form.tsx): `packages/ra-core/src/form/Form.tsx`
- [Related records](https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts): `packages/ra-core/src/controller/field/useReferenceManyFieldController.ts`
- [Bulk export](https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/export/useBulkExport.ts): `packages/ra-core/src/export/useBulkExport.ts`

### Core services

- [Authentication access](https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/auth/WithPermissions.tsx): `packages/ra-core/src/auth/WithPermissions.tsx`
- [Data operations](https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/dataProvider/useGetList.ts): `packages/ra-core/src/dataProvider/useGetList.ts`
- [Mutation behavior](https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/dataProvider/useMutationWithMutationMode.ts): `packages/ra-core/src/dataProvider/useMutationWithMutationMode.ts`
- [Notifications](https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/notification/NotificationContextProvider.tsx): `packages/ra-core/src/notification/NotificationContextProvider.tsx`
- [Internationalization](https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/i18n/I18nContextProvider.tsx): `packages/ra-core/src/i18n/I18nContextProvider.tsx`
- [Preferences](https://github.com/marmelab/react-admin/blob/master/packages/ra-core/src/preferences/usePreference.ts): `packages/ra-core/src/preferences/usePreference.ts`

### Adapters and UI

- [REST providers](https://github.com/marmelab/react-admin/blob/master/packages/ra-data-simple-rest/src/index.ts): `packages/ra-data-simple-rest/src/index.ts`
- [GraphQL providers](https://github.com/marmelab/react-admin/blob/master/packages/ra-data-graphql-simple/src/buildQuery.ts): `packages/ra-data-graphql-simple/src/buildQuery.ts`
- [Material UI](https://github.com/marmelab/react-admin/blob/master/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx): `packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx`

### Other components

- **Admin user**
- **REST GraphQL API**

## Connections

- Admin user → Admin entry: opens app
- Admin entry → Resource routes: configures resources
- Resource routes → Router providers: routes pages
- Resource routes → List controller: renders list (evidence: `packages/ra-core/src/controller/list/useListController.ts`)
- Resource routes → Create edit show: renders record pages
- List controller → List query state: uses query state (evidence: `packages/ra-core/src/controller/list/useListController.ts`)
- List controller → Data operations: loads records (evidence: `packages/ra-core/src/controller/list/useListController.ts`)
- List controller → Authentication access: checks access (evidence: `packages/ra-core/src/controller/list/useListController.ts`)
- List controller → Data grid: provides list data
- Data grid → Material UI: renders with
- Create edit show → Data operations: loads record (evidence: `packages/ra-core/src/controller/edit/useEditController.ts`)
- Create edit show → Mutation behavior: saves changes (evidence: `packages/ra-core/src/controller/edit/useEditController.ts`)
- Create edit show → Forms and validation: uses form
- Related records → Data operations: loads related records (evidence: `packages/ra-core/src/controller/field/useReferenceManyFieldController.ts`)
- Bulk export → Data operations: fetches export data
- Data operations → REST providers: dispatches REST calls
- Data operations → GraphQL providers: dispatches GraphQL calls
- REST providers → REST GraphQL API: queries
- GraphQL providers → REST GraphQL API: queries
- Authentication access → Notifications: reports access errors
- Admin entry → Internationalization: configures translations
- List controller → Preferences: supports saved queries
