Frequently Asked Questions

Find answers to common questions about State App.

General

What is State App?

State App is a product lifecycle state management application within the FlowState platform. It provides wizard-driven data collection and dashboard visualization for eight key areas of product development: Business Planning, Product Info, Goals & Objectives, Design & Roadmap, Development, Deployment, Support, and Marketing.

Who should use this app?

State App is designed for teams involved in product development:

Do I need to complete all sections?

No. While the app is designed for comprehensive lifecycle tracking, you can use only the sections relevant to your needs. The Global Dashboard shows progress across all sections, but each section functions independently.

Data & Storage

Where is my data stored?

All data is stored locally in your browser's localStorage. Data persists between sessions on the same browser and device but is not synced across devices or shared with other users.

Can I export my data?

Currently, State App does not have a built-in export feature. You can access raw data through browser developer tools:

// In browser console:
const data = {};
Object.keys(localStorage)
  .filter(k => k.startsWith('state-'))
  .forEach(k => data[k] = JSON.parse(localStorage.getItem(k)));
console.log(JSON.stringify(data, null, 2));

Is my data backed up?

No. Data exists only in your browser's localStorage. Consider periodically copying your data using the console method above if you need backups.

Can I share my data with team members?

Currently, data is stored locally and cannot be directly shared. Each team member maintains their own copy. Future versions may include cloud sync and team sharing capabilities.

Features

How do I complete a section?

Each section follows the same workflow:

1. Navigate to the section from the sidebar
2. Click Setup to open the wizard
3. Complete each step of the wizard
4. Click Complete on the final step
5. View the Dashboard to see your metrics

Can I edit a completed section?

Yes. Navigate to the section and click Setup or Edit in the dashboard header. Make your changes through the wizard steps, then click Complete to save.

What do the checkmarks in the sidebar mean?

A checkmark next to a section name indicates that section has been completed. This means:

• All wizard steps have been filled out
• The Complete button was clicked
• Data is saved to localStorage with a completedAt timestamp

How is the overall progress calculated?

The Global Dashboard calculates overall progress as:

Progress = (Completed Sections / Total Sections) x 100

With 8 total sections, each completed section adds 12.5% to your overall progress.

Wizards & Forms

What happens if I leave the wizard without completing it?

Your progress is saved as you go. When you return to the wizard, you can continue from where you left off. However, the section won't be marked as complete until you click Complete on the final step.

Why can't I proceed to the next step?

The wizard validates your input before allowing you to proceed. Check for:

• Empty required fields (marked with asterisk or red outline)
• Invalid formats (emails, URLs, numbers)
• Error messages below form fields

Can I skip steps in the wizard?

No. The wizard is designed to be completed sequentially. Each step may depend on information from previous steps. However, you can leave fields empty if they're not required.

How do I add multiple items (goals, team members, etc.)?

For sections with lists (like goals, team members, or environments):

1. Click the Add button to create a new item
2. Fill in the item's details
3. Repeat to add more items
4. Remove items by clicking the Delete or X button

Dashboards

What metrics are shown on section dashboards?

Each section dashboard displays metrics relevant to that area:

Why are my charts empty?

Charts require data to display. Ensure:

• The section's wizard is fully completed
• Required fields for chart data are filled (e.g., goals need targets and current values)
• The section is marked as complete

What chart types are available?

State App uses three chart types via Recharts:

• Line Charts - Time series and trends
• Bar Charts - Comparisons across categories
• Pie Charts - Distribution and composition

Technical

Which browsers are supported?

State App supports the latest versions of:

• Google Chrome (recommended)
• Mozilla Firefox
• Apple Safari
• Microsoft Edge

Does the app work offline?

Yes. Since all data is stored in localStorage, the app functions fully offline after initial load. No internet connection is required for data entry or viewing dashboards.

What technologies does State App use?

State App is built with:

• React for the user interface
• React Router for navigation
• @rjsf/core for schema-driven forms
• Recharts for data visualization
• localStorage for data persistence

Is there an API?

State App currently operates as a frontend-only application with localStorage. There is no backend API. RxDB collection schemas are defined but not actively used for replication.

Still Have Questions?

If your question isn't answered here:

• Check Troubleshooting for common issues
• Review the Features documentation for detailed capabilities
• Contact support for additional help