Good troubleshooting preserves data and reduces variables. Start with observation, not deletion or repeated reconnects.
Do this
- Identify the affected workspace and one exact record.
- Check local save, sync, provider, and permission status.
- Try the same action once on a new test record.
- Restart Planner only after pending saves finish.
- Check for an update and review known service status if available.
Useful evidence
- Planner version and operating system
- Workspace and record title or safe identifier
- Exact time and time zone
- Steps that reproduce the problem
- Visible error code or connection status
- Whether another device shows the same state
Avoid first
- Deleting the app or data directory
- Emptying Trash
- Repeated full imports or backfills
- Disconnecting and reconnecting every provider
- Sharing secrets or full private databases
Scope
If only one record fails, focus on its data and relationships. If every workspace fails, focus on app, backend, account, or storage status.
Good to know
- Create an export before any recovery step that can overwrite state.
- A screenshot is useful, but redact private contact and financial details.