Browsing Feedback

Once submissions start coming in, you'll want to triage them. The feedback:list Spark command gives you a quick filtered view straight from the terminal — no admin UI required.

Basic usage

php spark feedback:list

This returns up to 20 new items, sorted newest first:

+----+----------+--------+-----------+-------------------+----------+-----------------------------------------------------+
| ID | Category | Status | Cluster   | Email             | Platform | Message                                               |
+----+----------+--------+-----------+-------------------+----------+-----------------------------------------------------+
| 42 | bug      | new    | —         | —                 | windows  | The login button doesn't respond on mobile Safari    |
| 41 | ux       | new    | Login UX  | user@example.com  | —        | The password field loses focus when I tap it…        |
| 40 | feature  | new    | —         | —                 | —        | Could you add dark mode to the dashboard?             |
+----+----------+--------+-----------+-------------------+----------+-----------------------------------------------------+

Dismissed items are always hidden unless you ask for them explicitly.

Flags

--status

Filter by status. Accepted values match StatusEnum: new, reviewed, grouped, dismissed.

php spark feedback:list --status reviewed
php spark feedback:list --status dismissed

--category

Filter by category. Accepted values: bug, ux, feature, other.

php spark feedback:list --category bug

Combine with --status to narrow further:

php spark feedback:list --category bug --status reviewed

--cluster

Show only items belonging to a specific cluster. Pass the cluster ID.

php spark feedback:list --cluster 7

--ungrouped

Show only items that haven't been assigned to a cluster yet.

php spark feedback:list --ungrouped

This combines additively with --status, so you can find unreviewed orphans:

php spark feedback:list --ungrouped --status new

--limit

Override the default 20-row cap.

php spark feedback:list --limit 50

--platform

Filter by platform. Accepted values depend on your app's Config\Betta::$platforms list.

php spark feedback:list --platform windows

Output columns

Column	Description
ID	The feedback row's primary key
Category	bug, ux, feature, or other
Status	Current workflow status
Cluster	Cluster label, or — if ungrouped
Email	Submitter's email, or — if not provided
Platform	The tagged platform, or — if not provided
Message	First 50 characters of the submission (truncated with … if longer)

Next steps

• Collecting Feedback — how submissions are saved in the first place
• Models — query the feedback table directly when you need more power