Dashboard
The Dashboard shows an overview of your testing activity and gives you quick access to common tasks.
Overview
When you first open Flowguard, you'll land on the Dashboard. This page shows:
- Statistics about your flows
- Recent flows and their results
- Quick actions for common tasks
- System status information
- Monitoring widget (when monitoring is enabled)
- Reports widget (quick access to generate reports)
Statistics section
The top of the dashboard displays metrics in cards:
Total flows
The total number of test flows you've created.
Active flows
How many flows are currently active and ready to run.
Passed tests
Flows that passed their last run (green checkmark).
Failed tests
Flows that failed their last run (red X). These need attention.
Pending tests
Flows that haven't been run yet or are waiting to execute.
Running tests
Flows currently in progress, if any.
Status colors
Flowguard uses color coding to identify flow states at a glance:
- Green - Passed (everything worked)
- Red - Failed (something went wrong)
- Yellow/Orange - Running (currently executing)
- Gray - Pending (not yet run)
- Blue - Inactive (paused)
Recent flows section
Below the statistics, you'll see your most recently modified flows. Each flow card shows:
- Flow name - The title you gave the flow
- Status badge - Active or Inactive
- Last run result - Passed, Failed, or Not Run
- Last run time - When the flow was last executed
- Number of steps - How many steps the flow contains
- Action buttons - Run, Edit, or more options
Flow card actions
Each flow card has action buttons:
- Play button - Run the flow immediately
- Edit button - Open the flow in the editor
- Three-dot menu - Additional options:
- Duplicate the flow
- Toggle active/inactive status
- Delete the flow
Quick actions
Create new flow
Opens the flow editor so you can start building a new test flow.
Run all active flows
Runs every active flow at once. Useful after making changes to your site.
View all flows
Goes to the Flows page, where you can see the full list with filtering and search.
System status indicator
At the top of the Dashboard, a status indicator shows:
- Green dot + "All systems operational" - Everything is working
- Yellow dot + Warning message - Minor issues detected
- Red dot + Error message - Something needs attention
Monitoring widget
When website monitoring is enabled (in Settings > Features), a monitoring widget appears showing:
- Current site status - Whether your website is up and responding
- Uptime percentage - Site availability over the last 30 days
- Average response time - How quickly your site responds
- Recent incidents - Summary of any downtime events
- Mini trend chart - Visual overview of recent data
- Quick link - Jump to the full monitoring dashboard
See the Monitoring Guide for setup details.
Reports access
The Dashboard also links to the Reports feature:
- Generate Report Button - Create an on-demand PDF report from monitoring data
- View Reports Link - Open the full Reports interface to manage templates and schedules
See the PDF Reports Guide for more on creating reports.
Using the dashboard
Regular check-ins
Check the Dashboard regularly to:
- Monitor pass/fail rates
- Spot flows that frequently fail
- Make sure your tests are running as expected
After updates
Visit the Dashboard after changes to your site:
- After WordPress updates
- After plugin updates
- After theme changes
- After content modifications
Run your flows to confirm everything still works.
Dealing with failed tests
When you see failed tests:
- Click the flow to see details
- Review the error messages
- Fix the underlying issue
- Re-run the flow to verify the fix
Use clear names
Descriptive flow names make the Dashboard much easier to scan:
- Good: "Login Form - Valid Credentials"
- Good: "Contact Form - Required Fields"
- Bad: "Test 1"
- Bad: "New Flow"
Understanding test results
Passed test
A flow passes when:
- All steps executed successfully
- No errors occurred
- All assertions were true
- The flow completed within the timeout period
Failed test
A flow can fail for several reasons:
- An element couldn't be found (selector issue)
- An assertion failed (expected content wasn't there)
- A page didn't load (timeout or network error)
- JavaScript errors on the page
Click a failed flow to see which step caused the failure, the error message, and suggestions for fixing it.
Pending test
A flow shows as pending when:
- It's newly created and hasn't been run yet
- It's inactive and not scheduled
- It's waiting in queue behind other flows
Filtering and viewing
Quick filter buttons
At the top of the recent flows section, filter buttons let you narrow down the list:
- All - Show all flows
- Active - Show only active flows
- Inactive - Show only inactive flows
View more flows
If you have many flows, the Dashboard only shows the most recent ones. Click View All Flows to see the complete list with search and filtering.
Empty state
If you haven't created any flows yet, the Dashboard shows:
- A welcome message
- Information about getting started
- A "Create Your First Flow" button
Click it to start building your first test flow.
Next steps
- Managing Flows - Create, edit, and organize flows
- Flow Editor - The editor interface
- Running Flows - Execution and results
- Website Monitoring - Automated site health monitoring
- PDF Reports - Generate monitoring reports
- WooCommerce Testing - Test WooCommerce checkouts safely
Troubleshooting
Dashboard not loading
If the Dashboard doesn't load or shows an error:
- Refresh the page
- Check your WordPress admin permissions
- Make sure Flowguard is properly activated
- Check browser console for errors
Statistics not updating
If statistics look outdated:
- Refresh the page
- Run a flow to trigger an update
- Check if flows are completing successfully
Missing flows
If you can't see flows you created:
- Check if you're on the right WordPress site
- Verify the flows weren't accidentally deleted
- Try viewing All Flows instead of just recent ones