Is there a mobile app?
Is there a mobile app?
Not a native one — iWorkWhen is a responsive web app. It works as a PWA: open
iworkwhen.com on your phone, and Add to Home Screen (iOS: Share → Add to Home Screen; Android: browser menu → Install).Can we host this ourselves?
Can we host this ourselves?
Yes. The code is at natehome/iworkwhen. You need:
- A Supabase project (or self-hosted Postgres with matching schema)
- A Vercel or similar Next.js host
- An SMTP provider (optional, for emails)
Can I customize the branding?
Can I customize the branding?
Some of it is data-driven via customer rules (
company_name appears in the sidebar). Deeper customization (logo, color palette) requires editing the code — it’s all in src/app/globals.css and src/components/AppShell.tsx.Does it integrate with payroll / HR / timeclock?
Does it integrate with payroll / HR / timeclock?
Not yet. The Timesheet view is read-only scheduled hours. Future integrations being considered:
- Clock-in/clock-out via a punch API
- Export to ADP, Gusto, Paychex
- HR sync (new user onboarding, termination)
How do I add a holiday?
How do I add a holiday?
Edit the
holidays customer rule — set its value to an array of ISO dates like ["2026-07-04", "2026-12-25"]. See Customer rules.Currently this doesn’t change scheduling automatically. Future versions will add holiday-aware coverage adjustments.Can I have multiple admins?
Can I have multiple admins?
Yes, assign the Admin role to as many users as you want. All admins have equal power — there’s no concept of “super admin” vs “admin”. For auditing, you can see who did what in Audit log.
Can employees see each other's pay differential / wages?
Can employees see each other's pay differential / wages?
Not directly. Shift definitions have differentials that show on OT posts and influence timesheet math, but individual wage data is not stored in iWorkWhen — integrate with your payroll system for that.
What happens to data if we delete a user?
What happens to data if we delete a user?
iWorkWhen disables users rather than deleting. Their shifts, trades, absences, and messages are preserved for history. Hard-delete is possible via the Supabase dashboard (cascades will remove dependent rows); not recommended for compliance reasons.
Can I schedule non-employees (contractors, volunteers)?
Can I schedule non-employees (contractors, volunteers)?
Yes — give them a Dispatcher (or Trainee) role and optionally a dedicated group. The app doesn’t care about employment status internally.
How do I change the default admin credentials?
How do I change the default admin credentials?
Sign in as
admin@iworkwhen.local / iWorkWhen123! and go to Profile → Change password. Use a strong password. For extra safety, also change the email via the Supabase dashboard or by creating a new admin account under your own email and disabling the default one.Does iWorkWhen handle DST transitions?
Does iWorkWhen handle DST transitions?
Times are stored as
time (no timezone). Shift hours are calculated as end - start + 24 mod 24, which works correctly across 23/25-hour DST days as long as your org operates in a single timezone. Cross-timezone scheduling is not currently supported.How do I back up?
How do I back up?
Supabase runs automatic daily backups. You can also export the entire DB via the Supabase dashboard (Settings → Database → Backups). For the code, the GitHub repo is itself the backup.