# ivanespmar/numlab architecture

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

- Interactive diagram: https://gitdiagram.com/ivanespmar/numlab
- Repository: https://github.com/ivanespmar/numlab

## Overview

NumLab is a React application for learning and using numerical methods. Users enter through the home page, select a problem category and method, read its introduction, then navigate to a calculator to enter data and view a result. The documented capabilities cover nonlinear roots, linear systems and factorizations, and eigenvalues. Calculator implementations appear to perform calculations within their route components; no external calculation service or persistent store is shown. Links reflect the router and imports in the excerpts and source index; unsampled calculator internals are not inferred.

Main entry points: [`src/App.tsx`](https://github.com/ivanespmar/numlab/blob/main/src/App.tsx) (App router), [`src/components/tarjeta-grid/tarjeta-grid.tsx`](https://github.com/ivanespmar/numlab/blob/main/src/components/tarjeta-grid/tarjeta-grid.tsx) (Method listings), [`src/components/method-introduction/method-introduction.tsx`](https://github.com/ivanespmar/numlab/blob/main/src/components/method-introduction/method-introduction.tsx) (Method introduction), [`src/routes/problems/problems.tsx`](https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/problems.tsx) (Problem selection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Navigation and learning UI"]
  node_router["App router<br/>[App.tsx]"]
  node_home["Home presentation<br/>[home.tsx]"]
  node_problemmenu["Problem selection<br/>[problems.tsx]"]
  node_methodcards["Method listings<br/>[tarjeta-grid.tsx]"]
  node_methodcard["Navigation card<br/>[tarjeta.tsx]"]
  node_introview["Method introduction"]
end

subgraph group_nonlinear["Nonlinear equations"]
  node_rootlist["Root method list<br/>[nolineal.tsx]"]
  node_rootintro["Root introductions"]
  node_bisection["Bisection calculator<br/>[biseccion.tsx]"]
  node_newton["Newton calculator<br/>[newton.tsx]"]
  node_secant["Secant calculator<br/>[secante.tsx]"]
end

subgraph group_linear["Linear systems"]
  node_linearlist["Linear method list<br/>[sistemas.tsx]"]
  node_linearintro["Linear introductions"]
  node_gaussjordan["Gauss-Jordan<br/>[gauss-jordan.tsx]"]
  node_jacobi["Jacobi<br/>[jacobi.tsx]"]
  node_seidel["Gauss-Seidel<br/>[gauss-seidel.tsx]"]
  node_doolittle["Doolittle factorization<br/>[doolittle.tsx]"]
  node_crout["Crout factorization<br/>[crout.tsx]"]
end

subgraph group_eigen["Eigenvalues"]
  node_eigenlist["Eigenvalue method list<br/>[eigenvalues.tsx]"]
  node_eigenintro["Eigenvalue introductions"]
  node_power["Power method<br/>[potencia.tsx]"]
  node_inversepower["Inverse power method<br/>[inversa.tsx]"]
end

node_user(("Learner"))

node_user -->|"opens app"| node_router
node_router -->|"routes to"| node_home
node_router -->|"routes to"| node_problemmenu
node_router -->|"routes to"| node_rootlist
node_router -->|"routes to"| node_rootintro
node_router -->|"routes to"| node_bisection
node_router -->|"routes to"| node_newton
node_router -->|"routes to"| node_secant
node_router -->|"routes to"| node_linearlist
node_router -->|"routes to"| node_linearintro
node_router -->|"routes to"| node_gaussjordan
node_router -->|"routes to"| node_jacobi
node_router -->|"routes to"| node_seidel
node_router -->|"routes to"| node_doolittle
node_router -->|"routes to"| node_crout
node_router -->|"routes to"| node_eigenlist
node_router -->|"routes to"| node_eigenintro
node_router -->|"routes to"| node_power
node_router -->|"routes to"| node_inversepower
node_problemmenu -->|"renders"| node_methodcards
node_methodcards -->|"renders"| node_methodcard
node_rootlist -->|"renders"| node_methodcards
node_linearlist -->|"renders"| node_methodcards
node_eigenlist -->|"renders"| node_methodcards
node_rootintro -->|"renders"| node_introview
node_linearintro -->|"renders"| node_introview
node_eigenintro -->|"renders"| node_introview

click node_router "https://github.com/ivanespmar/numlab/blob/main/src/App.tsx"
click node_home "https://github.com/ivanespmar/numlab/blob/main/src/routes/home.tsx"
click node_problemmenu "https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/problems.tsx"
click node_methodcards "https://github.com/ivanespmar/numlab/blob/main/src/components/tarjeta-grid/tarjeta-grid.tsx"
click node_methodcard "https://github.com/ivanespmar/numlab/blob/main/src/components/tarjeta/tarjeta.tsx"
click node_introview "https://github.com/ivanespmar/numlab/blob/main/src/components/method-introduction/method-introduction.tsx"
click node_rootlist "https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/nolineal/nolineal.tsx"
click node_rootintro "https://github.com/ivanespmar/numlab/tree/main/src/routes/problems/nolineal"
click node_bisection "https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/nolineal/biseccion/biseccion.tsx"
click node_newton "https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/nolineal/newton/newton.tsx"
click node_secant "https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/nolineal/secante/secante.tsx"
click node_linearlist "https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/sistemas/sistemas.tsx"
click node_linearintro "https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/sistemas/sistemas-introducciones.tsx"
click node_gaussjordan "https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/sistemas/gauss-jordan/gauss-jordan.tsx"
click node_jacobi "https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/sistemas/jacobi/jacobi.tsx"
click node_seidel "https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/sistemas/gauss-seidel/gauss-seidel.tsx"
click node_doolittle "https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/sistemas/doolittle/doolittle.tsx"
click node_crout "https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/sistemas/crout/crout.tsx"
click node_eigenlist "https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/eigenvalues/eigenvalues.tsx"
click node_eigenintro "https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/eigenvalues/eigenvalues-introducciones.tsx"
click node_power "https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/eigenvalues/potencia/potencia.tsx"
click node_inversepower "https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/eigenvalues/inversa/inversa.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_router,node_home,node_problemmenu,node_methodcards,node_methodcard,node_introview toneBlue
class node_rootlist,node_rootintro,node_bisection,node_newton,node_secant toneAmber
class node_linearlist,node_linearintro,node_gaussjordan,node_jacobi,node_seidel,node_doolittle,node_crout toneMint
class node_eigenlist,node_eigenintro,node_power,node_inversepower toneRose
class node_user toneIndigo
```

## Components

### Navigation and learning UI

- [App router](https://github.com/ivanespmar/numlab/blob/main/src/App.tsx): `src/App.tsx`
- [Home presentation](https://github.com/ivanespmar/numlab/blob/main/src/routes/home.tsx): `src/routes/home.tsx`
- [Problem selection](https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/problems.tsx): `src/routes/problems/problems.tsx`
- [Method listings](https://github.com/ivanespmar/numlab/blob/main/src/components/tarjeta-grid/tarjeta-grid.tsx): `src/components/tarjeta-grid/tarjeta-grid.tsx`
- [Navigation card](https://github.com/ivanespmar/numlab/blob/main/src/components/tarjeta/tarjeta.tsx): `src/components/tarjeta/tarjeta.tsx`
- [Method introduction](https://github.com/ivanespmar/numlab/blob/main/src/components/method-introduction/method-introduction.tsx): `src/components/method-introduction/method-introduction.tsx`

### Nonlinear equations

- [Root method list](https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/nolineal/nolineal.tsx): `src/routes/problems/nolineal/nolineal.tsx`
- [Root introductions](https://github.com/ivanespmar/numlab/tree/main/src/routes/problems/nolineal): `src/routes/problems/nolineal`
- [Bisection calculator](https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/nolineal/biseccion/biseccion.tsx): `src/routes/problems/nolineal/biseccion/biseccion.tsx`
- [Newton calculator](https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/nolineal/newton/newton.tsx): `src/routes/problems/nolineal/newton/newton.tsx`
- [Secant calculator](https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/nolineal/secante/secante.tsx): `src/routes/problems/nolineal/secante/secante.tsx`

### Linear systems

- [Linear method list](https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/sistemas/sistemas.tsx): `src/routes/problems/sistemas/sistemas.tsx`
- [Linear introductions](https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/sistemas/sistemas-introducciones.tsx): `src/routes/problems/sistemas/sistemas-introducciones.tsx`
- [Gauss-Jordan](https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/sistemas/gauss-jordan/gauss-jordan.tsx): `src/routes/problems/sistemas/gauss-jordan/gauss-jordan.tsx`
- [Jacobi](https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/sistemas/jacobi/jacobi.tsx): `src/routes/problems/sistemas/jacobi/jacobi.tsx`
- [Gauss-Seidel](https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/sistemas/gauss-seidel/gauss-seidel.tsx): `src/routes/problems/sistemas/gauss-seidel/gauss-seidel.tsx`
- [Doolittle factorization](https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/sistemas/doolittle/doolittle.tsx): `src/routes/problems/sistemas/doolittle/doolittle.tsx`
- [Crout factorization](https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/sistemas/crout/crout.tsx): `src/routes/problems/sistemas/crout/crout.tsx`

### Eigenvalues

- [Eigenvalue method list](https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/eigenvalues/eigenvalues.tsx): `src/routes/problems/eigenvalues/eigenvalues.tsx`
- [Eigenvalue introductions](https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/eigenvalues/eigenvalues-introducciones.tsx): `src/routes/problems/eigenvalues/eigenvalues-introducciones.tsx`
- [Power method](https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/eigenvalues/potencia/potencia.tsx): `src/routes/problems/eigenvalues/potencia/potencia.tsx`
- [Inverse power method](https://github.com/ivanespmar/numlab/blob/main/src/routes/problems/eigenvalues/inversa/inversa.tsx): `src/routes/problems/eigenvalues/inversa/inversa.tsx`

### Other components

- **Learner**

## Connections

- Learner → App router: opens app
- App router → Home presentation: routes to (evidence: `src/App.tsx`)
- App router → Problem selection: routes to (evidence: `src/App.tsx`)
- App router → Root method list: routes to (evidence: `src/App.tsx`)
- App router → Root introductions: routes to (evidence: `src/App.tsx`)
- App router → Bisection calculator: routes to (evidence: `src/App.tsx`)
- App router → Newton calculator: routes to (evidence: `src/App.tsx`)
- App router → Secant calculator: routes to (evidence: `src/App.tsx`)
- App router → Linear method list: routes to (evidence: `src/App.tsx`)
- App router → Linear introductions: routes to (evidence: `src/App.tsx`)
- App router → Gauss-Jordan: routes to (evidence: `src/App.tsx`)
- App router → Jacobi: routes to (evidence: `src/App.tsx`)
- App router → Gauss-Seidel: routes to (evidence: `src/App.tsx`)
- App router → Doolittle factorization: routes to (evidence: `src/App.tsx`)
- App router → Crout factorization: routes to (evidence: `src/App.tsx`)
- App router → Eigenvalue method list: routes to (evidence: `src/App.tsx`)
- App router → Eigenvalue introductions: routes to (evidence: `src/App.tsx`)
- App router → Power method: routes to (evidence: `src/App.tsx`)
- App router → Inverse power method: routes to (evidence: `src/App.tsx`)
- Problem selection → Method listings: renders (evidence: `src/routes/problems/problems.tsx`)
- Method listings → Navigation card: renders (evidence: `src/components/tarjeta-grid/tarjeta-grid.tsx`)
- Root method list → Method listings: renders (evidence: `src/routes/problems/nolineal/nolineal.tsx`)
- Linear method list → Method listings: renders (evidence: `src/routes/problems/sistemas/sistemas.tsx`)
- Eigenvalue method list → Method listings: renders (evidence: `src/routes/problems/eigenvalues/eigenvalues.tsx`)
- Root introductions → Method introduction: renders (evidence: `src/routes/problems/nolineal/biseccion/biseccion-introduccion.tsx`)
- Linear introductions → Method introduction: renders (evidence: `src/routes/problems/sistemas/sistemas-introducciones.tsx`)
- Eigenvalue introductions → Method introduction: renders (evidence: `src/routes/problems/eigenvalues/eigenvalues-introducciones.tsx`)
