Clone
Start hereClone. git clone https://github.com/MrChartist/commodity-price-tracker.git && cd commodity-price-tracker
git clone https://github.com/MrChartist/commodity-price-tracker.gitOpen SourceCommodity Tracker
Commodity price engineVanilla HTML + JavaScript (45KB) + CSS (30KB) — zero dependencies, zero build step
Commodity Tracker.
Live India Commodity Price Tracker that computes real-time Import Landed Prices for Gold, Silver, Platinum, Crude Oil, Natural Gas, Copper, Aluminium, Zinc, Nickel & Lead. Purely client-side — fetches international benchmarks from Yahoo Finance CDN and Metals.live API via CORS proxies, applies USD/INR forex conversion and customs duty math (BCD + AIDC), and renders cards with TradingView Lightweight Charts.
What the README tells you
19 ⭐ | 10 forks | 3 commits | Live at commodity.mrchartist.com. The README documents 6 feature sections with screenshots, the core pricing formula (India Landed ₹ = Intl. Price ÷ Unit × USD/INR × (1 + Duty%)), complete data-flow architecture, deployment config (Vercel + any static host), and a SEBI compliance notice.
Features
What this repo gives you.
A quick practical feature map before you open the source code.
Precious Metals & Energy Dashboard — Price cards with international spot price + percentage change, India landed breakdown per-gram (24K/22K/18K Gold, 999/925/900 Silver), 10g & per-kg aggregates, retail contract equivalents (Gold Mini, Guinea, Petal), and visual BCD + AIDC duty badges.
Energy & Industrial Metals — Brent Crude & Natural Gas (NYMEX/ICE) with duty overlay, LME Base Metals (Copper, Aluminium, Zinc, Nickel, Lead) in ₹/kg, source attribution (Yahoo Finance / LME Approx).
Interactive COMEX Charts — TradingView Lightweight Charts with professional candlestick rendering, 7 timeframes (1M/3M/6M/1Y/5Y/10Y/Max), real COMEX futures historical data from Yahoo Finance.
Methodology Engine — Expandable panel explaining the full pricing pipeline: core formula, metal-specific breakdowns (Gold/Silver, Base Metals, Energy, Platinum), and compliance notice.
Documentation Hub (/docs.html) — 4-step visual pipeline walkthrough, duty rate matrix (complete BCD/AIDC table), purity formulas (24K→22K→18K conversion), data source cards.
Financial Glossary — 15-term glossary covering Landed Price, BCD, AIDC, COMEX, NYMEX, LME, Troy Ounce, Karat, Fineness, CAD, Windfall Tax, MMBtu, and more.
Installation
Step-by-Step Setup.
Follow these steps to get Commodity Tracker running on your machine.
Setup Path
Run it locally, then inspect the system.
Follow the README flow first. Once the app opens locally, use the AI prompts below to trace the data flow and make focused changes.
CloneInstallRunInspect
Install
Serve locally: npx serve . — opens on http://localhost:3000. No npm install, no build tools, no environment variables needed.
npm installStep 3
Deploy to Vercel: npx vercel --prod (zero-config, repo includes vercel.json with SPA rewrite rules).
Step 4
ProductionOr deploy to any static host (Netlify, Cloudflare Pages, GitHub Pages) — just drop the files.
AI-Powered Setup
Set Up Commodity Tracker With AI.
Pick your AI tool, copy the prompt, and let it handle the entire setup and codebase walkthrough for you.
Google Antigravity
Best when you want the assistant to operate inside the editor and handle setup end-to-end.
Desktop editorGitNode or PythonModel access
Ready-to-use prompt ↓
Open https://github.com/MrChartist/commodity-price-tracker. Clone the repository, inspect the README first, then set up the project locally using the exact setup steps from the README. Before editing anything, explain the stack, folder structure, data flow, required environment variables, and the safest first customization for this project: Serve locally with npx serve, then ask an AI to explain the pricing formula in app.js and the duty calculation logic before adding commodities.
How it works: Paste the prompt into Antigravity after choosing the repo. Ask it to read the README first, run setup commands, keep changes small, and explain every file it touches before editing.
OpenAI Codex
Best when you want command-by-command setup, debugging, code edits, and verification in a local workspace.
GitTerminalNode or PythonLocal workspace
Ready-to-use prompt ↓
I want to work on https://github.com/MrChartist/commodity-price-tracker. First read the README and summarize what the project does. Then give me the exact commands for my operating system to clone, install, configure environment variables, and run it locally. After it runs, inspect the codebase and propose one small change that matches this goal: Serve locally with npx serve, then ask an AI to explain the pricing formula in app.js and the duty calculation logic before adding commodities.
How it works: Paste the prompt into Codex with the repository URL. Ask it to run the project, identify the stack from files instead of guessing, make scoped edits, and verify with build or browser checks.
Claude
Best when you want architecture explanation, codebase understanding, and a clean implementation plan before edits.
Repo accessREADME contextTerminal if using Claude Code
Ready-to-use prompt ↓
Analyze https://github.com/MrChartist/commodity-price-tracker from the README and source structure. Create a clear architecture map, explain the main modules, identify setup risks, and recommend a safe implementation plan for extending it. Focus especially on: Ask the AI to trace the data flow: Yahoo Finance CDN → CORS Proxy → app.js (parse JSON, convert units oz→g/MT→kg, apply USD/INR forex, layer import duties BCD+AIDC) → render cards + charts. Ask it to explain the core pricing formula and how each metal type (precious/base/energy) applies different duty structures. Ask it to map the Metals.live API integration for LME base metals (Copper, Aluminium, Zinc, Nickel, Lead) as a secondary data source. Ask it to trace how TradingView Lightweight Charts renders COMEX historical data across 7 timeframes. Start with one focused change: add a new commodity (e.g., Tin, Lead), update a duty rate after budget changes, or add a new purity tier.
How it works: Paste the prompt with the GitHub link. Ask Claude to read the README, map modules, list risks, and produce a practical plan before using Claude Code or another agent to implement.
AI Focus
What to Ask the AI.
After setup, use these focused questions to get the most value from your AI assistant.
AI Briefing Mode
Ask for maps, not magic.
Use these prompts after the repo runs locally. The goal is to make the AI trace the system before it changes code.
FlowLogicRiskChange
Map the data flow
Ask the AI to trace the data flow: Yahoo Finance CDN → CORS Proxy → app.js (parse JSON, convert units oz→g/MT→kg, apply USD/INR forex, layer import duties BCD+AIDC) → render cards + charts.
Trace the logic
Ask it to explain the core pricing formula and how each metal type (precious/base/energy) applies different duty structures.
Prompt 3
Ask it to map the Metals.live API integration for LME base metals (Copper, Aluminium, Zinc, Nickel, Lead) as a secondary data source.
Prompt 4
Ask it to trace how TradingView Lightweight Charts renders COMEX historical data across 7 timeframes.
Make one focused change
Start with one focused change: add a new commodity (e.g., Tin, Lead), update a duty rate after budget changes, or add a new purity tier.
Best Next Step
Serve locally with npx serve, then ask an AI to explain the pricing formula in app.js and the duty calculation logic before adding commodities.