◆ Products are in beta — partnerships for finalization welcome. Get in touch →
Demo › United States

United StatesApex Digital Solutions.
US payroll, run end to end.

A fictional IT consulting company built to exercise the hard parts of US payroll: six states, two local tax jurisdictions, commuters without reciprocity, hourly overtime, a child support order, and three pay frequencies in a single tenant. Every number on this page is a result calculated by the US.Payroll regulation and comes from the demo's integration tests.

Request the US Demo → View on GitHub US Coverage Matrix All Country Regulations
10
Employees
3
Pay frequencies
6
States
2
Local tax jurisdictions
18
Scenario tests
The Company

Ten employees, ten payroll problems

Apex runs one division per pay frequency — monthly, biweekly, and weekly — each with its own payroll calendar, so each payroll annualizes correctly (12, 26, or 52 periods). The monthly payroll pays on the last day of the month; the biweekly and weekly payrolls pay on the Friday after the period ends. The tax year, year-to-date limits, and quarterly reporting follow the pay date, not the period end: a December period paid in January counts toward the new year. Employees work in New York, New Jersey, Connecticut, California, Texas, and Pennsylvania, including New York City and Philadelphia. Each employee is chosen to trigger a specific compliance rule.

EmployeeRolePayrollLocationWhat it demonstrates
Sara ChenCFOMonthlyNew York CityNY State + NYC tax, company car fringe benefit, 401(k), HSA, W-4 Steps 3 and 4(c)
Robert StevensonVP EngineeringMonthlyNew YorkAge 50+ 401(k) catch-up contributions (SECURE 2.0)
Priya PatelProject ManagerBiweeklyLives CT, works NYCommuter withholding with resident credit, Head of Household filing status
Kevin WuCloud ArchitectBiweeklyCaliforniaHourly pay with California daily overtime (over 8 hours a day), CA State Disability Insurance without wage cap
Jessica TorresAccount ExecutiveBiweeklyTexas → CaliforniaNo state income tax, supplemental bonus withholding, relocation to California during a pay period
Ashley ParkQA EngineerWeeklyCaliforniaWeekly hourly payroll in California

● Sample results for these employees are shown below.

Sample Results

What the engine calculates

Four pay statements from January 2026: the biweekly payroll for January 12–25, paid on Friday, January 30, and the weekly payroll for January 5–11, paid on Friday, January 16. Amounts are in USD.

Marcus Johnson
Biweekly · Jan 12–25 · paid Jan 30
Lives in New Jersey, works in New York · Single · $150,000 / year
Gross salary5,769.23
401(k) pre-tax (6%)−346.15
Health premium (§125)−200.00
Federal income tax−820.23
Social Security (6.2%)−345.29
Medicare (1.45%)−80.75
State income tax, two states−290.67
  New York (work state)−287.28
  New Jersey (resident, difference)−3.39
NY Paid Family Leave (0.432%)−24.06
Net pay3,662.08
Why it matters: New Jersey and New York have no reciprocity agreement. The engine withholds New York tax on the work-state wages. New Jersey's tax on the same wages is higher ($290.67), so New Jersey withholds only the difference and the employee is not taxed twice. The 401(k) reduces federal taxable wages ($5,223.08) but not FICA wages ($5,569.23); New York Paid Family Leave follows the work state.
Carlos Rivera
Biweekly · Jan 12–25 · paid Jan 30
NY resident, work days split NY 60% / NJ 25% / CT 15% · $185,000 / year
Gross salary7,115.38
Federal income tax−1,274.38
Social Security (6.2%)−441.15
Medicare (1.45%)−103.17
State income tax, three states−421.18
  New Jersey (nonresident, 25% share)−45.69
  Connecticut (nonresident, 15% share)−59.71
  New York (resident, after credit)−315.78
NY Paid Family Leave (0.432%)−30.74
Net pay4,844.76
Why it matters: Each state applies its own rule. New Jersey taxes its share of the wages, Connecticut prorates its tax on the full wages to its share, and New York, as the resident state, taxes all wages and reduces its withholding by the amounts withheld for New Jersey and Connecticut. The rule per state comes from a lookup, not from code. This is the calculation most platforms push back to a manual spreadsheet.
David Kim
Weekly · Jan 5–11 · paid Jan 16
Philadelphia resident · Hourly $32.00 × 40 h
Gross wages1,280.00
Federal income tax−111.79
Social Security (6.2%)−79.36
Medicare (1.45%)−18.56
Pennsylvania income tax (3.07%)−39.30
Philadelphia wage tax (resident 3.74%)−47.87
PA unemployment, employee share (0.07%)−0.90
Net pay982.22
Why it matters: Weekly payroll annualizes over 52 periods. The local wage tax is resolved from the employee's tax jurisdiction code, so the same mechanism covers Pennsylvania Act 32 municipalities and other local taxes. Pennsylvania also charges employees a share of unemployment insurance, without a wage cap.
Linda Okafor
Biweekly · Jan 12–25 · paid Jan 30
New York · Single · $65,000 / year · Child support order $500 per period
Gross salary2,500.00
Federal income tax−216.15
Social Security (6.2%)−155.00
Medicare (1.45%)−36.25
NY State income tax−113.28
NY Paid Family Leave (0.432%)−10.80
Disposable earnings1,968.52
CCPA limit (60% of disposable)1,181.11
Child support withheld−500.00
Net pay1,468.52
Why it matters: Disposable earnings are gross pay minus legally required deductions only (taxes, FICA, and New York Paid Family Leave). The order is checked against the Consumer Credit Protection Act limit, which depends on whether the employee supports another family and whether the order is in arrears. Here the full $500 fits within the limit.

Results from the demo's integration tests, calculated with 2026 federal, state, and local parameters. Rounding follows the per-period withholding method of each jurisdiction.

Walkthrough

What a demo session covers

The demo is a complete tenant, published as an open reference on GitHub: every employee record, dated change, and expected result can be read in the repository. Running it requires a licensed US.Payroll regulation — or we walk through it with you live. It is organized in four steps.

STEP 1
Set up the company
Create the tenant, three payrolls, and ten employees with W-4 data, benefits, and multi-state assignments. From zero to the first payrun in about 20 minutes.
STEP 2
Employee lifecycle
New hire, mid-period salary change, FMLA leave and return, and a relocation to another state — each as a dated change that the engine applies to the right periods, down to the day within a pay period. All five events are covered by scenario tests.
STEP 3
Payruns and reports
Monthly, biweekly, and weekly payruns with year-to-date caps over a full year (Social Security wage base, Additional Medicare threshold, NY Paid Family Leave maximum, 401(k) limit), a bonus with supplemental withholding, and W-2, State W-2, Form 941, and Form 940 output by pay date.
STEP 4
Company-specific rules
Add a §132(f) commuter transit benefit and a work-from-home stipend as a company layer on top of US.Payroll — without modifying the regulation itself.
Installation

Regulation.US.Payroll.Demo

The demo ships as an installable tenant on top of the unchanged US.Payroll regulation. The repository is public under the MIT license; the US.Payroll regulation it runs on is licensed separately. For licensed users, one command sets up everything and runs all scenario tests; another removes the demo tenant again.

Repositorygithub.com/payrollex/Regulation.US.Payroll.Demo — MIT, readable without a license
PrerequisiteLicensed Regulation.US.Payroll as sibling folder; Payroll Engine backend 1.2 or later and the pecmd console
One-step installSetup.cmd — installs US.Payroll, bootstraps the tenant, applies the company layer, runs all tests
Tenant and payrollsApex.DigitalSolutions · Monthly (12) · Biweekly (26) · Weekly (52)
Payroll calendarsMonthly paid at month end · Biweekly and Weekly paid the Friday after the period
ResetDelete.cmd — removes the demo tenant only
TutorialsT1 Bootstrap (~20 min) · T2 Lifecycle (5 dated events) · T3 Payruns & Reports (Payslip, W-2, State W-2, Form 941, Form 940) · T4 Customizing (company regulation layer)
Scenario Tests

18 scenarios, each locked in by a test

Each test documents its scenario, the expected wage type results, and the full calculation chain in the repository. With a licensed installation, they run with Tests/Run.Tests.pecmd and are part of the one-step install.

TestEmployeeScenario
DEMO-TC01Sara ChenMonthly, NYC, company car, W-4 Steps 3/4(c)
DEMO-TC02Marcus JohnsonNJ → NY commuter, no reciprocity
DEMO-TC03Carlos RiveraThree-state allocation NY/NJ/CT
DEMO-TC04Kevin WuCA hourly, daily overtime, CA SDI
DEMO-TC05Jessica TorresTX, no state income tax
DEMO-TC06Linda OkaforChild support garnishment, CCPA limit
DEMO-TC07David KimWeekly, PA income tax + Philadelphia wage tax
DEMO-TC08Carlos Rivera§132(f) transit benefit via company layer
DEMO-TC09Robert StevensonMonthly, age 50+ 401(k) catch-up
DEMO-TC10Priya PatelCT → NY commuter, Head of Household
DEMO-TC11Ashley ParkWeekly, CA hourly
DEMO-TC12Jessica TorresBonus with supplemental withholding
DEMO-TC13Sara ChenSocial Security wage base reached during the year
DEMO-TC14Robert Stevenson401(k) annual limit reached
DEMO-TC15James LeeCA new hire during a pay period, prorated salary
DEMO-TC16Marcus JohnsonSalary change during a pay period
DEMO-TC17Linda OkaforUnpaid FMLA leave and return, garnishment limit
DEMO-TC18Jessica TorresRelocation TX → CA during a pay period
Background

The rules behind the demo

Walk through the US demo with us

We run the Apex payrolls with you, change employee data on the spot, and show how the results and reports update. With a US.Payroll license, you install the demo tenant from the repository on your own Payroll Engine instance.