# luis-angellf/website-cardiapp architecture

> Architecture diagram of the GitHub repository luis-angellf/website-cardiapp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-05-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/luis-angellf/website-cardiapp
- Repository: https://github.com/luis-angellf/website-cardiapp

## Overview

1. This repository is a small client-side React single-page application built with Vite. The architecture is mostly presentation/UI focused: there is no backend, API client, state store, or database layer visible in the repo.

2. The runtime/build boundary is Vite + React. `vite.config.js` drives local dev and production bundling, `index.html` is the HTML shell, and `src/main.jsx` is the application bootstrap point that mounts the React tree into the DOM.

3. Routing is isolated in `src/routes/AppRouter.jsx`. That file is the main navigation boundary for the app and likely maps URL paths to the page-level views. The route structure appears to be simple and page-based rather than deeply nested.

4. The page layer lives in `src/pages/` and contains the primary route destinations: `HomePage.jsx`, `AboutUs.jsx`, and `ContactUs.jsx`. These are the top-level screens a diagram should show as the main content endpoints.

5. Shared layout components are in `src/components/`, notably `Navbar.jsx` and `Footer.jsx`. These are likely reused across all pages, forming the common chrome around routed content rather than being page-specific.

6. `src/App.jsx` is the application composition layer. In a typical Vite React app of this shape, it acts as the root UI wrapper and likely brings together the router and the shared layout components.

7. Styling is split between global and component-level CSS. `src/index.css` is the global baseline, while `src/App.css` appears to hold app-specific styling. This suggests a straightforward CSS-based styling approach rather than CSS-in-JS or a design system.

8. Static assets are stored under `src/images/` and `src/assets/`. The `src/images/icons/` folder suggests the UI uses local icon/image resources directly in components and pages. `public/` is available for static files that need to be served as-is.

9. The data flow is purely UI-driven: browser request loads `index.html`, Vite serves the bundle, `main.jsx` mounts the React app, `AppRouter.jsx` selects a page based on the URL, and page components render inside the shared navbar/footer shell. No external service integration is evident from the file tree.

10. Tooling is minimal and standard for a React/Vite project. `eslint.config.js` provides linting, and `package-lock.json` indicates npm-managed dependencies. This is a low-complexity front-end codebase with clear separation between bootstrap, routing, pages, shared components, and assets.

Main entry points: [`src/App.jsx`](https://github.com/luis-angellf/website-cardiapp/blob/main/src/App.jsx) (App), [`src/routes/AppRouter.jsx`](https://github.com/luis-angellf/website-cardiapp/blob/main/src/routes/AppRouter.jsx) (Router), [`src/main.jsx`](https://github.com/luis-angellf/website-cardiapp/blob/main/src/main.jsx) (Bootstrap), [`index.html`](https://github.com/luis-angellf/website-cardiapp/blob/main/index.html) (HTML shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_build["Build/runtime"]
  node_viteconfig["Vite config<br/>build config<br/>[vite.config.js]"]
  node_html["HTML shell<br/>entry html<br/>[index.html]"]
  node_main["Bootstrap<br/>react entry<br/>[main.jsx]"]
end

subgraph group_shell["App shell"]
  node_app["App<br/>ui root<br/>[App.jsx]"]
  node_navbar["Navbar<br/>shared nav<br/>[Navbar.jsx]"]
  node_footer["Footer<br/>[Footer.jsx]"]
end

subgraph group_nav["Routing"]
  node_router["Router<br/>route map<br/>[AppRouter.jsx]"]
end

subgraph group_pages["Pages"]
  node_home["Home<br/>page<br/>[HomePage.jsx]"]
  node_about["About<br/>page<br/>[AboutUs.jsx]"]
  node_contact["Contact<br/>page<br/>[ContactUs.jsx]"]
end

subgraph group_style["Styling"]
  node_appcss["App CSS<br/>styles<br/>[App.css]"]
  node_globalcss["Global CSS<br/>styles<br/>[index.css]"]
end

subgraph group_static["Static assets"]
  node_icons[("Icons<br/>asset dir")]
  node_images[("Images<br/>asset dir")]
  node_public[("Public<br/>static dir")]
end

node_viteconfig -->|"serves"| node_html
node_html -->|"loads"| node_main
node_main -->|"mounts"| node_app
node_app -->|"navigates"| node_router
node_app -->|"wraps"| node_navbar
node_app -->|"wraps"| node_footer
node_app -->|"styles"| node_appcss
node_main -->|"imports"| node_globalcss
node_router -->|"routes"| node_home
node_router -->|"routes"| node_about
node_router -->|"routes"| node_contact
node_home -->|"uses"| node_icons
node_about -->|"uses"| node_images
node_contact -->|"uses"| node_icons
node_app -.->|"serves"| node_public

click node_viteconfig "https://github.com/luis-angellf/website-cardiapp/blob/main/vite.config.js"
click node_html "https://github.com/luis-angellf/website-cardiapp/blob/main/index.html"
click node_main "https://github.com/luis-angellf/website-cardiapp/blob/main/src/main.jsx"
click node_app "https://github.com/luis-angellf/website-cardiapp/blob/main/src/App.jsx"
click node_router "https://github.com/luis-angellf/website-cardiapp/blob/main/src/routes/AppRouter.jsx"
click node_navbar "https://github.com/luis-angellf/website-cardiapp/blob/main/src/components/Navbar.jsx"
click node_footer "https://github.com/luis-angellf/website-cardiapp/blob/main/src/components/Footer.jsx"
click node_home "https://github.com/luis-angellf/website-cardiapp/blob/main/src/pages/HomePage.jsx"
click node_about "https://github.com/luis-angellf/website-cardiapp/blob/main/src/pages/AboutUs.jsx"
click node_contact "https://github.com/luis-angellf/website-cardiapp/blob/main/src/pages/ContactUs.jsx"
click node_appcss "https://github.com/luis-angellf/website-cardiapp/blob/main/src/App.css"
click node_globalcss "https://github.com/luis-angellf/website-cardiapp/blob/main/src/index.css"
click node_icons "https://github.com/luis-angellf/website-cardiapp/tree/main/src/images/icons"
click node_images "https://github.com/luis-angellf/website-cardiapp/tree/main/src/images"
click node_public "https://github.com/luis-angellf/website-cardiapp/tree/main/public"

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_viteconfig,node_html,node_main toneBlue
class node_app,node_navbar,node_footer toneAmber
class node_router toneMint
class node_home,node_about,node_contact toneRose
class node_appcss,node_globalcss toneIndigo
class node_icons,node_images,node_public toneTeal
```

## Components

### Build/runtime

Vite entry points and browser bootstrap

- [Vite config](https://github.com/luis-angellf/website-cardiapp/blob/main/vite.config.js): build config · Vite dev/build configuration · `vite.config.js`
- [HTML shell](https://github.com/luis-angellf/website-cardiapp/blob/main/index.html): entry html · Browser document that loads the app bundle · `index.html`
- [Bootstrap](https://github.com/luis-angellf/website-cardiapp/blob/main/src/main.jsx): react entry · Mounts the React app into the DOM · `src/main.jsx`

### App shell

Root composition and shared chrome

- [App](https://github.com/luis-angellf/website-cardiapp/blob/main/src/App.jsx): ui root · Top-level application composition · `src/App.jsx`
- [Navbar](https://github.com/luis-angellf/website-cardiapp/blob/main/src/components/Navbar.jsx): shared nav · Common top navigation chrome · `src/components/Navbar.jsx`
- [Footer](https://github.com/luis-angellf/website-cardiapp/blob/main/src/components/Footer.jsx): shared footer · Common bottom chrome · `src/components/Footer.jsx`

### Routing

URL-to-page navigation boundary

- [Router](https://github.com/luis-angellf/website-cardiapp/blob/main/src/routes/AppRouter.jsx): route map · Maps URL paths to page views · `src/routes/AppRouter.jsx`

### Pages

Top-level screen components

- [Home](https://github.com/luis-angellf/website-cardiapp/blob/main/src/pages/HomePage.jsx): page · Landing page view · `src/pages/HomePage.jsx`
- [About](https://github.com/luis-angellf/website-cardiapp/blob/main/src/pages/AboutUs.jsx): page · About page view · `src/pages/AboutUs.jsx`
- [Contact](https://github.com/luis-angellf/website-cardiapp/blob/main/src/pages/ContactUs.jsx): page · Contact page view · `src/pages/ContactUs.jsx`

### Styling

Global and app-specific CSS

- [App CSS](https://github.com/luis-angellf/website-cardiapp/blob/main/src/App.css): styles · App-scoped styling · `src/App.css`
- [Global CSS](https://github.com/luis-angellf/website-cardiapp/blob/main/src/index.css): styles · Baseline application styles · `src/index.css`

### Static assets

Local images and public files

- [Icons](https://github.com/luis-angellf/website-cardiapp/tree/main/src/images/icons): asset dir · Local icon and image assets · `src/images/icons`
- [Images](https://github.com/luis-angellf/website-cardiapp/tree/main/src/images): asset dir · Image asset directory · `src/images`
- [Public](https://github.com/luis-angellf/website-cardiapp/tree/main/public): static dir · Static files served as-is · `public`

## Connections

- Vite config → HTML shell: serves · Configures the app entry document
- HTML shell → Bootstrap: loads · Browser loads the Vite bundle entry
- Bootstrap → App: mounts · Bootstraps the React root
- App → Router: navigates · Delegates page selection to routing
- App → Navbar: wraps · Adds shared header chrome
- App → Footer: wraps · Adds shared footer chrome
- App → App CSS: styles · App-level styling
- Bootstrap → Global CSS: imports · Loads global baseline styles
- Router → Home: routes · Maps a path to the home page
- Router → About: routes · Maps a path to the about page
- Router → Contact: routes · Maps a path to the contact page
- Home → Icons: uses · Consumes local UI icons
- About → Images: uses · Consumes image assets
- Contact → Icons: uses · Consumes local UI icons
- App → Public: serves · Static files available to the app
