> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taxhomebase.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Get set up with TaxHomeBase in 5 steps.

Follow these steps to start protecting your tax-free stipends. The whole process takes about 10 minutes.

<Steps>
  <Step title="Create your account">
    Sign up at [app.taxhomebase.com](https://app.taxhomebase.com) using your email address. TaxHomeBase uses AWS Cognito for secure authentication — you'll verify your email and set a password.

    After signing in, you'll see the Dashboard with an onboarding checklist to guide you through setup.
  </Step>

  <Step title="Set up your tax home">
    Your tax home is the foundation of your tax-free stipend eligibility. Go to **Tax Home** and enter:

    * **Address** — Your permanent residence (where you maintain ties)
    * **Monthly rent** — What you pay to maintain the home (even while on assignment)
    * **Voter registration and driver's license state** — IRS documentation ties
    * **Last visit date** — The IRS expects regular visits (every 30 days recommended)

    <Frame caption="The Tax Home page shows your strength score, distance to assignments, and cost-benefit analysis.">
      <img src="https://mintcdn.com/stipendguard/rYTODjwsgR5TPzB9/images/quickstart/tax-home.png?fit=max&auto=format&n=rYTODjwsgR5TPzB9&q=85&s=da63f32ec41f0a59b0d9c6253b506b6d" alt="Tax Home page showing strength score, distance checks, and cost-benefit analysis" style={{ maxWidth: '300px' }} width="786" height="1680" data-path="images/quickstart/tax-home.png" />
    </Frame>

    TaxHomeBase evaluates five factors — rent payment, visit frequency, documentation ties, property status, and cost records — and gives you a strength rating of **Strong**, **Moderate**, or **At Risk**.

    The distance checker automatically verifies that each assignment is 50+ miles from your tax home, a common IRS threshold.

    <Tip>
      Upload supporting documents (lease agreements, utility bills) right away. These are your first line of defense in an audit.
    </Tip>
  </Step>

  <Step title="Add your first assignment">
    Go to **Assignments** and tap the **+** button. Enter your contract details:

    * Facility name, location, and state
    * Start and end dates
    * Base pay (weekly, pre-tax)
    * Housing and M\&IE stipends (weekly)
    * Any bonuses (sign-on, completion, referral)

    Once added, each assignment card shows GSA per diem compliance, housing adequacy vs. local rent, stipend defense status, and estimated net profit after taxes.

    <Tip>
      Have a contract PDF? Use **Scan Contract** to auto-extract all 12 fields using AI. Supports PDF, JPEG, and PNG files up to 10MB.
    </Tip>
  </Step>

  <Step title="Log an expense">
    Go to **Expenses** and add your first deductible expense. Common categories include:

    * **Travel** — Flights, gas, tolls to/from assignments
    * **Licensing** — State license fees, compact license costs
    * **CE Credits** — Continuing education courses
    * **Supplies** — Stethoscopes, scrubs, medical equipment

    <Frame caption="Track expenses with receipt scanning, categorization, and bulk CSV import.">
      <img src="https://mintcdn.com/stipendguard/rYTODjwsgR5TPzB9/images/quickstart/expenses.png?fit=max&auto=format&n=rYTODjwsgR5TPzB9&q=85&s=71fe7740f9b6d7e450a79ea3be5abcee" alt="Expenses page showing expense list with categories, amounts, and receipt attachments" style={{ maxWidth: '300px' }} width="786" height="1680" data-path="images/quickstart/expenses.png" />
    </Frame>

    You can also scan a receipt photo to auto-fill the amount, date, and vendor, or import expenses in bulk from a CSV file. Attach receipt images for IRS substantiation — expenses over \$75 and all lodging require receipts.
  </Step>

  <Step title="Check your Dashboard">
    Return to the **Dashboard** to see your status:

    * **Stipend Protection Banner** — Shows your YTD tax-free stipends and audit readiness score (X/11 criteria met)
    * **Action Items** — Compliance alerts that need your attention (overdue visits, missing docs, GSA exceedances)
    * **Visit Tracker** — Days since your last tax home visit with On Track / Due Soon / Overdue status
    * **YTD Financial Summary** — Taxable income, tax-free stipends, expenses, and estimated take-home

    <Frame caption="The Dashboard gives you a complete picture of your stipend protection status at a glance.">
      <img src="https://mintcdn.com/stipendguard/rYTODjwsgR5TPzB9/images/quickstart/dashboard.png?fit=max&auto=format&n=rYTODjwsgR5TPzB9&q=85&s=9baf951dc4e0732484de20948972a698" alt="Dashboard showing stipend protection banner, audit score, action items, and financial summary" style={{ maxWidth: '300px' }} width="786" height="1680" data-path="images/quickstart/dashboard.png" />
    </Frame>

    <Frame caption="Scroll down to see action items, financial summary, tax filing preview, and the visit tracker.">
      <img src="https://mintcdn.com/stipendguard/rYTODjwsgR5TPzB9/images/quickstart/dashboard-full.png?fit=max&auto=format&n=rYTODjwsgR5TPzB9&q=85&s=47d1b4644da25059707ed84a0850a118" alt="Full Dashboard scroll showing action items, YTD summary, tax filing preview, and visit tracker" style={{ maxWidth: '300px' }} width="786" height="4244" data-path="images/quickstart/dashboard-full.png" />
    </Frame>

    The onboarding checklist will track your progress through these steps and dismiss automatically once complete.
  </Step>
</Steps>

## What's next?

With your tax home, first assignment, and an expense logged, TaxHomeBase is already tracking your audit readiness. Here's where to go from here:

<CardGroup cols={2}>
  <Card title="Tax Home Guide" icon="house" href="/guides/tax-home">
    Deep dive into maintaining your tax home and understanding the strength score
  </Card>

  <Card title="Understanding Stipends" icon="shield-check" href="/tax-education/protecting-stipends">
    Learn the 4 rules for keeping your stipends tax-free
  </Card>

  <Card title="Upgrade to Pro" icon="crown" href="/plans-and-billing">
    Unlock tax estimates, state income tracking, contract comparison, and exports
  </Card>

  <Card title="Track Mileage" icon="car" href="/guides/mileage">
    Log work-related mileage for IRS deductions at the standard rate
  </Card>
</CardGroup>
