Weekly Kudos
Web: /scorecard/weekly-kudos (list) · /scorecard/weekly-kudos/:kudosId (designer)
Desktop: sticky widget window (#/kudos-widget)
API: /v1/scorecard/weekly-kudos, /v1/scorecard/weekly-kudos/me
Weekly Kudos are recognition cards managers design on web and employees view on the desktop sticky widget. They present recognition (and optional live BSC score bindings) — they are not a scored scorecard entry type.
Who does what
| Role | Client | Actions |
|---|---|---|
| Author (access level 2+) | Web | Create drafts from templates, edit blocks, preview, publish / unpublish, delete drafts |
| Employee | Desktop widget | See published cards addressed to them (always-on-top sticky) |
Authoring uses scorecard submit permission (level 2+), not the usual “edit after submit” gate that applies to scored entries (ATW, SBS, and so on). Recipients must be active employees in the author’s org scope. Scorecard (BSC) status is not required — people with Scorecard off can still receive a card if they are in that manager’s pool. Employees do not edit cards on desktop.
Level 1 cannot open the Weekly Kudos list. Scheduled week/month locks still apply to create / save / delete when Weekly Kudos is on a lock list (it is not on the default lists).
Web — list and designer
List (/scorecard/weekly-kudos)
- Filter and browse drafts and published cards in scope.
- Open a card to enter the designer, or create a new one.
Designer (/scorecard/weekly-kudos/:kudosId)
Fixed-size, block-based card (not a freeform canvas):
| Principle | Behavior |
|---|---|
| Bounded canvas | Width 360px; height 480–600px |
| Blocks | Stack of bands, text, KPM sections, lists, variables — restylable |
| Templates | Start from a preset, then customize |
| Variables | Tokens such as employee name, week label, date, score bindings resolve at preview and publish |
| Same document | Designer preview and desktop widget share one JSON card document |
Optional background upload. Publish stores a resolved document snapshot so the widget can render without re-querying live scores for every open.
Non-goals (current product): push notification on publish, freeform drawing, PowerPoint export, editing from desktop.
Desktop sticky widget
| Behavior | Detail |
|---|---|
| Window | Second Electron window — frameless, always-on-top, skip taskbar; height follows card |
| Audience | Signed-in user; only published cards where employee_id is self (BSC status is not required) |
| API | GET /v1/scorecard/weekly-kudos/me?limit=20 |
| Poll | About every 30s while the widget is open |
| Stack | One card at a time; prev/next when multiple (newest first) |
| Open | Opens with the app; tray can Bring Weekly Kudos to front / Send Weekly Kudos back |
| Send back | Clears always-on-top (not dismissible). Close / Alt+F4 sends back; destroy only on quit |
| Fade | Off by default — Settings → Appearance → optional fade when out of focus + opacity |
Publish on web appears on desktop after the next poll (≤30s) or when the widget is reopened.
Related
- Scorecard — scored entry types (separate from kudos)
- Desktop app — tray, Appearance, widget
- Dashboard overview — score pages
- What's in Ascendly