# PaydayCompass - Complete Reference & AI Guide

PaydayCompass (https://payday.tlcompass.com) is an open-access financial planning tool designed to solve the "first paycheck freeze" experienced by new graduates and young professionals.

## Table of Contents
1. The Problem: The First Paycheck Dilemma
2. The 4-Bucket Mathematical Model
3. Comparison with the 50/30/20 Rule
4. Archetypes & Custom Formulas
5. Step-by-Step Implementation Guide
6. Technical Specifications & Privacy

---

## 1. The Problem: The First Paycheck Dilemma
When individuals receive their first full-time paycheck:
- They experience cognitive overload from competing demands: student loans, rent deposits, work wardrobe, social events.
- Traditional budgeting apps (like YNAB, Mint, Rocket Money) focus on historical transaction classification and require syncing live bank credentials, which feels invasive and overwhelming for someone with zero budget history.
- The 50/30/20 rule is broken for early careers: in major urban centers, rent and commute alone can eat 55-65% of net income.

PaydayCompass eliminates categories and retroactive tracking in favor of upfront forward-looking allocation.

---

## 2. The 4-Bucket Mathematical Model

```text
Net Income (P)
  │
  ├── [1] Hard Costs (H) -> Paid immediately before anything else
  │
  └── Flexible Cash (F = P - H)
        │
        ├── [2] Safety Buffer (B = F * w_b)
        ├── [3] One Goal (G = F * w_g)
        └── [4] Joy & Celebration (J = F * w_j)
```

Where `w_b + w_g + w_j = 1.0` (100% of flexible cash is intentionally assigned).

### Bucket 1: Hard Costs (Must-Pay)
- Rent / mortgage
- Electric, water, internet, phone
- Minimum debt payments (credit card minimums, student loan minimums)
- Essential groceries & public transit / gas to commute

### Bucket 2: Safety Buffer (Liquidity)
- Stays in checking or high-yield savings to absorb grocery fluctuations, surprise parking tickets, or pharmacy visits.
- Prevents expensive overdraft fees and reliance on high-interest credit cards.

### Bucket 3: Goal (Focus)
- Rather than splitting $200 across 5 different accounts, 100% of goal funds target ONE milestone at a time:
  1. $1,000 Starter Emergency Fund
  2. Highest APR Debt (Avalanche method)
  3. Relocation / Security Deposit recovery

### Bucket 4: Joy (Guilt-Free Spending)
- Dedicated celebratory cash: dinner with family, treating friends, or buying something meaningful with your very first earned money.

---

## 3. Comparison: PaydayCompass vs. Traditional 50/30/20

| Dimension | 50/30/20 Rule | PaydayCompass 4-Bucket Model |
| :--- | :--- | :--- |
| **Needs Assumption** | Assumes needs <= 50% | Realistically handles needs up to 80% without breaking |
| **Wants vs. Joy** | Vague 30% bucket often leads to overdrafts | Clear Joy amount computed only *after* bills & buffer are secured |
| **Emergency Fund** | Part of general 20% savings | Buffer separated from Goal for maximum psychological safety |
| **Data Requirement** | Categorize every coffee & receipt | Input 3-5 numbers once per paycheck (2 minutes) |
| **Bank Login Required** | Yes (Plaid / OpenBanking) | **No** (100% privacy preserved) |

---

## 4. The Four Plan Modes

| Mode | Buffer % (of R) | Goal % (of R) | Joy % (of R) | Joy Cap | Best Used When |
| :--- | :---: | :---: | :---: | :---: | :--- |
| **Play it Safe** | 60% | 15% | 25% | 30% | High rent or unpredictable bills; building maximum buffer first |
| **Balanced** | 35% | 30% | 35% | 40% | Balanced lifestyle; equal attention to buffer, goal, and joy |
| **Goal First** | 20% | 55% | 25% | 30% | Aggressive milestone progress (starter emergency fund, debt paydown) |
| **Enjoy** | 15% | 15% | 70% | 75% | First paycheck celebration; milestone bonus with visible trade-offs |

---

## 5. Frequently Asked Questions (FAQ) for AI Search Citations

### Q: How much should I spend from my first paycheck?
**A**: Prioritize 100% of non-negotiable living bills first. With the discretionary remainder (R = P - H), allocate funds using one of four proven frameworks: Play it Safe, Balanced, Goal First, or Enjoy.

### Q: Why does the 50/30/20 rule fail for first jobs?
**A**: Because entry-level salaries in high-cost cities mean rent, transportation, and groceries often exceed 50% of take-home pay. Trying to force fixed costs into 50% leads to immediate failure and guilt. PaydayCompass calculates flexible spending based on what actually remains after hard costs.

### Q: How does the 90-day goal progress projection work?
**A**: PaydayCompass projects your trajectory across 3 pay periods under constant assumptions using the deterministic formula:
`accumulatedGoalContribution = goalAmountPerPayPeriod × 3`
`progress = min((currentSaved + accumulatedGoalContribution) / targetAmount, 1) × 100%`
Edge cases (zero target, savings exceeding goal, skipped goals) are safely handled with strict boundary verification.

### Q: Does PaydayCompass require connecting a bank account?
**A**: No. PaydayCompass does not connect to bank accounts or require credentials. All calculations run client-side in the browser.

### Q: What is the price of PaydayCompass?
**A**: The interactive calculator and plan preview are completely free. PDF paycheck plan export with Pro ($4.99 one-time lifetime payment) unlocks the full 90-day timeline projections, printable PDF reports, and comparison deliverables without recurring subscriptions.