Dashboard
The Dashboard is your central hub for monitoring all your automated test flows. It provides an at-a-glance overview of your testing activity and quick access to important features.
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 key metrics in cards:
Total Flows
Shows the total number of test flows you've created.
Active Flows
Displays how many flows are currently active and ready to run.
Passed Tests
Shows the number of flows that passed their last run (indicated by a green checkmark).
Failed Tests
Displays flows that failed their last run (indicated by a red X). Failed flows need attention.
Pending Tests
Shows flows that haven't been run yet or are waiting to execute.
Running Tests
Indicates flows currently in progress (if any).
Understanding Status Colors
Flowguard uses color coding to help you quickly identify flow states:
- Green - Passed tests (everything worked correctly)
- Red - Failed tests (something went wrong)
- Yellow/Orange - Running tests (currently executing)
- Gray - Pending tests (not yet run)
- Blue - Inactive flows (paused)
Recent Flows Section
Below the statistics, you'll see a list of your most recently modified flows. Each flow card displays:
- 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 are in the flow
- Action buttons - Quick access to 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 - Access additional options:
- Duplicate the flow
- Toggle active/inactive status
- Delete the flow
Quick Actions
The Dashboard provides quick action buttons for common tasks:
Create New Flow
Click this button to jump directly to the flow editor and start creating a new test flow.
Run All Active Flows
Execute all active flows at once. This is useful for running comprehensive tests after making changes to your site.
View All Flows
Navigate to the Flows page to see a complete list of all your test flows with filtering and search options.
System Status Indicator
At the top of the Dashboard, you'll see a system status indicator:
- Green dot + "All systems operational" - Everything is working correctly
- Yellow dot + Warning message - Minor issues detected
- Red dot + Error message - Critical issues that need attention
Monitoring Widget
When website monitoring is enabled (in Settings > Features), a monitoring widget appears on the Dashboard 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 monitoring data
- Quick link - Jump directly to the full monitoring dashboard
See the Monitoring Guide for details on setting up and using website monitoring.
Reports Access
The Dashboard provides quick access to the Reports feature:
- Generate Report Button - Create an on-demand PDF report from monitoring data
- View Reports Link - Access the full Reports interface to manage templates and schedules
See the PDF Reports Guide for details on creating automated reports.
Tips for Using the Dashboard
Regular Monitoring
Check the Dashboard regularly to:
- Monitor test pass/fail rates
- Identify problematic flows that frequently fail
- Ensure critical tests are running as expected
After Updates
Visit the Dashboard after making changes to your site:
- After WordPress updates
- After plugin updates
- After theme changes
- After content modifications
Run your flows to ensure everything still works correctly.
Prioritize Failed Tests
When you see failed tests on the Dashboard:
- Click on the flow to see details
- Review the error messages
- Fix the underlying issue
- Re-run the flow to verify the fix
Organize with Names
Use clear, descriptive names for your flows so you can quickly identify them on the Dashboard:
- ✅ "Login Form - Valid Credentials"
- ✅ "Contact Form - Required Fields"
- ❌ "Test 1"
- ❌ "New Flow"
Understanding Test Results
Passed Test
When a flow passes, it means:
- All steps executed successfully
- No errors were encountered
- All assertions (checks) 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 present)
- A page didn't load (timeout or network error)
- JavaScript errors on the page
When a flow fails, click on it to see:
- Which step caused the failure
- The error message
- Suggestions for fixing the issue
Pending Test
A flow shows as pending when:
- It's newly created and hasn't been run yet
- It's inactive and not scheduled to run
- It's waiting in queue behind other flows
Filtering and Viewing
Quick Filter Buttons
At the top of the recent flows section, you'll find filter buttons:
- All - Show all flows
- Active - Show only active flows
- Inactive - Show only inactive flows
View More Flows
If you have many flows, the Dashboard shows only the most recent ones. Click View All Flows to see the complete list with advanced filtering and search capabilities.
Empty State
If you haven't created any flows yet, the Dashboard will show an empty state with:
- A welcome message
- Information about getting started
- A prominent "Create Your First Flow" button
Click the button to start building your first test flow!
Next Steps
- Managing Flows - Learn how to create, edit, and organize flows
- Flow Editor - Master the flow editor interface
- Running Flows - Understand execution and results
- Website Monitoring - Set up automated site health monitoring
- PDF Reports - Generate professional 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
- Ensure Flowguard is properly activated
- Check browser console for errors
Statistics Not Updating
If statistics appear 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 in the right WordPress site
- Verify the flows weren't accidentally deleted
- Try viewing All Flows instead of just recent ones