Skip to content
@Payroll-Engine

Payroll Engine

Open Source Payroll Engine
README.md

Payroll Engine

The open-source payroll automation framework.
Build multi-country, multi-industry payroll applications with composable regulation layers.

Build License: MIT Release NuGet Docker

Website  ·  Get Started  ·  Quick Start  ·  Discussions

What is the Payroll Engine?

The Payroll Engine is a framework for building payroll applications. Payroll logic lives in configurable regulation layers — not hardcoded. Layers are stacked, overridden, and shared across tenants, countries, and industries.

Embed it via REST API, deploy it via Docker, or automate it with the .NET Client SDK.

Three Roles

Role Who Interface
Provider HR-tech platforms, EOR providers REST API · OpenAPI 3.1
Regulator Payroll consultants, HR specialists No-Code Actions · C# Scripting
Automator DevOps, integration engineers .NET Client Services SDK · CLI

Quick Start

# 1. Login to GitHub Container Registry (one-time)
echo "<your-pat>" | docker login ghcr.io -u <github-username> --password-stdin

# 2. Clone and configure
git clone https://github.com/Payroll-Engine/PayrollEngine.git
cd PayrollEngine
echo "DB_PASSWORD=PayrollStrongPass789" > .env

# 3. Start
docker compose -f docker-compose.ghcr.yml up -d

Web Application: http://localhost:8081 · Backend API: http://localhost:5001

→ Full setup guide

Repositories

Repository Description
PayrollEngine Main repo — Docker stack, examples, tests, schemas
PayrollEngine.Backend REST API server + SQL Server persistence
PayrollEngine.WebApp Blazor web application
PayrollEngine.PayrollConsole CLI for automation, testing, and data import
PayrollEngine.Client.Services .NET Client SDK (NuGet entry package)
PayrollEngine.Client.Scripting Scripting API for regulation development
PayrollEngine.Client.Core Client core objects
PayrollEngine.Client.Test Test runner library
PayrollEngine.Core Core payroll objects
PayrollEngine.Document Report generation
PayrollEngine.Serilog Structured logging

→ Full repository map

License

MIT — free for any use. See LICENSE.

Pinned Loading

  1. PayrollEngine PayrollEngine Public

    Open-source framework for regulation-driven payroll applications — multi-tenant, multi-country, API-first, with No-Code/Low-Code automation and test-driven development.

    PowerShell 92 20

  2. PayrollEngine.Backend PayrollEngine.Backend Public

    REST API backend server for the Payroll Engine — regulation execution, payrun processing, multi-tenant data management, and SQL Server persistence. Docker-ready.

    C# 3 5

  3. PayrollEngine.PayrollConsole PayrollEngine.PayrollConsole Public

    CLI tool for the Payroll Engine — import/export payroll data (JSON/YAML), run payruns, execute payroll tests, and automate workflows via .pecmd command files.

    C# 2

  4. PayrollEngine.WebApp PayrollEngine.WebApp Public

    Blazor Server web application for the Payroll Engine — payroll management, employee self-service, case data entry, forecasting, and reporting. Docker-ready.

    C# 6 4

Repositories

Showing 10 of 16 repositories
  • PayrollEngine.Client.Scripting Public

    NuGet scripting library for the Payroll Engine — No-Code action syntax for Cases, Collectors, and WageTypes, plus the C# Low-Code scripting runtime with integrated and extensible custom actions.

    Payroll-Engine/PayrollEngine.Client.Scripting’s past year of commit activity
    C# 1 MIT 2 0 0 Updated Mar 10, 2026
  • PayrollEngine.Client.Services Public

    NuGet entry package for .NET integration with the Payroll Engine — bundles Client.Core and Client.Scripting with function controllers, payroll period implementations, and the script execution context.

    Payroll-Engine/PayrollEngine.Client.Services’s past year of commit activity
    C# 1 MIT 1 0 0 Updated Mar 10, 2026
  • .github Public

    Organization repository

    Payroll-Engine/.github’s past year of commit activity
    0 MIT 0 0 0 Updated Mar 10, 2026
  • PayrollEngine Public

    Open-source framework for regulation-driven payroll applications — multi-tenant, multi-country, API-first, with No-Code/Low-Code automation and test-driven development.

    Payroll-Engine/PayrollEngine’s past year of commit activity
    PowerShell 92 MIT 20 0 0 Updated Mar 10, 2026
  • PayrollEngine.Client.Tutorials Public

    Payroll Engine Client Tutorials

    Payroll-Engine/PayrollEngine.Client.Tutorials’s past year of commit activity
    C# 0 MIT 1 0 0 Updated Mar 10, 2026
  • PayrollEngine.WebApp Public

    Blazor Server web application for the Payroll Engine — payroll management, employee self-service, case data entry, forecasting, and reporting. Docker-ready.

    Payroll-Engine/PayrollEngine.WebApp’s past year of commit activity
    C# 6 MIT 4 0 0 Updated Mar 9, 2026
  • PayrollEngine.Backend Public

    REST API backend server for the Payroll Engine — regulation execution, payrun processing, multi-tenant data management, and SQL Server persistence. Docker-ready.

    Payroll-Engine/PayrollEngine.Backend’s past year of commit activity
    C# 3 MIT 5 0 0 Updated Mar 9, 2026
  • PayrollEngine.PayrollConsole Public

    CLI tool for the Payroll Engine — import/export payroll data (JSON/YAML), run payruns, execute payroll tests, and automate workflows via .pecmd command files.

    Payroll-Engine/PayrollEngine.PayrollConsole’s past year of commit activity
    C# 0 MIT 2 0 0 Updated Mar 9, 2026
  • PayrollEngine.Client.Test Public

    NuGet test runner library for the Payroll Engine — automated Case, Payrun, and Report tests for validating input, payrun results, and report data against expected values.

    Payroll-Engine/PayrollEngine.Client.Test’s past year of commit activity
    C# 0 MIT 1 0 0 Updated Mar 9, 2026
  • PayrollEngine.Client.Core Public

    NuGet base library for Payroll Engine clients — C# object model, REST API service interfaces, Exchange import/export (JSON/YAML), OData query builder, and PayrollHttpClient wrapper.

    Payroll-Engine/PayrollEngine.Client.Core’s past year of commit activity
    C# 0 MIT 2 0 0 Updated Mar 9, 2026
View all repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…