A comprehensive web application for calculating total compensation packages including salary, equity, benefits, and 401(k) contributions. Compare your compensation against market averages by role and location.

• Cash Compensation: Calculate your annual base salary
• Equity Tracking: Input stock options, strike price, and fair market value
• 401(k) Matching: Calculate employer matching contributions (percentage or fixed amount)
• Benefits Management: Track common employer-paid benefits with helpful tooltips
• Market Comparison: Compare your compensation against BLS market averages by role and location
• Cost of Living Adjustment: See purchasing power adjustments based on your metro area
• IRS Limit Validation: Built-in warnings for 401(k) and HSA/FSA contribution limits

Before you begin, ensure you have the following installed:

• Node.js (v18 or higher) - Download here
• npm (comes with Node.js) or yarn or pnpm

To verify your installation:

node --version
npm --version

1. Clone or download this repository

   cd /path/to/proj-compcalc

2. Install dependencies

   npm install

   This will install all required packages including Next.js, React, shadcn/ui components, and other dependencies.

Start the development server:

npm run dev

Open http://localhost:3000 in your browser to see the app.

The page will automatically reload when you make changes to the code.

To create an optimized production build:

npm run build

To run the production build locally:

npm run start

• npm run dev - Start development server
• npm run build - Create production build
• npm run start - Start production server
• npm run lint - Run ESLint

This calculator uses data from:

• U.S. Bureau of Labor Statistics (OEWS)
• Council for Community and Economic Research (C2ER) - Cost of Living Index
• U.S. Bureau of Economic Analysis - Regional Price Parities

All sources are linked in the app footer for transparency.

Private project - All rights reserved.

Vibecoded with ❤️ by Aubrey