Apex Digital Solutions.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.
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.
| Employee | Role | Payroll | Location | What it demonstrates |
|---|---|---|---|---|
| Sara Chen | CFO | Monthly | New York City | NY State + NYC tax, company car fringe benefit, 401(k), HSA, W-4 Steps 3 and 4(c) |
| Robert Stevenson | VP Engineering | Monthly | New York | Age 50+ 401(k) catch-up contributions (SECURE 2.0) |
| Marcus Johnson | Sr. Software Engineer | Biweekly | Lives NJ, works NY | Commuter withholding without a reciprocity agreement |
| Priya Patel | Project Manager | Biweekly | Lives CT, works NY | Commuter withholding with resident credit, Head of Household filing status |
| Kevin Wu | Cloud Architect | Biweekly | California | Hourly pay with California daily overtime (over 8 hours a day), CA State Disability Insurance without wage cap |
| Jessica Torres | Account Executive | Biweekly | Texas → California | No state income tax, supplemental bonus withholding, relocation to California during a pay period |
| Carlos Rivera | Principal Consultant | Biweekly | NY / NJ / CT | Work-day allocation across three states with credit logic |
| Linda Okafor | HR Coordinator | Biweekly | New York | Child support garnishment within the CCPA limit |
| David Kim | IT Support Technician | Weekly | Philadelphia | PA flat-rate income tax plus Philadelphia wage tax |
| Ashley Park | QA Engineer | Weekly | California | Weekly hourly payroll in California |
● Sample results for these employees are shown below.
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.
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.
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.
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.
| Repository | github.com/payrollex/Regulation.US.Payroll.Demo — MIT, readable without a license |
| Prerequisite | Licensed Regulation.US.Payroll as sibling folder; Payroll Engine backend 1.2 or later and the pecmd console |
| One-step install | Setup.cmd — installs US.Payroll, bootstraps the tenant, applies the company layer, runs all tests |
| Tenant and payrolls | Apex.DigitalSolutions · Monthly (12) · Biweekly (26) · Weekly (52) |
| Payroll calendars | Monthly paid at month end · Biweekly and Weekly paid the Friday after the period |
| Reset | Delete.cmd — removes the demo tenant only |
| Tutorials | T1 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) |
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.
| Test | Employee | Scenario |
|---|---|---|
| DEMO-TC01 | Sara Chen | Monthly, NYC, company car, W-4 Steps 3/4(c) |
| DEMO-TC02 | Marcus Johnson | NJ → NY commuter, no reciprocity |
| DEMO-TC03 | Carlos Rivera | Three-state allocation NY/NJ/CT |
| DEMO-TC04 | Kevin Wu | CA hourly, daily overtime, CA SDI |
| DEMO-TC05 | Jessica Torres | TX, no state income tax |
| DEMO-TC06 | Linda Okafor | Child support garnishment, CCPA limit |
| DEMO-TC07 | David Kim | Weekly, PA income tax + Philadelphia wage tax |
| DEMO-TC08 | Carlos Rivera | §132(f) transit benefit via company layer |
| DEMO-TC09 | Robert Stevenson | Monthly, age 50+ 401(k) catch-up |
| DEMO-TC10 | Priya Patel | CT → NY commuter, Head of Household |
| DEMO-TC11 | Ashley Park | Weekly, CA hourly |
| DEMO-TC12 | Jessica Torres | Bonus with supplemental withholding |
| DEMO-TC13 | Sara Chen | Social Security wage base reached during the year |
| DEMO-TC14 | Robert Stevenson | 401(k) annual limit reached |
| DEMO-TC15 | James Lee | CA new hire during a pay period, prorated salary |
| DEMO-TC16 | Marcus Johnson | Salary change during a pay period |
| DEMO-TC17 | Linda Okafor | Unpaid FMLA leave and return, garnishment limit |
| DEMO-TC18 | Jessica Torres | Relocation TX → CA during a pay period |
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.