Auto Save
Revision 1.0 (2026-01-25) - Initial documentation
Auto Save automatically persists document form changes as users work, reducing the risk of data loss and improving user experience.
Overview
The Auto Save feature provides two complementary save mechanisms for document forms:
| Type | Behavior | Use Case |
|---|---|---|
| Debounced Save | Saves after 5 seconds of inactivity | Regular form changes, text input, date/time pickers |
| Immediate Save | Saves instantly | Critical actions like digital signatures, pass/fail results |
User Experience
What Users See
- No manual save required for regular form edits
- Changes persist automatically after brief pause in typing
- Instant save when signing documents or recording inspection results
- Dirty indicator shows unsaved changes (if navigating away)
Save Triggers
| Action | Save Type | Delay |
|---|---|---|
| Edit text field | Debounced | 5 seconds |
| Change date | Debounced | 5 seconds |
| Change time | Debounced | 5 seconds |
| Add table row | Debounced | 5 seconds |
| Remove table row | Debounced | 5 seconds |
| Verify signature | Immediate | None |
| Record pass/fail | Immediate | None |
Supported Forms
Auto Save is implemented on all Permit-to-Work document forms:
- Project Registration Form
- Tool List Form
- JSA Form
- Work Permit Forms (General, Hot Work, Confined Space, etc.)
- Pre-Work Procedures Form
Technical Details
Two Output Pattern
Forms emit two separate save events to the parent component:
autoSave → Debounced (5 seconds) → API call
autoSaveImmediate → Instant → API call
Date/Time Preservation
When editing date/time pickers:
- Changing the date preserves the existing time
- Changing the time preserves the existing date
This prevents accidentally clearing time values when adjusting dates.
Related Features
- Digital Signatures - Triggers immediate save on verification
- Document Forms - Form architecture overview
- Print & Export - Exports latest saved form data