Skip to content

[P2] Audit: Tool buttons and action naming are inconsistent across pages #159

Description

@baixiangcpp

Imported from the byteflow.tools deep audit on 2026-06-22.

Problem: tool actions use inconsistent labels and ordering across pages. Examples include Try Example, Sample, Reset, Clear, Clear All, Format, Minify, Run, Preview, Copy, Copy Output, Download, Export JSON, Share URL, and Send to. Users should learn one interaction pattern and reuse it across tools.

Affected components:

  • Tool action bars
  • Output panel copy/download controls
  • Pipeline Builder action controls
  • External-request tool actions

Reproduction steps:

  1. Open JSON Formatter, Base64 Encode/Decode, Regex Tester, Image Resizer, YouTube Thumbnail Grabber, and Pipeline Builder.
  2. Compare button order, labels, disabled states, and success feedback.
  3. Check mobile wrapping and keyboard order.

Expected behavior: action names and button order should be standardized by action type.

Actual behavior: actions are understandable individually, but the vocabulary and ordering differ across tools.

Impact: inconsistent learning model, higher cognitive load, and more QA surface area.

Proposed fix:

  • Define a global action convention: Sample, Reset, Clear, Run/Generate, Copy, Download/Export, Share.
  • Use the same order and disabled-state rules across tools.
  • Standardize success toasts and error states.
  • Add a shared ToolActionBar component.

Acceptance criteria:

  • Priority tools follow the same action order and naming.
  • Copy/download/share states are consistent.
  • Keyboard tab order follows visual order.
  • Regression tests verify disabled/enabled states.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions