Commodities Refining Monitor

This application is a market-monitoring dashboard designed for commodities. It provides tools for tracking refining margins, crude benchmark curves, and product term structures in energy markets.

Key Features

• Overview Dashboard: Key performance indicators, day-over-day changes, historical percentiles, and market-state summaries.
• Crack Spreads Analysis: Multi-year historical overlays, statistical distribution rankings, and small-multiple charts for key energy products.
• Term Structure Monitor: Forward curves, calendar spreads, forward crack spreads, roll yields, and term-structure heatmaps.
• Data Integration: DuckDB-powered data processing for parquet analytics files from LSEG Refinitiv.

Screenshots

Overview

Crack Spreads

Forward Curves and Term Structure

Technology Stack

• Core Framework: Next.js with App Router
• Language: TypeScript
• Database: DuckDB (using @duckdb/node-api)
• UI Components: Tailwind CSS, shadcn/ui, Radix UI, and Phosphor Icons
• Data Visualization: Recharts

Getting Started

Prerequisites

Ensure you have Node.js and pnpm installed on your system.

Installation

Clone the repository and install dependencies:

pnpm install

Running the Application

To run the application locally in development mode:

pnpm dev

Open http://localhost:3000/dashboard in your browser to view the application.

Building for Production

To create an optimized production build:

pnpm build

To run the production server:

pnpm start