Troubleshooting

This guide covers common issues you may encounter while using the Projects App and how to resolve them.

Common Issues

Issue: Timer Not Stopping or Starting

Symptoms:

• Clicking the play/stop button doesn't respond
• Timer shows incorrect elapsed time
• Active timer pill doesn't appear in header

Cause: Timer state may be out of sync, possibly due to browser tab being inactive for extended periods or network connectivity issues.

Solution:

1. Refresh the page (Ctrl/Cmd + R)
2. Check if the timer appears in the Active Timers modal (click the timer icon in the header)
3. If the timer is stuck, try clicking stop from the modal view
4. Clear browser local storage if issue persists:

   # In browser console
   localStorage.clear()
   

5. Reload the application

Issue: Tasks Not Appearing in My Day

Symptoms:

• My Day view shows no tasks
• Tasks with today's due date don't appear
• Completed tasks still showing

Cause: View scope may be incorrectly configured, or tasks may not meet the filter criteria.

Solution:

1. Check the scope dropdown - ensure it's set to the correct workspace/organization
2. Verify tasks have:
   • Due date set to today (for Today view)
   • Due date within the week (for Week view)
   • Status is not "Complete" (unless viewing completed tasks)
3. Check if you're the assignee on the tasks
4. Try switching view modes (Today/Week/Month) to refresh the data

Issue: Document Not Saving

Symptoms:

• Changes to document content aren't persisted
• Save button doesn't respond
• Error message when saving

Cause: Session may have expired, or there's a conflict with concurrent edits.

Solution:

1. Copy your unsaved content to clipboard as backup
2. Refresh the page and check if you're still logged in
3. Navigate back to the document and try saving again
4. If error persists, try creating a new document with the content
5. Check network connectivity in browser DevTools

Issue: Time Entries Not Aggregating Correctly

Symptoms:

• Time totals don't match individual entries
• Statistics widget shows incorrect data
• Milestone time tracking is missing entries

Cause: Time entries may be associated with wrong entities, or there's a data synchronization issue.

Solution:

1. Navigate to the task detail and verify time entries are correctly attached
2. Check that time entries have valid start and end times
3. Refresh the page to re-fetch time tracking data
4. Verify the time period filter in statistics views
5. If aggregation is still wrong, check if entries have entityType and entityId properly set

Issue: Calendar Events Not Displaying

Symptoms:

• Calendar view is empty
• Tasks with due dates don't appear on calendar
• Drag-drop not working

Cause: Calendar data filtering may be excluding items, or JavaScript errors are preventing render.

Solution:

1. Check the calendar filters - ensure task/milestone/time entry filters are enabled
2. Verify tasks have due dates set
3. Open browser console (F12) and check for JavaScript errors
4. Try switching calendar views (Day/Week/Month)
5. Clear browser cache and reload

Issue: Approval Workflow Stuck

Symptoms:

• Document shows "Pending" but no approval options
• Can't approve or reject a document
• Approval history not loading

Cause: You may not have approval permissions, or the approval request is malformed.

Solution:

1. Verify you are listed as an approver on the document
2. Check if the document status is "Pending Approval"
3. Try opening the document detail view directly
4. If you created the document, you cannot approve your own document
5. Ask the document author to verify the approval request was submitted

Issue: Recurring Task Instances Not Generated

Symptoms:

• Created a recurring task but no future instances appear
• Recurrence pattern shows but tasks aren't created
• Pattern preview worked but actual tasks missing

Cause: Background recurrence processor may not have run, or the pattern has an end date that has passed.

Solution:

1. Verify the recurrence pattern settings:
   • Start date is in the past or today
   • End date is in the future (or set to "Never")
   • Occurrence count hasn't been reached
2. Wait a few seconds for background processing to complete
3. Refresh the task list
4. Check if the parent task has recurrencePattern field populated
5. If still not working, try editing and re-saving the recurrence settings

Issue: Discussion Thread Not Loading

Symptoms:

• Discussion list shows spinner indefinitely
• Replies don't appear after posting
• File attachments fail to load

Cause: Large discussion threads may take time to load, or there's a pagination issue.

Solution:

1. Wait for the full thread to load (large threads use virtualization)
2. Scroll the discussion list to trigger lazy loading
3. Check if file attachments are within size limits
4. Refresh the page if replies don't appear
5. For file attachment issues, verify the file type is supported

Issue: Template Not Applying Correctly

Symptoms:

• Creating from template doesn't include all tasks
• Milestone dates not calculated correctly
• Template fields missing

Cause: Template structure may be outdated or has invalid references.

Solution:

1. Open the template in edit view and verify its structure
2. Check that all milestone and task relationships are valid
3. When applying template, verify the start date is correctly set
4. If dates are wrong, manually adjust after creation
5. Re-save the template if it was created with an older version

Performance Issues

Issue: Slow Page Load

Symptoms:

• Dashboard takes long to load
• Project list is sluggish
• Switching tabs causes delay

Cause: Large datasets or browser memory constraints.

Solution:

1. Close unused browser tabs
2. Clear browser cache and cookies
3. Use filters to reduce the number of displayed items
4. Check if browser extensions are interfering
5. Try using the app in an incognito/private window

Issue: High Memory Usage

Symptoms:

• Browser becomes unresponsive
• Page crashes after extended use
• Computer fans run constantly

Cause: RxDB reactive subscriptions may accumulate in long sessions.

Solution:

1. Refresh the page periodically during long sessions
2. Close the app tab when not actively using
3. Reduce the number of open detail views
4. Use pagination for large lists

Getting Help

If you can't resolve your issue:

1. Check the FAQ for additional answers
2. Review the Features documentation for correct usage
3. Search existing support tickets for similar issues
4. Contact support with:
   • Description of the issue
   • Steps to reproduce
   • Screenshots if applicable
   • Browser version and operating system
   • Any console errors (press F12 to open DevTools)

Collecting Debug Information

When reporting issues, include the following:

1. Browser: [Chrome/Firefox/Safari/Edge] version [X.X]
2. Operating System: [Windows/macOS/Linux] version [X.X]
3. App Version: [Check in app settings or footer]
4. Steps to reproduce:
   a. First step
   b. Second step
   c. ...
5. Expected behavior: [What should happen]
6. Actual behavior: [What actually happens]
7. Console errors: [Copy any red error messages from DevTools]