# mikee0102/tlaxgo architecture

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

- Interactive diagram: https://gitdiagram.com/mikee0102/tlaxgo
- Repository: https://github.com/mikee0102/tlaxgo

## Overview

Tlaxgo is a Tlaxcala tourism web app: visitors discover destinations and map them, while signed-in users can save places, plan itineraries, and manage profiles. The graph follows those user-facing stages into Firebase-backed services and includes the documented landing-page sections. Evidence is limited to the README, source index references, and sampled excerpts; unsampled integrations and call paths are omitted rather than assumed.

Main entry points: [`services/profile.service.ts`](https://github.com/mikee0102/tlaxgo/blob/main/services/profile.service.ts) (Profile and dashboard data), [`app/(marketing)/page.tsx`](https://github.com/mikee0102/tlaxgo/blob/main/app/(marketing)/page.tsx) (Marketing landing), [`lib/firebase/config.ts`](https://github.com/mikee0102/tlaxgo/blob/main/lib/firebase/config.ts) (Firebase services), [`app/(dashboard)/explore/page.tsx`](https://github.com/mikee0102/tlaxgo/blob/main/app/(dashboard)/explore/page.tsx) (Explore destinations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Tourism discovery"]
  node_marketing["Marketing landing<br/>[page.tsx]"]
  node_hero["Hero and features<br/>[Hero.tsx]"]
  node_places_marketing["Featured places<br/>[Lugares.tsx]"]
  node_routes_marketing["Tour routes<br/>[Rutas.tsx]"]
  node_municipalities["Municipality guide"]
  node_explore["Explore destinations<br/>[page.tsx]"]
  node_search_filters["Search and filters<br/>[SearchBar.tsx]"]
  node_place_card["Place details<br/>[PlaceCard.tsx]"]
  node_map_view["Destination map<br/>[Map.tsx]"]
end

subgraph group_accounts["Accounts and profiles"]
  node_auth_pages["Sign-in and registration<br/>[page.tsx]"]
  node_auth_hook["Auth actions<br/>[useAuth.ts]"]
  node_auth_provider["Session provider<br/>[auth-provider.tsx]"]
  node_auth_service["Credential service<br/>[auth.service.ts]"]
  node_profile_page["Profile management<br/>[page.tsx]"]
end

subgraph group_planning["Favorites and itineraries"]
  node_favorites_page["Saved places<br/>[page.tsx]"]
  node_favorites_service["Place favorites"]
  node_itinerary_page["Itinerary workspace<br/>[page.tsx]"]
  node_itinerary_form["Itinerary editor<br/>[intineraryform.tsx]"]
end

subgraph group_data["Data services"]
  node_places_service["Places lookup<br/>[places.service.ts]"]
  node_profile_service["Profile and dashboard data<br/>[profile.service.ts]"]
  node_itinerary_service["Itinerary records"]
  node_firebase[("Firebase services<br/>[config.ts]")]
end

subgraph group_presentation["Shared presentation"]
  node_dashboard["Dashboard<br/>[page.tsx]"]
  node_dashboard_widgets["Dashboard widgets<br/>[statscard.tsx]"]
end

node_visitor(("Visitor"))
node_overpass(("Overpass API"))

node_visitor -.->|"visits"| node_marketing
node_marketing -->|"renders"| node_hero
node_marketing -->|"renders"| node_places_marketing
node_marketing -->|"renders"| node_routes_marketing
node_marketing -->|"renders"| node_municipalities
node_explore -->|"renders"| node_search_filters
node_explore -->|"renders"| node_place_card
node_explore -->|"renders"| node_map_view
node_explore -->|"loads places"| node_places_service
node_places_service -->|"queries"| node_overpass
node_auth_pages -->|"uses"| node_auth_hook
node_auth_hook -->|"reads session"| node_auth_provider
node_auth_hook -->|"signs in"| node_firebase
node_auth_hook -->|"updates profile"| node_profile_service
node_auth_provider -->|"observes session"| node_firebase
node_auth_provider -->|"loads profile"| node_profile_service
node_auth_pages -->|"uses"| node_auth_service
node_auth_service -->|"auth operations"| node_firebase
node_profile_page -->|"loads profile"| node_profile_service
node_favorites_page -->|"loads favorites"| node_favorites_service
node_place_card -->|"updates favorite"| node_favorites_service
node_itinerary_page -->|"manages trips"| node_itinerary_service
node_itinerary_page -->|"renders editor"| node_itinerary_form
node_itinerary_form -->|"saves itinerary"| node_itinerary_service
node_itinerary_service -->|"reads and writes"| node_firebase
node_profile_service -->|"reads and writes"| node_firebase
node_profile_service -->|"loads favorites"| node_itinerary_service
node_dashboard -->|"loads dashboard data"| node_profile_service
node_dashboard -->|"renders stats"| node_dashboard_widgets

click node_marketing "https://github.com/mikee0102/tlaxgo/blob/main/app/(marketing)/page.tsx"
click node_hero "https://github.com/mikee0102/tlaxgo/blob/main/components/marketing/Hero.tsx"
click node_places_marketing "https://github.com/mikee0102/tlaxgo/blob/main/components/marketing/Lugares.tsx"
click node_routes_marketing "https://github.com/mikee0102/tlaxgo/blob/main/components/marketing/Rutas.tsx"
click node_municipalities "https://github.com/mikee0102/tlaxgo/blob/main/components/marketing/MunicipiosUnicos.tsx"
click node_explore "https://github.com/mikee0102/tlaxgo/blob/main/app/(dashboard)/explore/page.tsx"
click node_search_filters "https://github.com/mikee0102/tlaxgo/blob/main/components/map/SearchBar.tsx"
click node_place_card "https://github.com/mikee0102/tlaxgo/blob/main/components/map/PlaceCard.tsx"
click node_map_view "https://github.com/mikee0102/tlaxgo/blob/main/components/map/Map.tsx"
click node_places_service "https://github.com/mikee0102/tlaxgo/blob/main/services/places.service.ts"
click node_auth_pages "https://github.com/mikee0102/tlaxgo/blob/main/app/(auth)/login/page.tsx"
click node_auth_hook "https://github.com/mikee0102/tlaxgo/blob/main/hooks/useAuth.ts"
click node_auth_provider "https://github.com/mikee0102/tlaxgo/blob/main/providers/auth-provider.tsx"
click node_auth_service "https://github.com/mikee0102/tlaxgo/blob/main/services/auth.service.ts"
click node_profile_page "https://github.com/mikee0102/tlaxgo/blob/main/app/(dashboard)/profile/page.tsx"
click node_profile_service "https://github.com/mikee0102/tlaxgo/blob/main/services/profile.service.ts"
click node_favorites_page "https://github.com/mikee0102/tlaxgo/blob/main/app/(dashboard)/favorites/page.tsx"
click node_favorites_service "https://github.com/mikee0102/tlaxgo/blob/main/services/favorites.service.ts"
click node_itinerary_page "https://github.com/mikee0102/tlaxgo/blob/main/app/(dashboard)/itinerary/page.tsx"
click node_itinerary_form "https://github.com/mikee0102/tlaxgo/blob/main/components/intinerary/intineraryform.tsx"
click node_itinerary_service "https://github.com/mikee0102/tlaxgo/blob/main/services/itinerary.service.ts"
click node_firebase "https://github.com/mikee0102/tlaxgo/blob/main/lib/firebase/config.ts"
click node_dashboard "https://github.com/mikee0102/tlaxgo/blob/main/app/(dashboard)/dashboard/page.tsx"
click node_dashboard_widgets "https://github.com/mikee0102/tlaxgo/blob/main/components/dashborad/statscard.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_marketing,node_hero,node_places_marketing,node_routes_marketing,node_municipalities,node_explore,node_search_filters,node_place_card,node_map_view toneBlue
class node_auth_pages,node_auth_hook,node_auth_provider,node_auth_service,node_profile_page toneAmber
class node_favorites_page,node_favorites_service,node_itinerary_page,node_itinerary_form,node_overpass toneMint
class node_places_service,node_profile_service,node_itinerary_service,node_firebase toneRose
class node_dashboard,node_dashboard_widgets,node_visitor toneIndigo
```

## Components

### Tourism discovery

- [Marketing landing](https://github.com/mikee0102/tlaxgo/blob/main/app/(marketing)/page.tsx): `app/(marketing)/page.tsx`
- [Hero and features](https://github.com/mikee0102/tlaxgo/blob/main/components/marketing/Hero.tsx): `components/marketing/Hero.tsx`
- [Featured places](https://github.com/mikee0102/tlaxgo/blob/main/components/marketing/Lugares.tsx): `components/marketing/Lugares.tsx`
- [Tour routes](https://github.com/mikee0102/tlaxgo/blob/main/components/marketing/Rutas.tsx): `components/marketing/Rutas.tsx`
- [Municipality guide](https://github.com/mikee0102/tlaxgo/blob/main/components/marketing/MunicipiosUnicos.tsx): `components/marketing/MunicipiosUnicos.tsx`
- [Explore destinations](https://github.com/mikee0102/tlaxgo/blob/main/app/(dashboard)/explore/page.tsx): `app/(dashboard)/explore/page.tsx`
- [Search and filters](https://github.com/mikee0102/tlaxgo/blob/main/components/map/SearchBar.tsx): `components/map/SearchBar.tsx`
- [Place details](https://github.com/mikee0102/tlaxgo/blob/main/components/map/PlaceCard.tsx): `components/map/PlaceCard.tsx`
- [Destination map](https://github.com/mikee0102/tlaxgo/blob/main/components/map/Map.tsx): `components/map/Map.tsx`

### Accounts and profiles

- [Sign-in and registration](https://github.com/mikee0102/tlaxgo/blob/main/app/(auth)/login/page.tsx): `app/(auth)/login/page.tsx`
- [Auth actions](https://github.com/mikee0102/tlaxgo/blob/main/hooks/useAuth.ts): `hooks/useAuth.ts`
- [Session provider](https://github.com/mikee0102/tlaxgo/blob/main/providers/auth-provider.tsx): `providers/auth-provider.tsx`
- [Credential service](https://github.com/mikee0102/tlaxgo/blob/main/services/auth.service.ts): `services/auth.service.ts`
- [Profile management](https://github.com/mikee0102/tlaxgo/blob/main/app/(dashboard)/profile/page.tsx): `app/(dashboard)/profile/page.tsx`

### Favorites and itineraries

- [Saved places](https://github.com/mikee0102/tlaxgo/blob/main/app/(dashboard)/favorites/page.tsx): `app/(dashboard)/favorites/page.tsx`
- [Place favorites](https://github.com/mikee0102/tlaxgo/blob/main/services/favorites.service.ts): `services/favorites.service.ts`
- [Itinerary workspace](https://github.com/mikee0102/tlaxgo/blob/main/app/(dashboard)/itinerary/page.tsx): `app/(dashboard)/itinerary/page.tsx`
- [Itinerary editor](https://github.com/mikee0102/tlaxgo/blob/main/components/intinerary/intineraryform.tsx): `components/intinerary/intineraryform.tsx`

### Data services

- [Places lookup](https://github.com/mikee0102/tlaxgo/blob/main/services/places.service.ts): `services/places.service.ts`
- [Profile and dashboard data](https://github.com/mikee0102/tlaxgo/blob/main/services/profile.service.ts): `services/profile.service.ts`
- [Itinerary records](https://github.com/mikee0102/tlaxgo/blob/main/services/itinerary.service.ts): `services/itinerary.service.ts`
- [Firebase services](https://github.com/mikee0102/tlaxgo/blob/main/lib/firebase/config.ts): `lib/firebase/config.ts`

### Shared presentation

- [Dashboard](https://github.com/mikee0102/tlaxgo/blob/main/app/(dashboard)/dashboard/page.tsx): `app/(dashboard)/dashboard/page.tsx`
- [Dashboard widgets](https://github.com/mikee0102/tlaxgo/blob/main/components/dashborad/statscard.tsx): `components/dashborad/statscard.tsx`

### Other components

- **Visitor**
- **Overpass API**

## Connections

- Visitor → Marketing landing: visits
- Marketing landing → Hero and features: renders (evidence: `app/(marketing)/page.tsx`)
- Marketing landing → Featured places: renders (evidence: `app/(marketing)/page.tsx`)
- Marketing landing → Tour routes: renders (evidence: `app/(marketing)/page.tsx`)
- Marketing landing → Municipality guide: renders (evidence: `app/(marketing)/page.tsx`)
- Explore destinations → Search and filters: renders (evidence: `app/(dashboard)/explore/page.tsx`)
- Explore destinations → Place details: renders (evidence: `app/(dashboard)/explore/page.tsx`)
- Explore destinations → Destination map: renders (evidence: `app/(dashboard)/explore/page.tsx`)
- Explore destinations → Places lookup: loads places (evidence: `app/(dashboard)/explore/page.tsx`)
- Places lookup → Overpass API: queries (evidence: `services/places.service.ts`)
- Sign-in and registration → Auth actions: uses (evidence: `app/(auth)/login/page.tsx`)
- Auth actions → Session provider: reads session (evidence: `hooks/useAuth.ts`)
- Auth actions → Firebase services: signs in (evidence: `hooks/useAuth.ts`)
- Auth actions → Profile and dashboard data: updates profile (evidence: `hooks/useAuth.ts`)
- Session provider → Firebase services: observes session (evidence: `providers/auth-provider.tsx`)
- Session provider → Profile and dashboard data: loads profile (evidence: `providers/auth-provider.tsx`)
- Sign-in and registration → Credential service: uses
- Credential service → Firebase services: auth operations (evidence: `services/auth.service.ts`)
- Profile management → Profile and dashboard data: loads profile (evidence: `app/(dashboard)/profile/page.tsx`)
- Saved places → Place favorites: loads favorites (evidence: `app/(dashboard)/favorites/page.tsx`)
- Place details → Place favorites: updates favorite (evidence: `components/map/PlaceCard.tsx`)
- Itinerary workspace → Itinerary records: manages trips (evidence: `app/(dashboard)/itinerary/page.tsx`)
- Itinerary workspace → Itinerary editor: renders editor (evidence: `app/(dashboard)/itinerary/page.tsx`)
- Itinerary editor → Itinerary records: saves itinerary (evidence: `components/intinerary/intineraryform.tsx`)
- Itinerary records → Firebase services: reads and writes (evidence: `services/itinerary.service.ts`)
- Profile and dashboard data → Firebase services: reads and writes (evidence: `services/profile.service.ts`)
- Profile and dashboard data → Itinerary records: loads favorites (evidence: `services/profile.service.ts`)
- Dashboard → Profile and dashboard data: loads dashboard data (evidence: `app/(dashboard)/dashboard/page.tsx`)
- Dashboard → Dashboard widgets: renders stats (evidence: `app/(dashboard)/dashboard/page.tsx`)
