# mahmoud-yousefi/contacts-manager-app architecture

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

- Interactive diagram: https://gitdiagram.com/mahmoud-yousefi/contacts-manager-app
- Repository: https://github.com/mahmoud-yousefi/contacts-manager-app

## Overview

This is a React contact manager: users browse and search contacts, create them, inspect a contact and its group, edit details, or confirm deletion. App owns shared contact/group state, initial loading, search filtering, and create/delete orchestration; screen components handle the distinct form and detail stages, while contactService performs REST requests. The excerpts show the client API calls and UI wiring, but do not establish how the server persists data, so no database relationship is asserted.

Main entry points: [`src/App.js`](https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/App.js) (App and routes), [`src/components/Contacts/EditContact.jsx`](https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/components/Contacts/EditContact.jsx) (Edit contact), [`src/helpers/color.js`](https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/helpers/color.js) (Theme colors), [`src/context/contactContext.js`](https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/context/contactContext.js) (Contact context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application state"]
  node_app["App and routes<br/>[App.js]"]
  node_context["Contact context<br/>[contactContext.js]"]
end

subgraph group_screens["Contact screens"]
  node_contacts["Contact list<br/>[Contacts.jsx]"]
  node_contact["Contact card<br/>[Contact.jsx]"]
  node_add["Add contact<br/>[AddContact.jsx]"]
  node_view["View contact<br/>[ViewContact.jsx]"]
  node_edit["Edit contact<br/>[EditContact.jsx]"]
  node_search["Search contacts<br/>[SearchContact.jsx]"]
end

subgraph group_services["Data and rules"]
  node_service["Contact service<br/>[contactService.js]"]
  node_validation["Contact validation"]
end

subgraph group_ui["Shared interface"]
  node_colors["Theme colors<br/>[color.js]"]
  node_navbar["Navigation bar<br/>[Navbar.jsx]"]
  node_spinner["Loading spinner<br/>[Spinner.jsx]"]
end

node_user(("User"))
node_api["Contacts REST API"]

node_user -->|"uses"| node_app
node_app -->|"provides state"| node_context
node_app -->|"routes to"| node_contacts
node_app -->|"routes to"| node_add
node_app -->|"routes to"| node_view
node_app -->|"routes to"| node_edit
node_app -->|"renders"| node_navbar
node_app -->|"loads, creates, deletes"| node_service
node_contacts -->|"reads state"| node_context
node_contacts -->|"renders"| node_contact
node_contact -->|"offers detail/edit/delete"| node_user
node_add -->|"reads form state"| node_context
node_add -->|"validates form"| node_validation
node_view -->|"reads loading state"| node_context
node_view -->|"fetches contact and group"| node_service
node_edit -->|"reads and updates state"| node_context
node_edit -->|"fetches and updates"| node_service
node_edit -.->|"validates form"| node_validation
node_navbar -->|"renders"| node_search
node_search -->|"calls search action"| node_context
node_service -->|"sends REST requests"| node_api
node_contacts -->|"shows while loading"| node_spinner
node_add -->|"shows while loading"| node_spinner
node_view -->|"shows while loading"| node_spinner
node_edit -->|"shows while loading"| node_spinner
node_contacts -->|"uses theme"| node_colors
node_contact -->|"uses theme"| node_colors
node_add -->|"uses theme"| node_colors
node_view -->|"uses theme"| node_colors
node_search -->|"uses theme"| node_colors
node_edit -->|"uses theme"| node_colors
node_navbar -->|"uses theme"| node_colors

click node_app "https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/App.js"
click node_context "https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/context/contactContext.js"
click node_contacts "https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/components/Contacts/Contacts.jsx"
click node_contact "https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/components/Contacts/Contact.jsx"
click node_add "https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/components/Contacts/AddContact.jsx"
click node_view "https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/components/Contacts/ViewContact.jsx"
click node_edit "https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/components/Contacts/EditContact.jsx"
click node_search "https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/components/Contacts/SearchContact.jsx"
click node_service "https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/services/contactService.js"
click node_validation "https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/validations/contactValidation.js"
click node_colors "https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/helpers/color.js"
click node_navbar "https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/components/Navbar.jsx"
click node_spinner "https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/components/Spinner.jsx"

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_context,node_user toneBlue
class node_contacts,node_contact,node_add,node_view,node_edit,node_search toneAmber
class node_service,node_validation,node_api toneMint
class node_colors,node_navbar,node_spinner toneRose
```

## Components

### Application state

- [App and routes](https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/App.js): `src/App.js`
- [Contact context](https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/context/contactContext.js): `src/context/contactContext.js`

### Contact screens

- [Contact list](https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/components/Contacts/Contacts.jsx): `src/components/Contacts/Contacts.jsx`
- [Contact card](https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/components/Contacts/Contact.jsx): `src/components/Contacts/Contact.jsx`
- [Add contact](https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/components/Contacts/AddContact.jsx): `src/components/Contacts/AddContact.jsx`
- [View contact](https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/components/Contacts/ViewContact.jsx): `src/components/Contacts/ViewContact.jsx`
- [Edit contact](https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/components/Contacts/EditContact.jsx): `src/components/Contacts/EditContact.jsx`
- [Search contacts](https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/components/Contacts/SearchContact.jsx): `src/components/Contacts/SearchContact.jsx`

### Data and rules

- [Contact service](https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/services/contactService.js): `src/services/contactService.js`
- [Contact validation](https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/validations/contactValidation.js): `src/validations/contactValidation.js`

### Shared interface

- [Theme colors](https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/helpers/color.js): `src/helpers/color.js`
- [Navigation bar](https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/components/Navbar.jsx): `src/components/Navbar.jsx`
- [Loading spinner](https://github.com/mahmoud-yousefi/contacts-manager-app/blob/master/src/components/Spinner.jsx): `src/components/Spinner.jsx`

### Other components

- **User**
- **Contacts REST API**

## Connections

- User → App and routes: uses (evidence: `src/App.js`)
- App and routes → Contact context: provides state (evidence: `src/App.js`)
- App and routes → Contact list: routes to (evidence: `src/App.js`)
- App and routes → Add contact: routes to (evidence: `src/App.js`)
- App and routes → View contact: routes to (evidence: `src/App.js`)
- App and routes → Edit contact: routes to (evidence: `src/App.js`)
- App and routes → Navigation bar: renders (evidence: `src/App.js`)
- App and routes → Contact service: loads, creates, deletes (evidence: `src/App.js`)
- Contact list → Contact context: reads state (evidence: `src/components/Contacts/Contacts.jsx`)
- Contact list → Contact card: renders (evidence: `src/components/Contacts/Contacts.jsx`)
- Contact card → User: offers detail/edit/delete (evidence: `src/components/Contacts/Contact.jsx`)
- Add contact → Contact context: reads form state (evidence: `src/components/Contacts/AddContact.jsx`)
- Add contact → Contact validation: validates form (evidence: `src/components/Contacts/AddContact.jsx`)
- View contact → Contact context: reads loading state (evidence: `src/components/Contacts/ViewContact.jsx`)
- View contact → Contact service: fetches contact and group (evidence: `src/components/Contacts/ViewContact.jsx`)
- Edit contact → Contact context: reads and updates state (evidence: `src/components/Contacts/EditContact.jsx`)
- Edit contact → Contact service: fetches and updates (evidence: `src/components/Contacts/EditContact.jsx`)
- Edit contact → Contact validation: validates form (evidence: `src/components/Contacts/EditContact.jsx`)
- Navigation bar → Search contacts: renders (evidence: `src/components/Navbar.jsx`)
- Search contacts → Contact context: calls search action (evidence: `src/components/Contacts/SearchContact.jsx`)
- Contact service → Contacts REST API: sends REST requests (evidence: `src/services/contactService.js`)
- Contact list → Loading spinner: shows while loading (evidence: `src/components/Contacts/Contacts.jsx`)
- Add contact → Loading spinner: shows while loading (evidence: `src/components/Contacts/AddContact.jsx`)
- View contact → Loading spinner: shows while loading (evidence: `src/components/Contacts/ViewContact.jsx`)
- Edit contact → Loading spinner: shows while loading (evidence: `src/components/Contacts/EditContact.jsx`)
- Contact list → Theme colors: uses theme (evidence: `src/components/Contacts/Contacts.jsx`)
- Contact card → Theme colors: uses theme (evidence: `src/components/Contacts/Contact.jsx`)
- Add contact → Theme colors: uses theme (evidence: `src/components/Contacts/AddContact.jsx`)
- View contact → Theme colors: uses theme (evidence: `src/components/Contacts/ViewContact.jsx`)
- Search contacts → Theme colors: uses theme (evidence: `src/components/Contacts/SearchContact.jsx`)
- Edit contact → Theme colors: uses theme (evidence: `src/components/Contacts/EditContact.jsx`)
- Navigation bar → Theme colors: uses theme (evidence: `src/components/Navbar.jsx`)
