Collaborative List
Everyone adds items to a shared list in real-time. Watch it grow as people contribute.
Activity type: collaborative_list
Configuration
| Property | Type | Description | Default |
|---|---|---|---|
maxItemsPerUser | number | Maximum number of items each participant can add. | 5 |
prompt | string | Optional prompt text to guide contributions (e.g., "What's your favorite book?"). | "" |
Behavior
- Participants type items and add them to the shared list.
- New items appear in real-time for all participants.
- Each participant can add up to
maxItemsPerUseritems. - Items show who added them (or "Anonymous" for anonymous participants).
- This is a multi-action activity.
Aggregated State
| Field | Type | Description |
|---|---|---|
items | ListItem[] | All items in the list. |
totalItems | number | Total number of items added. |
List Item Object
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the item. |
text | string | The item text content. |
addedBy | object | Participant who added the item (participantId, displayName). |
upvotes | number | Number of upvotes (not used in Collaborative List). |
downvotes | number | Number of downvotes (not used in Collaborative List). |
score | number | Net score (upvotes - downvotes). |
createdAt | string | Timestamp when the item was added. |
CSS Selectors
.fuse-collaborative-list, .fuse-list-item, .fuse-item-text, .fuse-item-author, .fuse-input, .fuse-submit-btn, .fuse-hint, .fuse-status
Ranked List
Add items and upvote or downvote others. A live community-driven leaderboard.
Activity type: ranked_list
Configuration
| Property | Type | Description | Default |
|---|---|---|---|
prompt | string | Optional prompt text to guide contributions. | "" |
maxItemsPerUser | number | Maximum number of items each participant can add. | 5 |
Behavior
- Participants add items to the list (up to
maxItemsPerUsereach). - All participants can upvote or downvote any item.
- Items are sorted by their net score (upvotes minus downvotes) in real-time.
- The leaderboard reorders as votes come in.
- This is a multi-action activity: participants can add items and vote throughout.
Aggregated State
| Field | Type | Description |
|---|---|---|
items | ListItem[] | All items sorted by score (highest first). |
totalItems | number | Total number of items. |
CSS Selectors
.fuse-ranked-list, .fuse-list-item, .fuse-item-text, .fuse-item-author, .fuse-score, .fuse-upvote, .fuse-downvote, .fuse-rank-number, .fuse-input, .fuse-submit-btn
Ranked Lists are excellent for brainstorming sessions where the team needs to surface the best ideas. The voting mechanism ensures that popular items rise to the top naturally.
Pros & Cons
Two-column debate board. Add arguments to the pros or cons side and see the collective wisdom.
Activity type: pros_and_cons
Configuration
| Property | Type | Description | Default |
|---|---|---|---|
topic | string | The topic being debated (e.g., "Remote work", "AI in education"). | "" |
Behavior
- Two columns are displayed side by side: Pros (green) and Cons (red).
- Participants add items to either column.
- Items within each column can be upvoted and downvoted.
- Items are sorted by score within their column.
- This is a multi-action activity.
Aggregated State
| Field | Type | Description |
|---|---|---|
pros | ListItem[] | Items in the Pros column, sorted by score. |
cons | ListItem[] | Items in the Cons column, sorted by score. |
CSS Selectors
.fuse-pros-and-cons, .fuse-side-column, .fuse-list-item, .fuse-item-text, .fuse-item-author, .fuse-score, .fuse-upvote, .fuse-downvote, .fuse-input, .fuse-submit-btn
Top N
Everyone submits their personal top picks. Results are aggregated into a master ranking.
Activity type: top_n
Configuration
| Property | Type | Description | Default |
|---|---|---|---|
n | number | How many items each participant selects for their top picks. | 3 |
options | array | Array of predefined options to choose from. Each has id, label, and optional color. | 3 default options |
Behavior
- A list of predefined options is displayed.
- Each participant selects their top
nitems (in ranked order). - Once submitted, the participant sees the aggregated results.
- Points are awarded based on rank: first place gets
npoints, second getsn-1, etc. - The master ranking is determined by total points across all participants.
- This is a single-action activity.
Aggregated State
| Field | Type | Description |
|---|---|---|
items | array | Options with id, label, points (total), and appearances (how many participants included it). |
n | number | The configured N value. |
totalParticipants | number | Total participants who submitted their picks. |
CSS Selectors
.fuse-top-n, .fuse-option, .fuse-option-label, .fuse-rank-number, .fuse-consensus, .fuse-status
Top N is perfect for scenarios like "Top 3 priorities for Q4" or "Your 5 favorite movies." The aggregation reveals the collective preferences of the group.
Rate & Reveal
Rate something 1-10 and see the live histogram of everyone's ratings.
Activity type: rate_and_reveal
Configuration
| Property | Type | Description | Default |
|---|---|---|---|
min | number | Minimum rating value. | 1 |
max | number | Maximum rating value. | 10 |
Behavior
- Participants select a rating between
minandmax. - After submitting, they see a live histogram showing the distribution of all ratings.
- The average rating is prominently displayed.
- This is a multi-action activity: participants can change their rating.
Aggregated State
| Field | Type | Description |
|---|---|---|
distribution | number[] | Count of ratings for each value (index 0 = min value, etc.). |
average | number | Mean rating across all participants. |
totalRatings | number | Total number of ratings submitted. |
CSS Selectors
.fuse-rate-and-reveal, .fuse-histogram, .fuse-histogram-bar, .fuse-stat-value, .fuse-stat-label, .fuse-option, .fuse-submit-btn
Common List Features
Upvoting and Downvoting
List activities that support voting (Ranked List, Pros & Cons, Q&A Board, Caption This) use a simple voting system:
- Upvote: Increases the item's score by 1.
- Downvote: Decreases the item's score by 1.
- Items are sorted by their net score (upvotes - downvotes).
- Each participant can vote once per item (up or down).
Item Attribution
Each item shows who contributed it:
- If the participant entered a name, their name is displayed.
- If anonymous, "Anonymous" is shown.
- The contributor's participant ID is tracked internally.
Real-Time Updates
All list activities update in real-time:
- New items appear instantly for all participants.
- Vote counts update live.
- Sort order adjusts as scores change.