$ stat ./projects/discorover.md

Title: DiscoRover.com

Date: 8/26/2025

Description: A comprehensive financial data visualization platform that provides insights into U.S. economic indicators, commodity prices, inflation trends, and housing market metrics. Built with Next.js and powered by Federal Reserve Economic Data (FRED) API integration.

(( Open on GitHub ))

Discorover

Live Demo: www.discorover.com

A comprehensive financial data visualization platform that provides insights into U.S. economic indicators, commodity prices, inflation trends, and housing market metrics. Built with Next.js and powered by Federal Reserve Economic Data (FRED) API integration.

šŸŽÆ Project Overview

Discorover transforms complex economic data into interactive, visually appealing charts and dashboards that help users understand financial trends over time. The platform showcases real-time and historical data across multiple economic domains, making it easier for people to track changes in prices, interest rates, and inflation.

✨ Key Features

šŸ“Š Economic Metrics Dashboard

  • National Debt Tracking: Real-time U.S. national debt data from Treasury Department
  • Interest Rates: Current mortgage rates, Fed Funds Rate, and SOFR
  • Interactive Charts: Dynamic visualizations with customizable time ranges

šŸ“ˆ Data Visualizations

  • Consumer Price Index (CPI): Historical inflation trends with custom date ranges
  • Commodity Prices: Track costs of everyday items (eggs, bacon, milk, bread, beef, coffee, gas, electricity, chicken) with both nominal and inflation-adjusted prices
  • Mortgage Rate Trends: 15-year and 30-year mortgage rate history with interactive filtering
  • Car Price Analysis: Automobile pricing trends over time

šŸ  Housing Market Tools

  • Home Affordability Calculator: Assess housing affordability based on income and market conditions
  • Mortgage Calculator: Calculate monthly payments and total interest costs

šŸ’” Inflation Analysis

  • Inflation Calculator: Convert historical prices to today's dollars
  • Real vs Nominal Comparisons: See the true impact of inflation on purchasing power

šŸ›  Technology Stack

  • Frontend: Next.js 15.5.0 with React 19.1.0
  • Styling: Tailwind CSS v4
  • Charts: Recharts for interactive data visualization
  • UI Components: Radix UI, Lucide React icons
  • TypeScript: Full type safety throughout the application
  • API Integration: RESTful APIs connecting to FRED and U.S. Treasury data sources

šŸ“ Project Structure

src/
ā”œā”€ā”€ app/
│   ā”œā”€ā”€ api/                    # API routes for data fetching
│   │   ā”œā”€ā”€ get-cpi/           # Consumer Price Index data
│   │   ā”œā”€ā”€ all-commodity-prices/ # Commodity price data
│   │   ā”œā”€ā”€ mtg-all/           # Mortgage rates
│   │   ā”œā”€ā”€ fedfunds/          # Federal Funds Rate
│   │   ā”œā”€ā”€ usdebt/            # National debt data
│   │   └── sofr/              # Secured Overnight Financing Rate
│   ā”œā”€ā”€ commodity-prices/       # Commodity prices page
│   ā”œā”€ā”€ mortgage/               # Mortgage tools page
│   ā”œā”€ā”€ inflation-calc/         # Inflation calculator page
│   ā”œā”€ā”€ home-affordability/     # Housing affordability page
│   └── car-prices/            # Car prices analysis page
ā”œā”€ā”€ components/
│   ā”œā”€ā”€ CpiChart.tsx           # CPI visualization
│   ā”œā”€ā”€ CommodityPrices.tsx    # Commodity price charts
│   ā”œā”€ā”€ MtgRatesChart.tsx      # Mortgage rate trends
│   ā”œā”€ā”€ UsMetrics.tsx          # Economic metrics dashboard
│   ā”œā”€ā”€ MortgageCalc.tsx       # Mortgage calculator
│   ā”œā”€ā”€ ScaleForInflation.tsx # Inflation adjustment tool
│   └── Affordability.tsx      # Home affordability calculator
└── content/                   # Markdown content for documentation

šŸš€ Getting Started

Prerequisites

  • Node.js 18+
  • npm or yarn

Installation

  1. Clone the repository:
git clone https://github.com/your-username/discorover.git
cd discorover
  1. Install dependencies:
npm install
  1. Run the development server:
npm run dev
  1. Open http://localhost:3000 in your browser.

Build for Production

npm run build
npm start

šŸ“Š Data Sources

The application integrates with multiple authoritative data sources:

  • Federal Reserve Economic Data (FRED): Comprehensive economic time series data
  • U.S. Treasury Department: National debt and fiscal data
  • Bureau of Labor Statistics: Consumer Price Index and inflation data
  • Federal Reserve Board: Interest rates and monetary policy indicators

šŸŽØ Design Features

  • Responsive Design: Optimized for desktop, tablet, and mobile devices
  • Interactive Charts: Hover tooltips, zoom capabilities, and customizable time ranges
  • Real-time Updates: Fresh data fetched directly from source APIs
  • Accessibility: ARIA labels and semantic HTML for screen reader compatibility
  • Modern UI: Clean, professional interface with thoughtful color schemes

šŸ”§ API Architecture

The application uses Next.js API routes to create a backend-for-frontend architecture:

// Example API route structure
export async function GET() {
  try {
    const res = await fetch('https://api.fred.stlouisfed.org/fred/series/observations');
    const data = await res.json();
    return NextResponse.json(processData(data));
  } catch (error) {
    return NextResponse.json({ error: 'Failed to fetch data' }, { status: 500 });
  }
}

🌟 Key Highlights

  • Educational Value: Makes complex economic concepts accessible through visual storytelling
  • Real-time Data: Users see current economic conditions, not historical snapshots
  • Interactive Exploration: Users can dive deep into specific time periods and economic indicators
  • Practical Tools: Calculators help users make informed financial decisions
  • Performance Optimized: Efficient data fetching and rendering for smooth user experience

šŸ“± Use Cases

  • Financial Education: Students learning about economics and inflation
  • Investment Research: Investors analyzing market trends
  • Personal Finance: Individuals planning for major purchases or retirement
  • Economic Analysis: Researchers and analysts studying economic patterns
  • Real Estate Planning: Homebuyers assessing market conditions

šŸ”® Future Enhancements

  • Additional economic indicators and international data
  • Portfolio tracking and personal financial dashboards
  • Export functionality for charts and data
  • Historical comparison tools for different time periods
  • Mobile app development

šŸ“„ License

This project is private and proprietary. All rights reserved.


Note: This project is intended for educational and demonstration purposes. While it uses real economic data, it should not be used as the sole basis for financial decisions.

$ grep -r "related" ./projects/

Finding related projects...

$ cd .. && ./projects.sh

← Back to all projects