Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/dmaman86/shiftly/llms.txt

Use this file to discover all available pages before exploring further.

Shiftly is a work-hour tracking and salary calculation application built with React and TypeScript. It takes shift input the way workers actually think — a start time and an end time — and reconstructs the full weighted breakdown that appears on an Israeli payslip: overtime brackets, Shabbat and holiday bonuses, night premiums, per-diem allowances, and meal allowances. The result is a transparent, verifiable simulation of the monthly pay calculation.
Shiftly provides indicative calculations only. Results should not be used for official payroll purposes and do not replace calculations performed by an authorized payroll department.

Introduction

Understand what Shiftly does, why it was built, and how Israeli labor law shapes its design.

Quickstart

Clone the repo, install dependencies, and run the app locally in under five minutes.

Architecture

Explore the Clean Architecture–inspired design: domain layer, adapters, hooks, and Redux slices.

Salary Calculation

Learn how shifts are segmented into overtime brackets, Shabbat rates, and night bonuses.

Core Features

Daily View

Enter shifts day by day, see per-day breakdowns, and watch the monthly total update incrementally.

Monthly View

Select any year and month to compute the full monthly salary summary with correct historical rates.

Configuration

Set your hourly rate, standard hours, year, and month to drive all downstream calculations.

Calculation Rules

Browse the complete set of pay rules — overtime, night premiums, Shabbat rates — in-app.

How It Works

1

Configure your work parameters

Set the year, month, standard daily hours (default 6.67), and hourly base rate in the Configuration panel.
2

Enter your shifts

In the Daily view, add one or more shifts per day. Mark sick or vacation days where applicable.
3

Review the per-day breakdown

Each day shows how hours are split across pay brackets: 100%, 125%, 150% regular; 150%/200% Shabbat; 20%/50% night bonuses.
4

Check the monthly summary

Switch to the Monthly view for an aggregated salary summary including per-diem points and meal allowances.

Why Shiftly?

Israeli payslips operate on weighted segments — overtime brackets that reset daily, Shabbat and holiday bonuses that activate at specific clock times, and night premiums that split mid-shift. Workers receive payslips they cannot easily verify. Shiftly bridges that gap by making the calculation transparent and verifiable.

Israeli Labor Law

Implements real overtime brackets, Shabbat/holiday rates, and night bonus rules from Israeli labor regulations.

Hebcal Integration

Automatically detects Jewish holidays and holiday eves via the Hebcal API to apply correct pay rates.

Incremental Updates

Adding or editing a single shift updates only that day’s contribution to the monthly total — no full recompute.

Build docs developers (and LLMs) love