Prototype task
A React block (a whole screen) in Beamline's Research & design app.
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 failed fetch said with Try again) and unlinks only after asking. The task is a goal (reach a screen, or follow an exact path of screens, each with the end state its components must be in) or free exploration with no success path. Recording component changes and hover or drag asks first, because changing either clears the path; with no components it says there's nothing to record. Problems (a path not starting on the start screen, a repeated screen without an end state, a missing last end state, a path too short) are counted and listed; published locks the structure but not the wording, and preview shows the participant's start.
Use it for
- Setting a usability task on a clickable prototype with what counts as success.
- Any test where success is a sequence of screens and states, not just an end page.
Not for
- Presenting and sharing a prototype (prototype-review).
- Reading the task's results (task-results).
Anatomy
- header: the product's mark, the title and study, the problem count, Preview
- main: the task, goal or free exploration, start screen, success by a screen or an exact path, the path's steps with a picture of each screen, its end state, move earlier and remove, add a screen, problems
- side: the linked prototype with its screens, refresh and unlink, recording switches, the participant preview
States
- no prototype (said)
- refreshing, refreshed (green), refresh failed with Try again (red)
- unlink asked; recording change asked because the path clears
- no components detected (said)
- steps: end state set (green), needed (amber), not recorded (blue)
- problems counted (amber) or ready (green)
- published: structure locked, wording open
- phone: one column
- right to left: the page mirrors
Keyboard
- Tab through every field and step action; arrows pick options
Motion
Nothing moves; the refresh shows a spinner on its button.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
study (required) | string | — | |
prototype | { name: string; screens: PrototypeScreen[]; } | null | — | |
defaultValue (required) | PrototypeTaskValue | — | Initial selection when uncontrolled; omitted by default. |
onRefresh | (() => Promise<PrototypeScreen[]>) | — | Fetches the design's new version; the task and its paths are kept. |
onUnlink | (() => void) | — | |
onChange | ((value: PrototypeTaskValue) => void) | — | |
published | boolean | — | The study is published: structure is locked, wording isn't. |
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
- Avatar
- Button
- Dropdown menu
- Empty state
- Label
- Segmented control
- Select
- Skeleton
- Spinner
- Switch
- Text morph
- Textarea
- Tooltip
Import
import { PrototypeTask } from "@beamline/prototype-task";Get it
Prototype task 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…
- Tree test: 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…
- 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…