Troubleshooting

This guide helps you resolve common issues when using State App.

Common Issues

Issue: Data Not Persisting Between Sessions

Symptoms:

• Previously entered data is missing when you return to the app
• Section completion status resets unexpectedly
• Wizard progress is lost

Cause: State App stores data in browser localStorage. This can be cleared by browser settings, private browsing mode, or storage quota limits.

Solution:

1. Check browser settings

   • Ensure localStorage is not disabled
   • Verify the site is not in a blocklist for storage

2. Avoid private/incognito mode

   • Private browsing clears localStorage when the window closes
   • Use a regular browser window for persistent data

3. Check storage quota

   • Clear other site data if storage is full
   • Export important data before clearing

4. Verify localStorage manually

   // Open browser console (F12) and check:
   localStorage.getItem('state-business-planning')
   

Issue: Wizard Won't Advance to Next Step

Symptoms:

• Clicking "Next" does nothing
• Form appears stuck on current step
• Progress indicator doesn't update

Cause: Form validation is failing on required fields or data format issues.

Solution:

1. Check for validation errors

   • Look for red error messages below form fields
   • Ensure all required fields have values

2. Verify data formats

   • Email fields must contain valid email addresses
   • URL fields must include the protocol (https://)
   • Number fields must contain numeric values only

3. Review required fields for each step

4. Refresh and retry
   • Save current progress if possible
   • Refresh the page and return to the wizard

Issue: Dashboard Shows Incorrect Metrics

Symptoms:

• Metrics don't match entered data
• Charts display unexpected values
• Completion percentage seems wrong

Cause: Data may be cached or there's a mismatch between wizard and dashboard data sources.

Solution:

1. Refresh the dashboard

   • Navigate away and back to the dashboard
   • Force refresh with Ctrl/Cmd + Shift + R

2. Verify the section is marked complete

   • Check the sidebar for a completion checkmark
   • If missing, return to the wizard and click "Complete"

3. Check raw data

   // In browser console, check the section data:
   JSON.parse(localStorage.getItem('state-product-info'))
   

4. Re-save the section

   • Return to the section's setup wizard
   • Navigate through steps without changing data
   • Click "Complete" to re-save

Issue: App Won't Load or Shows Blank Screen

Symptoms:

• The app shows a white/blank screen
• Loading indicator spins indefinitely
• Console shows JavaScript errors

Cause: Browser compatibility issues, JavaScript errors, or corrupted state.

Solution:

1. Check browser compatibility

   • Use a modern browser (Chrome, Firefox, Safari, Edge)
   • Update to the latest browser version

2. Clear corrupted state

   // In browser console, clear State App data:
   Object.keys(localStorage)
     .filter(key => key.startsWith('state-'))
     .forEach(key => localStorage.removeItem(key));
   

   Note: This will delete all your entered data.

3. Disable browser extensions

   • Ad blockers or privacy extensions may interfere
   • Try in a clean browser profile

4. Check console for errors

   • Open developer tools (F12)
   • Look for red error messages in Console tab
   • Report specific errors to support

Issue: Charts Not Rendering

Symptoms:

• Dashboard shows empty chart areas
• "No data" message where charts should be
• Partial chart rendering

Cause: Missing data, browser compatibility with Recharts library, or rendering issues.

Solution:

1. Ensure section data exists

   • Complete the section's setup wizard first
   • Verify data is saved with completion checkmark

2. Check for required chart data

   • Goals section: Need goals with both target and current values
   • Design section: Need features with status or milestones with dates
   • Sales targets: Need numeric values for monthly/quarterly/annual

3. Try a different browser

   • Recharts works best in Chrome and Firefox
   • Update your browser if using an older version

4. Resize the browser window

   • Some charts require re-render on resize
   • Expanding/collapsing the sidebar may help

Issue: Unable to Edit Completed Section

Symptoms:

• Can't find the edit option
• Changes not saving after completion
• Dashboard doesn't reflect updates

Cause: Navigation confusion or improper save procedure.

Solution:

1. Access the setup wizard

   • Navigate to the section from the sidebar
   • Click Setup or Edit button in the dashboard header

2. Make your changes

   • Navigate through wizard steps
   • Update the fields you want to change

3. Save properly

   • Navigate to the final step
   • Click Complete to save all changes

4. Verify on dashboard

   • Return to the section dashboard
   • Confirm metrics reflect your changes

Clearing All Data

If you need to start fresh, you can clear all State App data:

// Run in browser console (F12):
const stateKeys = Object.keys(localStorage).filter(k => k.startsWith('state-'));
stateKeys.forEach(k => localStorage.removeItem(k));
console.log(`Cleared ${stateKeys.length} State App entries`);

Warning: This permanently deletes all your product lifecycle data.

Getting Help

If you cannot resolve your issue:

1. Check the FAQ for additional answers
2. Gather diagnostic information:
   • Browser name and version
   • Steps to reproduce the issue
   • Console error messages (if any)
   • Screenshots of the problem
3. Contact support with the above information