| Down Payment | First Use | Subsequent Use |
|---|---|---|
| Less than 5% | 2.15% | 3.30% |
| 5% – 9.99% | 1.50% | 1.50% |
| 10% or more | 1.25% | 1.25% |
| Upfront MIP (UFMIP) | |
|---|---|
| All loans | 1.75% of base loan |
| Annual MIP — Term > 15 yrs | Rate |
|---|---|
| LTV ≤ 90% (≤ $726,200) | 0.50% |
| LTV > 90% (≤ $726,200) | 0.55% |
| LTV ≤ 90% (> $726,200) | 0.70% |
| LTV > 90% (> $726,200) | 0.75% |
| Rule | Requirement |
|---|---|
| Right of Rescission (Reg Z) | 3 business days (refis & HELOCs on primary residence; Sat counts, Sun/holidays don't) |
| Closing Disclosure (CD) | Received 3 business days before consummation |
| Loan Estimate (LE) | Within 3 business days of application |
| Initial CD after LE | May be sent the following day after the LE |
| Appraisal — copy delivery (ECOA) | Promptly on completion, and ≥ 3 business days before consummation; borrower may waive the timing (waiver itself due ≥ 3 business days before closing) |
| Intent to Proceed | Required before charging fees (beyond credit report) |
| Revised LE (changed circumstance) | Within 3 business days of learning of the change |
| Item | Typical Basis |
|---|---|
| Origination charges (Sec. A) | Points + lender fees; counts toward QM P&F cap |
| Prepaid interest | Per-diem × days from funding to month-end |
| Escrow cushion | Up to 2 months (per RESPA aggregate) |
| Owner's title | Seller-paid in many states; varies by locale |
| Transfer / conveyance tax | State/county-specific (e.g. FL doc stamps) |
| Loan Type | Down Payment | Max |
|---|---|---|
| Conventional (primary / 2nd home) | < 10% down | 3% |
| Conventional (primary / 2nd home) | 10% – 25% down | 6% |
| Conventional (primary / 2nd home) | > 25% down | 9% |
| Conventional (investment) | Any | 2% |
| FHA | Any | 6% |
| VA | Any | 4%* |
| USDA | Any | 6% |
| State | Abbr. |
|---|---|
| Arizona | AZ |
| California | CA |
| Idaho | ID |
| Louisiana | LA |
| Nevada | NV |
| New Mexico | NM |
| Texas | TX |
| Washington | WA |
| Wisconsin | WI |
| Status | Item | Where in The Atlas | Source / trigger | Schedule |
|---|
| Version | Date pushed | Summary of changes |
|---|
Current version: v1.3
File: the_atlas.html (single, self-contained HTML file — no install, no server)
Last updated: 11/11/2026
The Atlas is the Nations Lending resource hub: calculators, compliance timing tools, reference documents, and guideline links in one page.
Download the_atlas.html and open it in Chrome or Edge. Everything — including the built-in documents — is embedded in the file, so it works offline. Fonts load from Google Fonts when online; without internet the page falls back to system fonts.
| Tab | What's there |
|---|---|
| Home | What's New banner, Rescission & Funding / CD calendar, pinned calculators |
| Document Hub | Downloadable matrices, worksheets, and policy docs |
| Calculator Hub | 18 calculators grouped by loan type |
| Tools | Property tax due dates, escrow aggregate setup |
| Cheat Sheet | Loan limits, VA funding fee, FHA MIP, timing rules, seller concessions, community property states |
| Third Party Resources | Guideline Guru, agency handbooks and selling guides |
Short announcement strip at the top of Home. Dismissible per visit (the ✕ hides it until the page is reloaded). Edit the text in the #update-banner block when releasing a new version.
A month calendar with two independent modes:
Pick: Close date — click a closing date to see:
Rescission applies only to primary-residence refinances (rate/term or cash-out). Purchases, second homes, and investment properties show no rescission.
Pick: CD accepted — click the date the borrower received/accepted the Closing Disclosure to see the earliest permissible closing date (3 business days after receipt).
Persistent monthly flags (shown in both modes):
Month and year dropdowns plus ‹ › arrows navigate the calendar.
| Rule | Treatment |
|---|---|
| Business day (Reg Z specific) | Saturdays count; Sundays and the 11 federal holidays do not |
| Federal holiday observance | Saturday holiday → observed Friday; Sunday holiday → observed Monday (incl. Jan 1 on a Saturday → observed Dec 31 of the prior year) |
| Rescission — 12 CFR 1026.23 | 3 business days after consummation; earliest disbursement is the 4th business day |
| Funding days (shop rule) | No funding on Saturdays, Sundays, or holidays — rolls forward to the next weekday that isn't a holiday (e.g., a loan closed Tue 9/15 funds Mon 9/21) |
| CD timing — 12 CFR 1026.19(f) | Must be received 3 business days before consummation; based on actual receipt (no mailbox presumption); Sunday receipt is not pushed |
The calendar is a planning aid. TX 50(a)(6) has its own longer timelines. Verify against the compliance desk; not legal advice.
Shortcut cards for frequently used calculators. Each card has Open and a print icon that prints that calculator directly.
Built-in documents (embedded in the file, download on click):
| Document | Category | Notes |
|---|---|---|
| Lending Matrix | Lending Matrix | Matrix_10_1_2026.xlsx — updated 10/1/26 |
| Manufactured Lending Matrix | Lending Matrix | MANUFACTURED_LENDING_MATRIX_9_15_2026.xlsx — updated 9/15/26 |
| Scheduling State Guide | Team Resource | Attorney, spousal signature & witness requirements by state |
| Who Signs What Matrix | Team Resource | Job aid: co-borrower vs. co-signer vs. guarantor vs. non-borrowing spouse — who is on title, signs the security instrument / note / purchase contract, is on the HOI, and carries credit liability |
| 1084 Worksheet — Fannie Mae | Team Resource | Self-employment income analysis (Conventional / FNMA) |
| 1084 Worksheet — Freddie Mac & Govt | Team Resource | Self-employment income analysis V12 |
| Texas Cash-Out Requirements | Policy / Compliance | TX 50(a)(6) checklist |
To add or replace a document for everyone, it is embedded in the HTML file and released as a new version.
Pick a calculator from the dropdown. Each one has a Print button, and a Clear fields button in its header that resets only that calculator's inputs to their starting values (mode and program toggles keep their current selection).
| Group | Calculator |
|---|---|
| General / Loan Math | Basic Mortgage Calculator |
| Amortization Schedule Comparison | |
| Gift of Equity Structuring | |
| Payment Shock Threshold (50% / 75%) | |
| Temporary Buydown (Compare) | |
| Payoff Amount (Estimate) | |
| FHA | FHA Seasoning Calculator |
| FHA Streamline — Max Mortgage Amount | |
| FHA Streamline — Net Tangible Benefit (NTB) | |
| UFMIP Refund Estimator | |
| VA | VA Mortgage Calculation Worksheet (Beta) |
| VA Seasoning Calculator | |
| VA Residual Income (Beta) | |
| Investment / DSCR | RIO (DSCR) Calculator (Beta) |
| Income | Gross-Up Income Calculator |
| Compliance | QM & High Cost — Points & Fees |
| TX 2% Home Equity Fee Calculator | |
| EPO Policy Calculator |
Each note covers what the calculator answers, the rule it applies as built, and its limits. Reminder points to the Build Info → Update Reminders item that covers it.
Basic Mortgage Calculator — enter any three of loan amount, payment, term and rate, and it solves for the fourth (P&I only). Rate is solved iteratively; a payment too low to ever amortize the loan returns no term.
Amortization Schedule Comparison — current loan vs. new loan, each with an optional extra monthly principal payment. Shows the payment difference, interest saved and time saved, with an annual view (cumulative principal and interest by year) or a monthly view (first 60 months). Standard monthly amortization; does not include taxes, insurance or MI.
Gift of Equity Structuring — solves for the sales price in a family/non-arm's-length sale.
Payment Shock Threshold (50% / 75%) — maximum allowed increase and payment ceiling at 50% or 75% over the current payment (current × 1.5 or × 1.75). Compare on the same basis (PITIA vs. P&I) on both sides.
Temporary Buydown (Compare) — loan amount, note rate, term and optional sales price.
Payoff Amount (Estimate) — UPB + (per diem × days) + fees − credits. Per diem = UPB × note rate ÷ 360. The 360 basis is intentional: it runs slightly higher than a 365-day basis (about $1/day per $250K), which is the safe direction for an estimate. The servicer's payoff statement governs.
FHA Seasoning Calculator — three modes:
FHA Streamline — Max Mortgage Amount — lesser of (a) outstanding principal + interest + MIP due and (b) original principal balance; minus the UFMIP refund = max base mortgage (cents truncated). New UFMIP = base × 1.75%. Total is capped at the county FHA loan limit entered (flagged when the cap applies).
FHA Streamline — Net Tangible Benefit (NTB) — two methods; one must be met.
| Prior loan | → Fixed | → 1-yr ARM | → Hybrid ARM |
|---|---|---|---|
| Fixed | ≥ 0.5 pt lower | ≥ 2 pts lower | ≥ 2 pts lower |
| ARM, < 15 months to next change | ≤ 2 pts higher | ≥ 1 pt lower | ≥ 1 pt lower |
| ARM, ≥ 15 months to next change | ≤ 2 pts higher | ≥ 2 pts lower | ≥ 1 pt lower |
UFMIP Refund Estimator — FHA-to-FHA refinance. Base loan = total loan ÷ 1.0175; UFMIP paid = base × 1.75%; refund = UFMIP × chart %. Chart: 80% in month 1, down 2 points per month to 10% at month 36, none after 36 (formula: 82 − 2 × months).
VA Mortgage Calculation Worksheet (Beta) — follows VA's loan-calculation worksheet steps.
VA Seasoning Calculator — VA-to-VA refinance (IRRRL / cash-out). Earliest closing (note date) is the day after the later of (a) the 6th monthly payment due date and (b) 210 days after the first payment due date. Shows the 6 payments that must be made in the month due.
VA Residual Income (Beta) — VA Chapter 4 family-support test. Ported from the NLC Underwriting VA Residual Income Worksheet v1.2; the calculation code is unchanged.
RIO (DSCR) Calculator (Beta) — DSCR = 100% of gross monthly rental income ÷ PITIA (principal, interest, taxes, insurance, HOA; used for amortizing and interest-only loans). Optional minimum DSCR, loan purpose (product list), FICO and LTV for a pass/below-minimum check against the embedded eligibility matrix (as of 4/1/2026: investment, SFD/PUD/condo, 1–4 units; e.g. 80% LTV / 700 FICO / 100% DSCR; 70% LTV / 660 FICO / 120% DSCR).
Gross-Up Income Calculator — grosses up the non-taxable portion of an award amount.
QM & High Cost — Points & Fees (port of QM_HighCost_Calculator v11; 12 CFR 1026.32 & 1026.43(e)(3))
TX 2% Home Equity Fee Calculator — TX 50(a)(6); 7 TAC § 153.5.
EPO Policy Calculator — company early-payoff policy: the current loan cannot be paid in full within 180 days of disbursement. Window ends on day 180; the new loan can close earlier but cannot fund until day 181 or later.
LC Property Tax Due Dates — pick the property state, then search or select the county / taxing agency to see its tax due date(s).
Escrow Aggregate Setup — Initial Account Worksheet — enter estimated close date, first payment date (auto-filled, editable), and cushion months. Property tax dates lock in from the tool above; add homeowner's insurance, flood (if applicable), and city tax dates. Use the Print button in its header to print the worksheet.
| Section | Link |
|---|---|
| Guideline Research | Guideline Guru |
| FHA | HUD 4000.1 Single Family Housing Policy Handbook |
| Fannie Mae | Selling Guide · Self-Employment Income Calculator |
| Freddie Mac | Selling Guide · Self-Employment Income Calculator |
| VA | VA Lenders Page |
| USDA | USDA Rural Development Handbooks (incl. HB-1-3555) |
The Atlas v1.3 · <Calculator name> Printed MM/DD/YYYY h:mm AM/PMA v1.3 · Build Info button sits in the bottom-right corner of every page (the number always matches the current version). It opens the Build Info page, available to everyone — no login. It has four sub-tabs:
Update Reminders — everything in The Atlas that changes over time and has to be checked to keep it accurate. Each item shows where it lives in the dashboard, where the new data comes from, and a status:
| Status | Meaning |
|---|---|
| Overdue | An annual update's effective date has passed and it hasn't been marked done for this year |
| Check due | A monthly, quarterly or semi-annual (Jan 1 / Jul 1) check is due for the current period |
| Due soon | Due within 45 days |
| Scheduled | Done for the current period; shows the next due date |
| Monitor | No fixed date — update when the source changes |
Reminders and their completion status are built into the file, so every copy shows the same list. To mark an item done (or add/remove one), update the file and release a new version.
Version History — every release with its date and a summary of changes. The newest entry sets the version badge in the header, the Build Info button, and the version printed on printouts, so they always match.
Admin Guide — this document, readable in the tab, with a Download .md button.
Reference Docs — supporting documents for specific calculators (currently the VA Residual Income build/status document from NLC Underwriting). Each is a collapsible section — click its title bar to expand or collapse it — with its own Download .md button. More calculator documents can be added as additional sections.
There is no admin login. Documents are added to the Document Hub by embedding them in the file and releasing a new version, so every copy stays the same.
Stored in the browser's localStorage under the key tm_v6:
pinnedCalcs — the user's pinned calculatorsNothing is shared between users or devices. Clearing browser data resets pins to the defaults.
Releasing a new version
1. Add a new entry to the top of the version history (ATLAS_VERSIONS in the file). The header badge, Build Info button, print footer, and Build Info page update automatically.
2. Update any reminders that were completed (ATLAS_TODOS).
3. Update the What's New banner text.
4. Refresh this guide (current version and change log) and re-embed it.
5. Redistribute the file.
Editing the file safely The file contains large embedded (base64) documents. Edit by exact text replacement, not by deleting large ranges, and syntax-check the script after changes.
| Version | Date | Changes |
|---|---|---|
| v1.3 | 11/11/2026 | New VA Residual Income calculator (Beta), ported from the NLC Underwriting worksheet v1.2: 2026 federal, FICA, state and state-program withholding per borrower, with official 2026 state withholding formulas for 17 states (incl. mid-2026 changes); optional local / county income tax; VA regional residual floors by family size and loan tier; 120% test when DTI is over 41%; printable borrower record. Every calculator now has its own Clear fields button in its header; it resets only that calculator. Tools: Print button on the Escrow Aggregate Setup worksheet. Third Party Resources: USDA Rural Development Handbooks link. Document Hub: added the Who Signs What Matrix job aid (co-borrower, co-signer, guarantor, non-borrowing spouse). New Harbor look: updated color palette (navy header, cream page, orange accents), refreshed layout with a centered tab tray, and the new Atlas logo. Admin login and Admin tab replaced by a Build Info button (bottom right, open to everyone) with the same update reminders, version history, admin guide and new Reference Docs tab (VA Residual build/status document). |
| v1.2 | 10/27/2026 | Admin tab (visible only after admin login): update reminders, version history, and the admin guide with .md download. Every calculator printout now carries a footer with the version number, calculator name, and print date/time. QM & High Cost calculator updated to v11: max discount shown with no concession; concession-needed alert (points and $) when over the QM cap. Header version badge and print footer are now driven by the version history, so they always match the latest release. New Temporary Buydown calculator: 3-2-1, 2-1, 1-1, 1-0 and custom, with a side-by-side compare view and cost as % of loan / sales price. Removed the browser-only + Add Doc button (added docs never synced to other users). |
| v1.1 | 10/07/2026 | QM & High Cost calculator updated to v9: max discount solved with the same pass/fail test as the result bar; alerts when a lender credit is needed. |
| v1.0 | 10/02/2026 | Launched as The Atlas: new logo with “Resource Dashboard” in the header. Home: What’s New banner, Rescission & Funding / CD calendar (persistent monthly flags, month/year dropdowns), and customizable pinned calculators with print. Lending Matrix updated to 10/1/26; Guideline Guru added; FHA 4000.1 Handbook link updated. Payment Shock 50% / 75% toggle; Gift of Equity calculator updated. |
File: va-residual-calculator.html (single self-contained HTML file; only external dependency is one Google Font)
Version: v1.2
As of: 2026-11-04
Owner: Dano (NLC Underwriting)
Purpose: Determine whether a VA borrower passes the Chapter 4 family-support residual-income test, using 2026 payroll withholding validated against PaycheckCity, with a pass/fail determination and a printable borrower record.
Triggered by the Residual Calculator — Tax Engine Review (Nov 3, 2026). The review was right that the state engine used tax-return brackets instead of withholding formulas, and that the errors leaned toward overstating residual. The net-pay engine file it recommended porting was never available, so each state was rebuilt from its official 2026 payroll source and validated live against PaycheckCity in Chrome.
Unchanged (per the review's "do not touch" list): federal basis (including the correct HoH brackets), FICA, per-borrower architecture, CA fork, VA floors, the 41% / 120% gate, the determination stamp.
| State | Review figure | PaycheckCity | Tool v1.2 | What happened |
|---|---|---|---|---|
| IA | $148.83 | $107.67 | $107.67 | Review used the $13,000 spouse-working deduction on a single-earner file. Married one-income is $26,000. PaycheckCity has an explicit "Spouse working status" toggle (default False). |
| MS | $111.33 | $151.00 | $151.00 | Review applied the $12,000 personal exemption automatically. It's claimed in dollars on the 89-350; PaycheckCity's default is $0. The old tool figure was right. |
| MD | $233.12 | $206.21 | $206.21 | Review's figure doesn't reproduce. The real fix was a 1.5% indexed standard deduction ($3,400 / $6,800). County tax is now handled by the local field. |
| MA | $241.67 | $230.88 (YTD=0) | $241.67 | Both are "right." PaycheckCity's single paycheck with YTD = $0 deducts the full period FICA because the $2,000 Circular M cap isn't reached yet. Annualized, the true monthly average is $241.67 (kept: correct and conservative). |
The other 10 review findings (SC, CO, MN, LA, NC, OH, NJ, AZ, UT, GA) were correct and are now implemented.
| Engine | Basis | Granularity |
|---|---|---|
| Federal withholding | PaycheckCity Salary-calculator basis: full standard deduction ($16,100 / $32,200 / $24,150) then 2026 rate schedule | Per borrower |
| FICA | SS 6.2% to $184,500; Medicare 1.45% + 0.9% over $200k / $250k; S/E doubles; Retirement excludes | Per borrower |
| State withholding | Official 2026 payroll method per state (Section 4) | Per borrower |
| Local / county tax | Optional flat % of taxable wages | Per borrower |
| State programs | Employee-side SDI / PFML / WA Cares / UI, itemized, annualized caps | Per borrower, W-2 only |
| VA floors | VA Pamphlet 26-7, Ch. 4, Tables 9–11; 41% → 120% gate | Household |
| Tag | States | Notes |
|---|---|---|
| W/H · exact (live-validated) | AZ, CA, CO, GA, IA, IL, LA, MA, MD, MN, MS, NC, NJ, NY, OH, SC, UT | Matched to PaycheckCity across filing statuses and incomes (Section 6) |
| W/H · exact (review-confirmed) | IN, KY, MI, PA | Single-rate formulas; confirmed by the Nov 2026 review, same structure as IL (live-validated) |
| W/H · est. | AL, AR, CT, DE, DC, HI, ID, KS, ME, MO, MT, NE, NM, ND, OK, OR, RI, VT, VA, WV, WI | Annualized return brackets less state std deduction. Per the review, within $5/mo at MFJ $5k, but not built to the official method or validated live. |
| no tax | AK, FL, NV, NH, SD, TN, TX, WA, WY | WA still carries WA Cares + PFML program lines |
43 of 43 data points match within 2.5¢ (rounding states compared after rounding).
| State | Scenario | PaycheckCity | Tool |
|---|---|---|---|
| IA | MFJ one income / two income / single / HoH, $5k | 107.67 / 148.83 / 148.83 / 128.25 | same ✓ |
| CO | MFJ / single / HoH $5k; MFJ $10k | 180 / 200 / 200; 400 | same ✓ |
| GA | MFJ one / both / single / HoH $5k; MFJ $10k | 124.75 / 187.13 / 187.13 / 187.13; 374.25 | same ✓ |
| MS | MFJ one / spouse employed / single / HoH $5k | 151 / 159 / 159 / 155 | same ✓ |
| LA | default $5k; single $10k | 154.50; 309.00 | same ✓ |
| NC | MFJ / HoH $5k; single $10k | 161 / 139; 366 | same ✓ |
| NJ | MFJ / single (rate A) $5k; MFJ $10k | 97.50 / 167.92; 355.83 | same ✓ |
| UT | MFJ / single / HoH $5k | 186.41 / 222.50 / 222.50 | same ✓ |
| OH | MFJ $5k; single $10k | 119.33; 275.66 | same ✓ |
| SC | MFJ $5k; single $10k | 245.33; 545.33 | 245.32; 545.32 ✓ |
| AZ | MFJ $5k | 100.00 | same ✓ |
| MN | MFJ $5k | 202.00 | same ✓ |
| MD | MFJ / single $5k; single / MFJ $10k | 206.21 / 219.67; 460.63 / 443.71 | same ✓ |
| CA | MFJ one income / single $5k; single $10k | 82.47 / 164.32; 647.90 | 82.48 / 164.30; 647.88 ✓ |
| NY | MFJ $5k | 220.51 | same ✓ |
| IL | MFJ $5k | 247.50 | same ✓ |
| Federal | MFJ $5k / $10k; single $5k / $10k; HoH $5k | 236.67 / 836.67; 418.33 / 1,464.17; 329.00 | same ✓ |
| Programs | CO FAMLI; MN PFML; NJ TDI / FLI; MA PFML | 22.00; 22.00; 9.50 / 11.50; 23.00 | same ✓ |
End-to-end page test (headless browser): ledger, Calculate gating, edit-reverts-to-grey, 120% gate, local field, two-earner fork, and program lines all verified. No page errors.
Withholding formulas change on their own schedule, sometimes mid-year (four did in 2026). Everything that changes lives in labeled objects in the <script>:
FED, FED_STD — federal brackets and standard deductionSS_CAP, MED_THRESH — FICA caps/thresholdsST — fallback return brackets + std deductions (est. states, plus IL/IN/KY/MD/MI/PA exact)azWH … utWH, CA_WH, NY_WH, MN_WH, NJ_A, NJ_B, CO_ALLOW — official withholding formulasSTATE_AUTH — state → formula registrySTATE_EXACT_FALLBACK, STATE_ROUND — tagging and rounding listsPROG — program deduction rates/capsFLOORS, OVER5_ADD, REGION — VA tablesRe-run Section 6 against PaycheckCity after each update. Best sources: each state's DOR withholding publication, and the USDA National Finance Center state-tax bulletins (help.nfc.usda.gov/bulletins), which publish exact payroll formulas with effective dates.