# joaoferreirape/mobile-apps-react-native architecture

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

- Interactive diagram: https://gitdiagram.com/joaoferreirape/mobile-apps-react-native
- Repository: https://github.com/joaoferreirape/mobile-apps-react-native

## Overview

This is a React Native/Expo e-commerce mobile app. The main shopping flow is browsing home promotions or the store catalog, opening a product, selecting options and adding it to the cart, then reviewing the purchase. The graph also includes onboarding/sign-in, local cart persistence, and invoice generation. Relationships are limited to calls and imports shown in excerpts or the source index; several component implementations and the service layer were not sampled, so their internal behavior is not inferred.

Main entry points: [`ecommerce-app-expo/src/rotas/TabRotas.js`](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/rotas/TabRotas.js) (Tab navigation), [`ecommerce-app-expo/src/telas/Produto/index.js`](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/Produto/index.js) (Product screen), [`ecommerce-app-expo/src/rotas/StackRotas.js`](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/rotas/StackRotas.js) (Stack navigation), [`ecommerce-app-expo/src/telas/Home/index.js`](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/Home/index.js) (Home screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and navigation"]
  node_app["App shell<br/>[App.js]"]
  node_stack["Stack navigation<br/>[StackRotas.js]"]
  node_tabs["Tab navigation<br/>[TabRotas.js]"]
  node_welcome["Welcome screen<br/>[index.js]"]
  node_signin["Sign-in screen<br/>[index.js]"]
end

subgraph group_discovery["Shopping discovery"]
  node_home["Home screen<br/>[index.js]"]
  node_ads["Announcements<br/>[Anuncios.js]"]
  node_offers["Offers section<br/>[Ofertas.js]"]
  node_store["Store screen<br/>[index.js]"]
  node_recommended["Recommended items"]
end

subgraph group_purchase["Product and checkout"]
  node_product["Product screen<br/>[index.js]"]
  node_carousel["Product carousel<br/>[Carrossel.js]"]
  node_cart["Cart screen<br/>[index.js]"]
  node_cartitem["Cart item<br/>[Item.js]"]
  node_summary["Purchase summary<br/>[ResumoCompra.js]"]
  node_modal["Purchase modal<br/>[CompraModal.js]"]
  node_invoice["Invoice template<br/>[NotaFiscal.js]"]
end

subgraph group_state["Data and persistence"]
  node_context["Cart context<br/>[GlobalContext.js]"]
  node_local[("Local cart storage<br/>[index.js]")]
  node_hooks["Catalog hooks<br/>[useProdutos.js]"]
  node_adshook["Announcement hook<br/>[useAnuncios.js]"]
  node_offershook["Offers hook<br/>[useOfertas.js]"]
  node_services["Catalog services<br/>[index.js]"]
end

node_shopper(("Shopper"))
node_asyncstorage[("AsyncStorage")]

node_shopper -->|"opens app"| node_welcome
node_app -->|"renders"| node_stack
node_stack -->|"routes to"| node_welcome
node_stack -->|"routes to"| node_signin
node_stack -->|"routes to"| node_tabs
node_stack -->|"routes to"| node_product
node_welcome -->|"navigates to"| node_signin
node_signin -->|"navigates to"| node_tabs
node_signin -->|"saves user"| node_asyncstorage
node_tabs -->|"hosts"| node_home
node_tabs -->|"hosts"| node_store
node_tabs -->|"hosts"| node_cart
node_home -->|"renders"| node_ads
node_home -->|"renders"| node_offers
node_home -->|"loads announcements"| node_adshook
node_home -->|"loads offers"| node_offershook
node_store -->|"renders"| node_recommended
node_store -->|"loads products"| node_hooks
node_adshook -->|"requests announcements"| node_services
node_offershook -->|"requests offers"| node_services
node_hooks -->|"requests products"| node_services
node_recommended -.->|"opens product"| node_product
node_product -->|"renders"| node_carousel
node_product -->|"adds cart item"| node_context
node_product -->|"shows confirmation"| node_modal
node_product -->|"navigates to"| node_cart
node_cart -->|"renders"| node_cartitem
node_cart -->|"renders"| node_summary
node_cart -->|"reads cart"| node_context
node_summary -->|"reads cart"| node_context
node_summary -->|"renders"| node_modal
node_summary -->|"uses template"| node_invoice
node_context -->|"loads and persists"| node_local
node_tabs -->|"reads cart count"| node_context

click node_app "https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/App.js"
click node_stack "https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/rotas/StackRotas.js"
click node_tabs "https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/rotas/TabRotas.js"
click node_welcome "https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/TelaInicial/index.js"
click node_signin "https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/SignIn/index.js"
click node_home "https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/Home/index.js"
click node_ads "https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/Home/componentes/Anuncios.js"
click node_offers "https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/Home/componentes/Ofertas.js"
click node_store "https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/Loja/index.js"
click node_recommended "https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/Loja/componentes/ItensRecomendados.js"
click node_product "https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/Produto/index.js"
click node_carousel "https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/Produto/componentes/Carrossel.js"
click node_cart "https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/Carrinho/index.js"
click node_cartitem "https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/Carrinho/componentes/Item.js"
click node_summary "https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/Carrinho/componentes/ResumoCompra.js"
click node_modal "https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/componentes/CompraModal.js"
click node_invoice "https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/templates/NotaFiscal.js"
click node_context "https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/contextos/GlobalContext.js"
click node_local "https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/local/index.js"
click node_hooks "https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/hooks/useProdutos.js"
click node_adshook "https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/hooks/useAnuncios.js"
click node_offershook "https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/hooks/useOfertas.js"
click node_services "https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/servicos/index.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_app,node_stack,node_tabs,node_welcome,node_signin toneBlue
class node_home,node_ads,node_offers,node_store,node_recommended,node_asyncstorage toneAmber
class node_product,node_carousel,node_cart,node_cartitem,node_summary,node_modal,node_invoice toneMint
class node_context,node_local,node_hooks,node_adshook,node_offershook,node_services toneRose
class node_shopper toneIndigo
```

## Components

### App and navigation

- [App shell](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/App.js): `ecommerce-app-expo/App.js`
- [Stack navigation](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/rotas/StackRotas.js): `ecommerce-app-expo/src/rotas/StackRotas.js`
- [Tab navigation](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/rotas/TabRotas.js): `ecommerce-app-expo/src/rotas/TabRotas.js`
- [Welcome screen](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/TelaInicial/index.js): `ecommerce-app-expo/src/telas/TelaInicial/index.js`
- [Sign-in screen](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/SignIn/index.js): `ecommerce-app-expo/src/telas/SignIn/index.js`

### Shopping discovery

- [Home screen](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/Home/index.js): `ecommerce-app-expo/src/telas/Home/index.js`
- [Announcements](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/Home/componentes/Anuncios.js): `ecommerce-app-expo/src/telas/Home/componentes/Anuncios.js`
- [Offers section](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/Home/componentes/Ofertas.js): `ecommerce-app-expo/src/telas/Home/componentes/Ofertas.js`
- [Store screen](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/Loja/index.js): `ecommerce-app-expo/src/telas/Loja/index.js`
- [Recommended items](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/Loja/componentes/ItensRecomendados.js): `ecommerce-app-expo/src/telas/Loja/componentes/ItensRecomendados.js`

### Product and checkout

- [Product screen](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/Produto/index.js): `ecommerce-app-expo/src/telas/Produto/index.js`
- [Product carousel](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/Produto/componentes/Carrossel.js): `ecommerce-app-expo/src/telas/Produto/componentes/Carrossel.js`
- [Cart screen](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/Carrinho/index.js): `ecommerce-app-expo/src/telas/Carrinho/index.js`
- [Cart item](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/Carrinho/componentes/Item.js): `ecommerce-app-expo/src/telas/Carrinho/componentes/Item.js`
- [Purchase summary](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/telas/Carrinho/componentes/ResumoCompra.js): `ecommerce-app-expo/src/telas/Carrinho/componentes/ResumoCompra.js`
- [Purchase modal](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/componentes/CompraModal.js): `ecommerce-app-expo/src/componentes/CompraModal.js`
- [Invoice template](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/templates/NotaFiscal.js): `ecommerce-app-expo/src/templates/NotaFiscal.js`

### Data and persistence

- [Cart context](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/contextos/GlobalContext.js): `ecommerce-app-expo/src/contextos/GlobalContext.js`
- [Local cart storage](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/local/index.js): `ecommerce-app-expo/src/local/index.js`
- [Catalog hooks](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/hooks/useProdutos.js): `ecommerce-app-expo/src/hooks/useProdutos.js`
- [Announcement hook](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/hooks/useAnuncios.js): `ecommerce-app-expo/src/hooks/useAnuncios.js`
- [Offers hook](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/hooks/useOfertas.js): `ecommerce-app-expo/src/hooks/useOfertas.js`
- [Catalog services](https://github.com/joaoferreirape/mobile-apps-react-native/blob/main/ecommerce-app-expo/src/servicos/index.js): `ecommerce-app-expo/src/servicos/index.js`

### Other components

- **Shopper**
- **AsyncStorage**

## Connections

- Shopper → Welcome screen: opens app
- App shell → Stack navigation: renders (evidence: `ecommerce-app-expo/App.js`)
- Stack navigation → Welcome screen: routes to (evidence: `ecommerce-app-expo/src/rotas/StackRotas.js`)
- Stack navigation → Sign-in screen: routes to (evidence: `ecommerce-app-expo/src/rotas/StackRotas.js`)
- Stack navigation → Tab navigation: routes to (evidence: `ecommerce-app-expo/src/rotas/StackRotas.js`)
- Stack navigation → Product screen: routes to (evidence: `ecommerce-app-expo/src/rotas/StackRotas.js`)
- Welcome screen → Sign-in screen: navigates to (evidence: `ecommerce-app-expo/src/telas/TelaInicial/index.js`)
- Sign-in screen → Tab navigation: navigates to (evidence: `ecommerce-app-expo/src/telas/SignIn/index.js`)
- Sign-in screen → AsyncStorage: saves user (evidence: `ecommerce-app-expo/src/telas/SignIn/index.js`)
- Tab navigation → Home screen: hosts (evidence: `ecommerce-app-expo/src/rotas/TabRotas.js`)
- Tab navigation → Store screen: hosts (evidence: `ecommerce-app-expo/src/rotas/TabRotas.js`)
- Tab navigation → Cart screen: hosts (evidence: `ecommerce-app-expo/src/rotas/TabRotas.js`)
- Home screen → Announcements: renders (evidence: `ecommerce-app-expo/src/telas/Home/index.js`)
- Home screen → Offers section: renders (evidence: `ecommerce-app-expo/src/telas/Home/index.js`)
- Home screen → Announcement hook: loads announcements (evidence: `ecommerce-app-expo/src/telas/Home/index.js`)
- Home screen → Offers hook: loads offers (evidence: `ecommerce-app-expo/src/telas/Home/index.js`)
- Store screen → Recommended items: renders (evidence: `ecommerce-app-expo/src/telas/Loja/index.js`)
- Store screen → Catalog hooks: loads products (evidence: `ecommerce-app-expo/src/telas/Loja/index.js`)
- Announcement hook → Catalog services: requests announcements (evidence: `ecommerce-app-expo/src/hooks/useAnuncios.js`)
- Offers hook → Catalog services: requests offers (evidence: `ecommerce-app-expo/src/hooks/useOfertas.js`)
- Catalog hooks → Catalog services: requests products (evidence: `ecommerce-app-expo/src/hooks/useProdutos.js`)
- Recommended items → Product screen: opens product
- Product screen → Product carousel: renders (evidence: `ecommerce-app-expo/src/telas/Produto/index.js`)
- Product screen → Cart context: adds cart item (evidence: `ecommerce-app-expo/src/telas/Produto/index.js`)
- Product screen → Purchase modal: shows confirmation (evidence: `ecommerce-app-expo/src/telas/Produto/index.js`)
- Product screen → Cart screen: navigates to (evidence: `ecommerce-app-expo/src/telas/Produto/index.js`)
- Cart screen → Cart item: renders (evidence: `ecommerce-app-expo/src/telas/Carrinho/index.js`)
- Cart screen → Purchase summary: renders (evidence: `ecommerce-app-expo/src/telas/Carrinho/index.js`)
- Cart screen → Cart context: reads cart (evidence: `ecommerce-app-expo/src/telas/Carrinho/index.js`)
- Purchase summary → Cart context: reads cart (evidence: `ecommerce-app-expo/src/telas/Carrinho/componentes/ResumoCompra.js`)
- Purchase summary → Purchase modal: renders (evidence: `ecommerce-app-expo/src/telas/Carrinho/componentes/ResumoCompra.js`)
- Purchase summary → Invoice template: uses template (evidence: `ecommerce-app-expo/src/telas/Carrinho/componentes/ResumoCompra.js`)
- Cart context → Local cart storage: loads and persists (evidence: `ecommerce-app-expo/src/contextos/GlobalContext.js`)
- Tab navigation → Cart context: reads cart count (evidence: `ecommerce-app-expo/src/rotas/TabRotas.js`)
