Tree test
A React block (a whole screen) in Beamline's Research & design app.
A tree test: build a navigation tree and read where people went. Build: pages added at the top or under any page, indented under the page above or moved up a level, removed with everything under them (the count said), named, and marked as right answers for the task; shuffling is per participant; pages without names and a task without a right answer are said, and published locks the shape while names still edit. The participant preview walks the tree level by level and says whether the chosen page is right. Results: outcomes (direct success, indirect success after going back up, wrong page) with counts out of the total, where people ended with right pages marked, a page renamed since shown by its current name with the old one, a removed page said, and the most common paths with backtracking marked and ties said; one response is said to be one person's path, not a pattern.
Use it for
- Testing whether people can find things in a site's or app's navigation before it's designed.
- Any study that compares where people looked with where things are.
Not for
- Editing a real site's menu (tree-view, sortable).
- Clickable prototype tasks (prototype-task).
Anatomy
- header: the product's mark, the title and study, Build or Results
- build: the task; the tree's pages with name, right answer, add under, move up a level, indent, remove; add a top-level page; shuffle; problems
- preview: the task and a phone walking the tree, back up, choose the page, the verdict
- results: response count, outcomes with counts and bars, where people ended with right pages marked, most common paths
States
- build: pages without names (amber), no right answer (red), published (shape locked)
- preview: walking, chosen right (green), chosen wrong (red)
- results: none yet, one response (said), renamed page (old name shown), removed page (red), tied paths (said)
- phone: one column
- right to left: the page mirrors
Keyboard
- Tab through pages and their actions; Enter or Space presses; the preview's rows open with Enter
Motion
Nothing moves; changes appear on input.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
study (required) | string | — | |
defaultTask (required) | string | — | |
defaultNodes (required) | TreeNode[] | — | |
responses | TreeResponse[] | — | |
defaultView | "build" | "results" | — | |
defaultShuffle | boolean | — | |
published | boolean | — | The study is published: the tree's shape is locked, names aren't. |
onChange | ((state: { task: string; nodes: TreeNode[]; shuffle: boolean; }) => void) | — | |
product | string | — | Your product's name, shown as its mark. |
className | string | — | Classes on the documented visual root; no override by default. |
ref | Ref<HTMLDivElement> | — | Receives the documented native target or imperative handle; omitted by default. |
Built from
Import
import { TreeTest } from "@beamline/tree-test";Get it
Tree test is part of Beamline UI. Install the parts you need in your React app as compiled packages or editable source. Get Beamline · Connect your agent
More in Research & design
- Research synthesis: A research study turned into evidence in one place. Transcripts: passages marked as accepted highlights or as the assistant's suggestions (dashed)…
- Study setup: Set up an unmoderated test and its screener. Test: what's tested (a website, a prototype by its share link, an app by its store page), who takes it…
- Study flow: A study's blocks in order, each with where people go next. A block that routes by its answer (multiple choice, scale, open question, prototype task) has…
- Participant review: One participant's session, answer by answer, beside the list of everyone who took the study. The list filters (finished, left early, with a recording)…
- Click heatmap: One screen of a usability task as it looked (your prototype's frame or a page built from your parts, scaled into a phone) with where people clicked over…
- Prototype task: A prototype task in a study. The linked prototype refreshes from the design keeping the task and paths (a start screen gone from the new version said, a…
- Task results: A usability task's results, from headline outcomes down to paths and screens. Outcomes (direct success, indirect success, gave up) say their share and…
- Matrix question: A matrix question and the participant's side of it, side by side. Rows (up to ten) share one set of choices (two to seven); Enter adds a row, several…
- Prototype review: Reviewing a design file's clickable prototype. Present: the board on a stage with its wireframe, the flow chosen (an unavailable one can't be), Back…
- Report builder: Build a chart from your metrics without code: choose metrics, how to group them over time, an optional breakdown, filters, the range and the chart, see…
- Report library: A business's reports in one place. The directory: reports by topic and group with search, each with what it answers; one this person can't open says why…
- Review page builder: Building the page reviewers use to go through records one by one. The queue of records (one with no title shows its id instead of a blank); the record as…
- Database builder: What a database does for the people who use it, built in one place. Templates: starting values per property (a relation default points at an existing…
- Workflow builder: Automation rules for a SaaS without code: a trigger, conditions built with the query builder that branch into Yes and No, actions and waits, drawn as a…
- Workflow library: The automation library: every automation as a row (what starts it, whether it's live, a draft or paused, who owns it, when it last ran, and its runs this…
- Drawing board: A whiteboard a team already knows how to use, like FigJam: tools in a floating bar at the bottom (Select V, Hand H, Sticky note S, Shape R/O/D, Connector…
- Model workbench: A CAD model's workbench around a large isometric scene of its bodies, each shaded from its material's appearance with a soft ground shadow and an axis…
- Component properties: A design system component from three sides. Its variants as a matrix on two chosen properties, the others filtering it, each cell drawing the variant; a…
- Slot editor: Slots in a design system component, from making to filling. The main component's layer tree with a checkbox per layer: a nested frame converts to a slot…