# yash2007-jpg/opslyft-pricing-calculator architecture

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

- Interactive diagram: https://gitdiagram.com/yash2007-jpg/opslyft-pricing-calculator
- Repository: https://github.com/yash2007-jpg/opslyft-pricing-calculator

## Overview

Opslyft is a sample-data AWS EC2 cost calculator. Users browse and filter instances, inspect a candidate, then compare costs, calculate spend, or explore cheaper instance and commitment alternatives. The source index identifies the main `src/` app wiring and a separate `nextjs/` copy; this map follows `src/`, whose page and feature-module references are indexed. Pricing is explicitly illustrative. The instances API and Supabase helper exist, but the excerpts do not establish their data flow or whether they replace the sample catalog.

Main entry points: [`src/components/CloudCalculatorApp.tsx`](https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/components/CloudCalculatorApp.tsx) (App coordinator), [`src/lib/pricing.ts`](https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/lib/pricing.ts) (Pricing calculations), [`src/data/catalog.ts`](https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/data/catalog.ts) (Instance catalog), [`src/components/explorer/InstanceExplorer.tsx`](https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/components/explorer/InstanceExplorer.tsx) (Instance explorer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_page["App page<br/>[page.tsx]"]
  node_app["App coordinator"]
  node_site["Site chrome<br/>[SiteChrome.tsx]"]
  node_landing["Landing<br/>[Landing.tsx]"]
  node_ui["Shared UI components"]
end

subgraph group_discovery["Instance discovery"]
  node_explorer["Instance explorer"]
  node_detail["Instance detail"]
  node_explorerlogic["Filter and sort logic<br/>[explorer.ts]"]
end

subgraph group_cost["Cost analysis"]
  node_compare["Comparison view<br/>[ComparisonView.tsx]"]
  node_table["Comparison table"]
  node_calculator["Cost calculator<br/>[CostCalculator.tsx]"]
  node_optimize["Optimization view"]
  node_recommendations["Recommendations<br/>[recommendations.ts]"]
end

subgraph group_data["Pricing and data"]
  node_catalog["Instance catalog<br/>[catalog.ts]"]
  node_pricing["Pricing calculations<br/>[pricing.ts]"]
  node_api["Instances API<br/>[route.ts]"]
  node_supabase["Supabase helper<br/>[supabase.ts]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_page
node_page -->|"renders"| node_app
node_app -->|"renders"| node_site
node_app -->|"renders"| node_landing
node_app -->|"renders"| node_explorer
node_app -->|"renders"| node_detail
node_app -->|"renders"| node_compare
node_app -->|"renders"| node_calculator
node_app -->|"renders"| node_optimize
node_explorer -->|"filters and sorts"| node_explorerlogic
node_explorer -->|"reads instances"| node_catalog
node_explorer -->|"prices instances"| node_pricing
node_detail -->|"reads instance data"| node_catalog
node_detail -->|"calculates cost"| node_pricing
node_compare -->|"renders"| node_table
node_compare -->|"prices instances"| node_pricing
node_calculator -->|"reads instances"| node_catalog
node_calculator -->|"calculates cost"| node_pricing
node_optimize -->|"requests alternatives"| node_recommendations
node_recommendations -->|"examines candidates"| node_catalog
node_recommendations -->|"compares prices"| node_pricing
node_pricing -->|"uses rates and models"| node_catalog
node_api -->|"uses helper"| node_supabase

click node_page "https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/app/page.tsx"
click node_app "https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/components/CloudCalculatorApp.tsx"
click node_site "https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/components/layout/SiteChrome.tsx"
click node_landing "https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/components/landing/Landing.tsx"
click node_explorer "https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/components/explorer/InstanceExplorer.tsx"
click node_detail "https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/components/detail/InstanceDetailDrawer.tsx"
click node_catalog "https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/data/catalog.ts"
click node_explorerlogic "https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/lib/explorer.ts"
click node_compare "https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/components/compare/ComparisonView.tsx"
click node_table "https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/components/compare/ComparisonTable.tsx"
click node_calculator "https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/components/calculator/CostCalculator.tsx"
click node_optimize "https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/components/optimize/OptimizationView.tsx"
click node_recommendations "https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/lib/recommendations.ts"
click node_pricing "https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/lib/pricing.ts"
click node_api "https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/app/api/instances/route.ts"
click node_supabase "https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/lib/supabase.ts"
click node_ui "https://github.com/yash2007-jpg/opslyft-pricing-calculator/tree/main/src/components/ui"

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_page,node_app,node_site,node_landing,node_ui toneBlue
class node_explorer,node_detail,node_explorerlogic toneAmber
class node_compare,node_table,node_calculator,node_optimize,node_recommendations toneMint
class node_catalog,node_pricing,node_api,node_supabase toneRose
class node_visitor toneIndigo
```

## Components

### App experience

- [App page](https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [App coordinator](https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/components/CloudCalculatorApp.tsx): `src/components/CloudCalculatorApp.tsx`
- [Site chrome](https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/components/layout/SiteChrome.tsx): `src/components/layout/SiteChrome.tsx`
- [Landing](https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/components/landing/Landing.tsx): `src/components/landing/Landing.tsx`
- [Shared UI components](https://github.com/yash2007-jpg/opslyft-pricing-calculator/tree/main/src/components/ui): `src/components/ui`

### Instance discovery

- [Instance explorer](https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/components/explorer/InstanceExplorer.tsx): `src/components/explorer/InstanceExplorer.tsx`
- [Instance detail](https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/components/detail/InstanceDetailDrawer.tsx): `src/components/detail/InstanceDetailDrawer.tsx`
- [Filter and sort logic](https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/lib/explorer.ts): `src/lib/explorer.ts`

### Cost analysis

- [Comparison view](https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/components/compare/ComparisonView.tsx): `src/components/compare/ComparisonView.tsx`
- [Comparison table](https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/components/compare/ComparisonTable.tsx): `src/components/compare/ComparisonTable.tsx`
- [Cost calculator](https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/components/calculator/CostCalculator.tsx): `src/components/calculator/CostCalculator.tsx`
- [Optimization view](https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/components/optimize/OptimizationView.tsx): `src/components/optimize/OptimizationView.tsx`
- [Recommendations](https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/lib/recommendations.ts): `src/lib/recommendations.ts`

### Pricing and data

- [Instance catalog](https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/data/catalog.ts): `src/data/catalog.ts`
- [Pricing calculations](https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/lib/pricing.ts): `src/lib/pricing.ts`
- [Instances API](https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/app/api/instances/route.ts): `src/app/api/instances/route.ts`
- [Supabase helper](https://github.com/yash2007-jpg/opslyft-pricing-calculator/blob/main/src/lib/supabase.ts): `src/lib/supabase.ts`

### Other components

- **Visitor**

## Connections

- Visitor → App page: opens (evidence: `src/app/page.tsx`)
- App page → App coordinator: renders (evidence: `src/app/page.tsx`)
- App coordinator → Site chrome: renders (evidence: `src/components/CloudCalculatorApp.tsx`)
- App coordinator → Landing: renders (evidence: `src/components/CloudCalculatorApp.tsx`)
- App coordinator → Instance explorer: renders (evidence: `src/components/CloudCalculatorApp.tsx`)
- App coordinator → Instance detail: renders (evidence: `src/components/CloudCalculatorApp.tsx`)
- App coordinator → Comparison view: renders (evidence: `src/components/CloudCalculatorApp.tsx`)
- App coordinator → Cost calculator: renders (evidence: `src/components/CloudCalculatorApp.tsx`)
- App coordinator → Optimization view: renders (evidence: `src/components/CloudCalculatorApp.tsx`)
- Instance explorer → Filter and sort logic: filters and sorts (evidence: `src/components/explorer/InstanceExplorer.tsx`)
- Instance explorer → Instance catalog: reads instances (evidence: `src/components/explorer/InstanceExplorer.tsx`)
- Instance explorer → Pricing calculations: prices instances (evidence: `src/components/explorer/InstanceExplorer.tsx`)
- Instance detail → Instance catalog: reads instance data (evidence: `src/components/detail/InstanceDetailDrawer.tsx`)
- Instance detail → Pricing calculations: calculates cost (evidence: `src/components/detail/InstanceDetailDrawer.tsx`)
- Comparison view → Comparison table: renders (evidence: `src/components/compare/ComparisonView.tsx`)
- Comparison view → Pricing calculations: prices instances (evidence: `src/components/compare/ComparisonView.tsx`)
- Cost calculator → Instance catalog: reads instances (evidence: `src/components/calculator/CostCalculator.tsx`)
- Cost calculator → Pricing calculations: calculates cost (evidence: `src/components/calculator/CostCalculator.tsx`)
- Optimization view → Recommendations: requests alternatives (evidence: `src/components/optimize/OptimizationView.tsx`)
- Recommendations → Instance catalog: examines candidates (evidence: `src/lib/recommendations.ts`)
- Recommendations → Pricing calculations: compares prices (evidence: `src/lib/recommendations.ts`)
- Pricing calculations → Instance catalog: uses rates and models (evidence: `src/lib/pricing.ts`)
- Instances API → Supabase helper: uses helper (evidence: `src/app/api/instances/route.ts`)
