# tjnutricost/nc-tracker-app architecture

> Architecture diagram of the GitHub repository tjnutricost/nc-tracker-app, 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/tjnutricost/nc-tracker-app
- Repository: https://github.com/tjnutricost/nc-tracker-app

## Overview

NC Tracker is a browser-based Nutricost project and sales-performance tracker. Users enter through the routed React application and navigate to a dashboard, project management, project performance data, page analytics, storewide daily comparisons, or settings. The pages display and, in Projects, locally edit in-memory mock data; Project Data also exports CSV. Shared layout, status badges, data types, and formatting utilities support the screens. The README describes only a React/Vite template; source evidence shows mock-data behavior, not a live Shopify connection or persistent backend.

Main entry points: [`src/App.tsx`](https://github.com/tjnutricost/nc-tracker-app/blob/main/src/App.tsx) (Route Application), [`src/data/mockData.ts`](https://github.com/tjnutricost/nc-tracker-app/blob/main/src/data/mockData.ts) (Mock Tracking Data), [`src/components/layout/TopBar.tsx`](https://github.com/tjnutricost/nc-tracker-app/blob/main/src/components/layout/TopBar.tsx) (Page Header), [`src/pages/Dashboard.tsx`](https://github.com/tjnutricost/nc-tracker-app/blob/main/src/pages/Dashboard.tsx) (Project Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application Shell"]
  node_entry["React Entry<br/>[main.tsx]"]
  node_router["Route Application<br/>[App.tsx]"]
  node_layout["Page Layout<br/>[Layout.tsx]"]
  node_sidebar["Navigation Sidebar<br/>[Sidebar.tsx]"]
end

subgraph group_tracking["Tracking Screens"]
  node_dashboard["Project Dashboard<br/>[Dashboard.tsx]"]
  node_projects["Project Management<br/>[Projects.tsx]"]
  node_projectdata["Project Data<br/>[ProjectData.tsx]"]
  node_analytics["Page Analytics<br/>[PageAnalytics.tsx]"]
  node_daily["Daily Store Trends<br/>[NutricostDaily.tsx]"]
  node_settings["Tracker Settings<br/>[Settings.tsx]"]
end

subgraph group_shared["Shared Runtime"]
  node_topbar["Page Header<br/>[TopBar.tsx]"]
  node_mockdata["Mock Tracking Data<br/>[mockData.ts]"]
  node_types["Domain Data Types<br/>[index.ts]"]
  node_formatters["Display Formatters<br/>[formatters.ts]"]
  node_status["Status Badges<br/>[StatusBadge.tsx]"]
end

node_user(("Tracker User"))

node_user -->|"opens app"| node_entry
node_entry -->|"renders"| node_router
node_router -->|"routes through"| node_layout
node_router -->|"routes to"| node_dashboard
node_router -->|"routes to"| node_projects
node_router -->|"routes to"| node_projectdata
node_router -->|"routes to"| node_analytics
node_router -->|"routes to"| node_daily
node_router -->|"routes to"| node_settings
node_layout -->|"renders"| node_sidebar
node_dashboard -->|"renders"| node_topbar
node_projects -->|"renders"| node_topbar
node_projectdata -->|"renders"| node_topbar
node_analytics -->|"renders"| node_topbar
node_daily -->|"renders"| node_topbar
node_settings -->|"renders"| node_topbar
node_dashboard -->|"reads"| node_mockdata
node_projects -->|"initializes from"| node_mockdata
node_projectdata -->|"reads"| node_mockdata
node_analytics -->|"reads"| node_mockdata
node_daily -->|"reads"| node_mockdata
node_settings -->|"reads"| node_mockdata
node_dashboard -->|"formats values"| node_formatters
node_projects -->|"formats dates"| node_formatters
node_projectdata -->|"formats values"| node_formatters
node_analytics -->|"formats values"| node_formatters
node_daily -->|"formats values"| node_formatters
node_dashboard -->|"renders"| node_status
node_projects -->|"renders"| node_status
node_mockdata -->|"types records"| node_types

click node_entry "https://github.com/tjnutricost/nc-tracker-app/blob/main/src/main.tsx"
click node_router "https://github.com/tjnutricost/nc-tracker-app/blob/main/src/App.tsx"
click node_layout "https://github.com/tjnutricost/nc-tracker-app/blob/main/src/components/layout/Layout.tsx"
click node_sidebar "https://github.com/tjnutricost/nc-tracker-app/blob/main/src/components/layout/Sidebar.tsx"
click node_topbar "https://github.com/tjnutricost/nc-tracker-app/blob/main/src/components/layout/TopBar.tsx"
click node_dashboard "https://github.com/tjnutricost/nc-tracker-app/blob/main/src/pages/Dashboard.tsx"
click node_projects "https://github.com/tjnutricost/nc-tracker-app/blob/main/src/pages/Projects.tsx"
click node_projectdata "https://github.com/tjnutricost/nc-tracker-app/blob/main/src/pages/ProjectData.tsx"
click node_analytics "https://github.com/tjnutricost/nc-tracker-app/blob/main/src/pages/PageAnalytics.tsx"
click node_daily "https://github.com/tjnutricost/nc-tracker-app/blob/main/src/pages/NutricostDaily.tsx"
click node_settings "https://github.com/tjnutricost/nc-tracker-app/blob/main/src/pages/Settings.tsx"
click node_mockdata "https://github.com/tjnutricost/nc-tracker-app/blob/main/src/data/mockData.ts"
click node_types "https://github.com/tjnutricost/nc-tracker-app/blob/main/src/types/index.ts"
click node_formatters "https://github.com/tjnutricost/nc-tracker-app/blob/main/src/utils/formatters.ts"
click node_status "https://github.com/tjnutricost/nc-tracker-app/blob/main/src/components/ui/StatusBadge.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_entry,node_router,node_layout,node_sidebar,node_user toneBlue
class node_dashboard,node_projects,node_projectdata,node_analytics,node_daily,node_settings toneAmber
class node_topbar,node_mockdata,node_types,node_formatters,node_status toneMint
```

## Components

### Application Shell

- [React Entry](https://github.com/tjnutricost/nc-tracker-app/blob/main/src/main.tsx): `src/main.tsx`
- [Route Application](https://github.com/tjnutricost/nc-tracker-app/blob/main/src/App.tsx): `src/App.tsx`
- [Page Layout](https://github.com/tjnutricost/nc-tracker-app/blob/main/src/components/layout/Layout.tsx): `src/components/layout/Layout.tsx`
- [Navigation Sidebar](https://github.com/tjnutricost/nc-tracker-app/blob/main/src/components/layout/Sidebar.tsx): `src/components/layout/Sidebar.tsx`

### Tracking Screens

- [Project Dashboard](https://github.com/tjnutricost/nc-tracker-app/blob/main/src/pages/Dashboard.tsx): `src/pages/Dashboard.tsx`
- [Project Management](https://github.com/tjnutricost/nc-tracker-app/blob/main/src/pages/Projects.tsx): `src/pages/Projects.tsx`
- [Project Data](https://github.com/tjnutricost/nc-tracker-app/blob/main/src/pages/ProjectData.tsx): `src/pages/ProjectData.tsx`
- [Page Analytics](https://github.com/tjnutricost/nc-tracker-app/blob/main/src/pages/PageAnalytics.tsx): `src/pages/PageAnalytics.tsx`
- [Daily Store Trends](https://github.com/tjnutricost/nc-tracker-app/blob/main/src/pages/NutricostDaily.tsx): `src/pages/NutricostDaily.tsx`
- [Tracker Settings](https://github.com/tjnutricost/nc-tracker-app/blob/main/src/pages/Settings.tsx): `src/pages/Settings.tsx`

### Shared Runtime

- [Page Header](https://github.com/tjnutricost/nc-tracker-app/blob/main/src/components/layout/TopBar.tsx): `src/components/layout/TopBar.tsx`
- [Mock Tracking Data](https://github.com/tjnutricost/nc-tracker-app/blob/main/src/data/mockData.ts): `src/data/mockData.ts`
- [Domain Data Types](https://github.com/tjnutricost/nc-tracker-app/blob/main/src/types/index.ts): `src/types/index.ts`
- [Display Formatters](https://github.com/tjnutricost/nc-tracker-app/blob/main/src/utils/formatters.ts): `src/utils/formatters.ts`
- [Status Badges](https://github.com/tjnutricost/nc-tracker-app/blob/main/src/components/ui/StatusBadge.tsx): `src/components/ui/StatusBadge.tsx`

### Other components

- **Tracker User**

## Connections

- Tracker User → React Entry: opens app (evidence: `src/main.tsx`)
- React Entry → Route Application: renders (evidence: `src/main.tsx`)
- Route Application → Page Layout: routes through (evidence: `src/App.tsx`)
- Route Application → Project Dashboard: routes to (evidence: `src/App.tsx`)
- Route Application → Project Management: routes to (evidence: `src/App.tsx`)
- Route Application → Project Data: routes to (evidence: `src/App.tsx`)
- Route Application → Page Analytics: routes to (evidence: `src/App.tsx`)
- Route Application → Daily Store Trends: routes to (evidence: `src/App.tsx`)
- Route Application → Tracker Settings: routes to (evidence: `src/App.tsx`)
- Page Layout → Navigation Sidebar: renders (evidence: `src/components/layout/Layout.tsx`)
- Project Dashboard → Page Header: renders (evidence: `src/pages/Dashboard.tsx`)
- Project Management → Page Header: renders (evidence: `src/pages/Projects.tsx`)
- Project Data → Page Header: renders (evidence: `src/pages/ProjectData.tsx`)
- Page Analytics → Page Header: renders (evidence: `src/pages/PageAnalytics.tsx`)
- Daily Store Trends → Page Header: renders (evidence: `src/pages/NutricostDaily.tsx`)
- Tracker Settings → Page Header: renders (evidence: `src/pages/Settings.tsx`)
- Project Dashboard → Mock Tracking Data: reads (evidence: `src/pages/Dashboard.tsx`)
- Project Management → Mock Tracking Data: initializes from (evidence: `src/pages/Projects.tsx`)
- Project Data → Mock Tracking Data: reads (evidence: `src/pages/ProjectData.tsx`)
- Page Analytics → Mock Tracking Data: reads (evidence: `src/pages/PageAnalytics.tsx`)
- Daily Store Trends → Mock Tracking Data: reads (evidence: `src/pages/NutricostDaily.tsx`)
- Tracker Settings → Mock Tracking Data: reads (evidence: `src/pages/Settings.tsx`)
- Project Dashboard → Display Formatters: formats values (evidence: `src/pages/Dashboard.tsx`)
- Project Management → Display Formatters: formats dates (evidence: `src/pages/Projects.tsx`)
- Project Data → Display Formatters: formats values (evidence: `src/pages/ProjectData.tsx`)
- Page Analytics → Display Formatters: formats values (evidence: `src/pages/PageAnalytics.tsx`)
- Daily Store Trends → Display Formatters: formats values (evidence: `src/pages/NutricostDaily.tsx`)
- Project Dashboard → Status Badges: renders (evidence: `src/pages/Dashboard.tsx`)
- Project Management → Status Badges: renders (evidence: `src/pages/Projects.tsx`)
- Mock Tracking Data → Domain Data Types: types records (evidence: `src/data/mockData.ts`)
