Usage
Import the Gleap SDK in your app. This will register a custom web component. You can then add the following web component to your app, to display your desired checklist.Available attributes
checklistId: This is the ID of your checklist info: Show / hide the info label progressbar: Show / hide the progress bar dark: Toggle dark mode floating: Enable floating mode sharedKey: Sync a checklist accross resourcesShared key
Use thesharedKey
property to synchronize checklist progress across multiple resources.When any user updates a checklist that has the same
sharedKey
, everyone else—no matter which widget, page, or device they’re on—will immediately see the updated status.
- Collaboration made easy | Perfect for project dashboards, sprint boards, or any place where several people need to track a single source‑of‑truth checklist.
- One key, one state | All instances that share the key stay in lock‑step; remove the key and each checklist becomes independent again.
- Zero extra code | Just add the same
sharedKey
value wherever you want progress to be shared.
Pick a descriptive key (e.g.,
project-128374
) so it’s clear what the checklist represents.Floating checklist component
If you want to add the checklist to the navbar or sidebar, just enable the floating option by adding the floating attribute.Dark mode
You can toggle the dark mode by adding thedark="true"
attribute.

TypeScript (React, Vue, Angular)
To enable full TypeScript support for the<gleap-checklist>
custom element, add the following declaration to your global.d.ts
file:
This ensures proper type checking and IntelliSense when using the custom
element in your JSX.
Custom CSS
The<gleap-checklist>
component uses Shadow DOM to encapsulate its internal styles. To allow customization, it exposes specific elements via the part
attribute.
You can override these styles globally using the ::part()
pseudo-element.
Example
Replace colors and styles as needed to match your brand.
Available parts
Part name | Description |
---|---|
content | Wrapper of the entire checklist content |
info | Section with title, description, sender |
info-title | Checklist title |
info-description | Subtitle/description text |
sender | Sender container |
sender-image | Sender profile image |
sender-name | Sender name |
progress-labels | Labels showing progress information |
progress-label-primary | Main progress label |
progress-label-secondary | Secondary progress label |
progress-bar | Container for the progress bar |
progress-bar-progress | The inner fill of the progress bar |
tasks | Container for all tasks |
task | Wrapper for a single task |
task-header | Clickable task header |
task-badge | Task number badge |
task-header-title | Task title text |
task-header-chevron | Chevron icon for expand/collapse |
task-body | Expandable container for task content |
task-body-inner | Inner container inside task body |
task-body-content | Descriptive text inside task body |
task-action | Container for action buttons |
task-mark-done | Container for the “Mark as done” action |