Schema — Settings
timeclockSettings {
contractorId: Id<contractorUsers>
gpsEnabled: boolean
geofenceEnabled: boolean
geofenceRadiusFt: number (50-500)
autoClockOutMinutes: number (default 720)
verificationFreqMin: 5 | 15 | 30
autoPauseOnExit: boolean
trackBetweenJobs: boolean
}
overtimeRules {
contractorId: Id<contractorUsers>
weeklyOtEnabled: boolean
weeklyOtThreshold: number (hours)
weeklyOtMultiplier: 1.5 | 2.0
dailyOtEnabled: boolean
dailyOtThreshold: number (hours)
doubleTimeEnabled: boolean
doubleTimeThreshold: number (hours)
holidayMultiplier: number
holidays: string[] (ISO dates)
autoCalculate: boolean
stateCompliance: "OH" | "CA" | "federal"
}
Schema — Break & Time
breakPolicy {
contractorId: Id<contractorUsers>
breakType: "paid" | "unpaid" | "mixed"
breakDurationMin: 15 | 30 | 60 | custom
autoDeduct: boolean
autoDeductAfterHours: number
breakReminders: boolean
managerAlerts: boolean
}
timeEntries {
contractorId: Id<contractorUsers>
employeeId: Id<contractorUsers>
jobId: Id<jobs>
clockInAt: number (timestamp)
clockOutAt: number?
clockInLocation: {lat, lng, accuracy}
gpsSnapshots: [{lat, lng, ts}]
breakMinutes: number
overtimeMinutes: number
status: active | completed | adjusted
}
Mutations
settings.update(fields)
→ updated timeclockSettings
overtime.update(rules)
→ updated overtimeRules
breakPolicy.update(policy)
→ updated breakPolicy
clockIn(jobId, lat, lng)
→ {entryId, geofenceStatus}
clockOut(entryId, lat, lng)
→ {duration, otMinutes}
startBreak(entryId, type)
→ {breakId, startedAt}
timesheets.batchApprove(
timesheetIds[])
→ {approved, rejected}
payroll.export(
format, dateRange)
→ {fileUrl, summary}
Queries & Hooks
settings.get()
→ timeclockSettings
geofence.get(jobId?)
→ {center, radius, status}
activeEntry.get()
→ current clock-in or null
timesheets.listForWeek(
weekStart)
→ [{employee, daily, total, ot}]
payroll.preview(
format, dateRange)
→ {employees, regH, otH, totPay}
analytics.dashboard(
dateRange)
→ {avgHours, otRate, onTime%,
gpsCompliance%, otTrend[],
laborByJob[]}
Hooks:
useTimeclock() — clock state
useGeofence() — location check
usePayrollExport() — formatter
Integrations
expo-location
GPS, background location
Geofencing API (enter/exit)
react-native-maps
MapView + Circle overlay
Job site pin markers
Payroll Exporters
ADP Workforce Now (CSV)
Gusto (CSV import format)
QuickBooks Time (IIF)
Generic CSV/PDF
Push Notifications
Break reminders
Geofence exit alerts
Auto clock-out warnings
Compliance Engine
OH R.C. 4111.03 (FLSA)
State-specific OT rules
Break law requirements
Research Sources
TSheets / QuickBooks Time
Geofence auto clock-in/out
QB payroll integration
Facial recognition + GPS
ClockShark
GPSFence (adaptive GPS)
Battery-aware frequency
Construction-first UI
BusyBusy
Dynamic geofences (resize)
Elevation-aware tracking
On-site verification gate
Homebase / Deputy
Break compliance engine
Multi-format payroll export
Scheduling integration
Clockify
Analytics dashboard UX
Timesheet approval flow
