Study setup
A React block (a whole screen) in Beamline's Research & design app.
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 (people from a panel, matched to an audience and screened, or people invited by link), its name, scenario and tasks; everything still missing is listed before launch, preview shows what a participant sees, and the test launches now or on a date, or goes for review when the workspace approves tests first. Screener: questions with one or several answers, each accepting, rejecting or not mattering (a stripe says which); a question where every answer rejects is flagged and blocks launch, one with no accepting answer is said; trying the screener as a participant says whether they'd be invited and why not; the questions save as a template.
Use it for
- Setting up a usability test, survey or interview round with who takes it and what they do.
- Any recruitment form where answers decide who is invited and launch waits until everything is in.
Not for
- Building the questions of a learner's quiz (question-builder).
- Ordering a study's blocks and their branches (study-flow).
Anatomy
- header: the product's mark, the test's name, Test or Screener
- test: what's tested, who takes it, name, country and participants (panel only), address by target, scenario, tasks
- screener: questions with one or several answers, each answer's text and outcome, duplicate and remove; problems per question
- side (test): what's missing, preview, launch now or on a date, the result
- side (screener): the screener tried as a participant with its verdict, save as a template
States
- missing: listed (amber) until everything is in; launch and preview off
- ready: said (green); preview open
- launched, scheduled (green); sent for review (amber)
- invite link shown after launch by link
- screener: every answer rejects (red, blocks launch), no accepting answer (amber), answers without text counted
- trying: questions left, eligible (green), not eligible with the reason (red)
- template saved
- phone: one column
- right to left: the page mirrors
Keyboard
- Tab through every field; arrows choose cards, answers and outcomes; Enter or Space presses buttons
Motion
Nothing moves; changes appear on input.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
defaultDraft | Partial<StudyDraft> | — | |
defaultQuestions | ScreenerQuestion[] | — | |
defaultTab | "screener" | "test" | — | |
countries | { value: string; label: string; }[] | — | Countries the panel can recruit from. |
reviewRequired | boolean | — | The workspace approves tests before they launch. |
onLaunch | ((draft: StudyDraft, questions: ScreenerQuestion[], when: Date | null) => void) | — | |
onSaveTemplate | ((name: string, questions: ScreenerQuestion[]) => 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
- Avatar
- Button
- Calendar
- Checkbox
- Date picker
- Dropdown menu
- Inline edit
- Input
- Label
- Number field
- Radio group
- Segmented control
- Select
- Spinner
- Text morph
- Textarea
- Tooltip
Import
import { StudySetup } from "@beamline/study-setup";Get it
Study setup 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 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…
- 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…