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 |
|---|---|---|
| Manager / author | Web | Create drafts from templates, edit blocks, preview, publish / unpublish |
| Employee | Desktop widget | See published cards addressed to them (always-on-top sticky) |
Authoring requires scorecard access and org scope appropriate to the recipient. Employees do not edit cards on desktop.
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 |
| 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