# abrahamisaiah129/thraxx architecture

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

- Interactive diagram: https://gitdiagram.com/abrahamisaiah129/thraxx
- Repository: https://github.com/abrahamisaiah129/thraxx

## Overview

Traxx is presented as fleet/logistics management software, with a Next.js site that explains the product, pricing, and onboarding, plus a dashboard area for operational views. A concrete backend workflow is CRM intake: the contact form’s API endpoint validates a submission, persists it as pending, attempts Zoho CRM synchronization, and exposes a retry endpoint for failed syncs. CRM persistence and integration calls are visible in the excerpts; most dashboard pages are placeholders in the sampled files, so their operational behavior is not established here.

Main entry points: [`traxx-web/src/app/api/crm/submit/route.ts`](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/api/crm/submit/route.ts) (CRM submit API), [`traxx-web/src/lib/zoho-client.ts`](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/lib/zoho-client.ts) (Zoho client), [`traxx-web/src/app/solutions/page.tsx`](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/solutions/page.tsx) (Solutions), [`traxx-web/src/app/pricing/page.tsx`](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/pricing/page.tsx) (Pricing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Public site"]
  node_home["Home<br/>[page.tsx]"]
  node_navbar["Site navigation<br/>[SiteNavbar.tsx]"]
  node_architecture["Platform architecture<br/>[page.tsx]"]
  node_blogs["Blogs<br/>[page.tsx]"]
  node_careers["Careers<br/>[page.tsx]"]
end

subgraph group_onboarding["Sales and onboarding"]
  node_solutions["Solutions<br/>[page.tsx]"]
  node_pricing["Pricing<br/>[page.tsx]"]
  node_registration["Registration<br/>[page.tsx]"]
  node_login["Login<br/>[page.tsx]"]
  node_contact["Contact form<br/>[page.tsx]"]
  node_cost_section["Cost comparison"]
  node_cta_section["Call to action<br/>[CTASection.tsx]"]
end

subgraph group_operations["Fleet dashboard"]
  node_dashboard["Operations dashboard"]
  node_live_map["Live map<br/>[page.tsx]"]
  node_assignments["Assignments<br/>[page.tsx]"]
  node_reports["Reports<br/>[page.tsx]"]
  node_riders["Rider management<br/>[page.tsx]"]
  node_shifts["Shifts<br/>[page.tsx]"]
  node_vendors["Vendors<br/>[page.tsx]"]
  node_ai["Traxx AI<br/>[page.tsx]"]
end

subgraph group_crm["CRM intake"]
  node_submit_api["CRM submit API<br/>[route.ts]"]
  node_retry_api["CRM retry API<br/>[route.ts]"]
end

subgraph group_integrations["External services"]
  node_firestore[("Firestore<br/>[firebase-admin.ts]")]
  node_zoho_client["Zoho client<br/>[zoho-client.ts]"]
  node_zoho["Zoho CRM"]
end

node_visitor(("Visitor"))

node_visitor -.->|"visits"| node_home
node_solutions -->|"renders"| node_cost_section
node_solutions -->|"renders"| node_cta_section
node_pricing -->|"renders"| node_cost_section
node_pricing -->|"renders"| node_cta_section
node_contact -.->|"submits to"| node_submit_api
node_submit_api -->|"writes submission"| node_firestore
node_submit_api -->|"syncs records"| node_zoho_client
node_retry_api -->|"reads and updates"| node_firestore
node_retry_api -->|"retries sync"| node_zoho_client
node_zoho_client -->|"calls CRM API"| node_zoho

click node_home "https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/page.tsx"
click node_navbar "https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/components/layout/SiteNavbar.tsx"
click node_architecture "https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/architecture/page.tsx"
click node_blogs "https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/blogs/page.tsx"
click node_careers "https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/careers/page.tsx"
click node_solutions "https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/solutions/page.tsx"
click node_pricing "https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/pricing/page.tsx"
click node_registration "https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/register/page.tsx"
click node_login "https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/login/page.tsx"
click node_contact "https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/contact/page.tsx"
click node_cost_section "https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/components/landing/CostOfChaosSection.tsx"
click node_cta_section "https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/components/landing/CTASection.tsx"
click node_dashboard "https://github.com/abrahamisaiah129/thraxx/tree/main/traxx-web/src/app/dashboard"
click node_live_map "https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/dashboard/live-map/page.tsx"
click node_assignments "https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/dashboard/assignments/page.tsx"
click node_reports "https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/dashboard/reports/page.tsx"
click node_riders "https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/dashboard/riders/page.tsx"
click node_shifts "https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/dashboard/shifts/page.tsx"
click node_vendors "https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/dashboard/vendors/page.tsx"
click node_ai "https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/dashboard/traxx-ai/page.tsx"
click node_submit_api "https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/api/crm/submit/route.ts"
click node_retry_api "https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/api/crm/retry/route.ts"
click node_firestore "https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/lib/firebase-admin.ts"
click node_zoho_client "https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/lib/zoho-client.ts"

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_home,node_navbar,node_architecture,node_blogs,node_careers toneBlue
class node_solutions,node_pricing,node_registration,node_login,node_contact,node_cost_section,node_cta_section toneAmber
class node_dashboard,node_live_map,node_assignments,node_reports,node_riders,node_shifts,node_vendors,node_ai toneMint
class node_submit_api,node_retry_api toneRose
class node_firestore,node_zoho_client,node_zoho,node_visitor toneIndigo
```

## Components

### Public site

- [Home](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/page.tsx): `traxx-web/src/app/page.tsx`
- [Site navigation](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/components/layout/SiteNavbar.tsx): `traxx-web/src/components/layout/SiteNavbar.tsx`
- [Platform architecture](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/architecture/page.tsx): `traxx-web/src/app/architecture/page.tsx`
- [Blogs](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/blogs/page.tsx): `traxx-web/src/app/blogs/page.tsx`
- [Careers](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/careers/page.tsx): `traxx-web/src/app/careers/page.tsx`

### Sales and onboarding

- [Solutions](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/solutions/page.tsx): `traxx-web/src/app/solutions/page.tsx`
- [Pricing](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/pricing/page.tsx): `traxx-web/src/app/pricing/page.tsx`
- [Registration](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/register/page.tsx): `traxx-web/src/app/register/page.tsx`
- [Login](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/login/page.tsx): `traxx-web/src/app/login/page.tsx`
- [Contact form](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/contact/page.tsx): `traxx-web/src/app/contact/page.tsx`
- [Cost comparison](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/components/landing/CostOfChaosSection.tsx): `traxx-web/src/components/landing/CostOfChaosSection.tsx`
- [Call to action](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/components/landing/CTASection.tsx): `traxx-web/src/components/landing/CTASection.tsx`

### Fleet dashboard

- [Operations dashboard](https://github.com/abrahamisaiah129/thraxx/tree/main/traxx-web/src/app/dashboard): `traxx-web/src/app/dashboard`
- [Live map](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/dashboard/live-map/page.tsx): `traxx-web/src/app/dashboard/live-map/page.tsx`
- [Assignments](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/dashboard/assignments/page.tsx): `traxx-web/src/app/dashboard/assignments/page.tsx`
- [Reports](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/dashboard/reports/page.tsx): `traxx-web/src/app/dashboard/reports/page.tsx`
- [Rider management](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/dashboard/riders/page.tsx): `traxx-web/src/app/dashboard/riders/page.tsx`
- [Shifts](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/dashboard/shifts/page.tsx): `traxx-web/src/app/dashboard/shifts/page.tsx`
- [Vendors](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/dashboard/vendors/page.tsx): `traxx-web/src/app/dashboard/vendors/page.tsx`
- [Traxx AI](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/dashboard/traxx-ai/page.tsx): `traxx-web/src/app/dashboard/traxx-ai/page.tsx`

### CRM intake

- [CRM submit API](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/api/crm/submit/route.ts): `traxx-web/src/app/api/crm/submit/route.ts`
- [CRM retry API](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/app/api/crm/retry/route.ts): `traxx-web/src/app/api/crm/retry/route.ts`

### External services

- [Firestore](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/lib/firebase-admin.ts): `traxx-web/src/lib/firebase-admin.ts`
- [Zoho client](https://github.com/abrahamisaiah129/thraxx/blob/main/traxx-web/src/lib/zoho-client.ts): `traxx-web/src/lib/zoho-client.ts`
- **Zoho CRM**

### Other components

- **Visitor**

## Connections

- Visitor → Home: visits
- Solutions → Cost comparison: renders (evidence: `traxx-web/src/app/solutions/page.tsx`)
- Solutions → Call to action: renders (evidence: `traxx-web/src/app/solutions/page.tsx`)
- Pricing → Cost comparison: renders (evidence: `traxx-web/src/app/pricing/page.tsx`)
- Pricing → Call to action: renders (evidence: `traxx-web/src/app/pricing/page.tsx`)
- Contact form → CRM submit API: submits to
- CRM submit API → Firestore: writes submission (evidence: `traxx-web/src/app/api/crm/submit/route.ts`)
- CRM submit API → Zoho client: syncs records (evidence: `traxx-web/src/app/api/crm/submit/route.ts`)
- CRM retry API → Firestore: reads and updates (evidence: `traxx-web/src/app/api/crm/retry/route.ts`)
- CRM retry API → Zoho client: retries sync (evidence: `traxx-web/src/app/api/crm/retry/route.ts`)
- Zoho client → Zoho CRM: calls CRM API (evidence: `traxx-web/src/lib/zoho-client.ts`)
