GitJam

Your GitLab work. Live on your board.

Paste any GitLab issue, merge request, epic, or milestone into a FigJam or Figma Design file — see it as a rich, live card that stays in sync.

---

What it does

Browse & Add (new in 0.6)

• Drop the Launcher once per file → click Browse GitLab → pick from your tabs (Recent Work Items, Recent Milestones, Search) → Add spawns an issue card on the board.
• Persistent settings — set your PAT and default scope (group or project) once; it's reused for every card.
• Light / dark theme toggle on the launcher; spawned cards inherit the theme.

View

• Work items as live cards — issues, merge requests, epics, milestones.
• Real GitLab data — title, state, labels with their actual colours, assignees, reviewers, milestone, dates.
• Everyone sees it — once one user loads a card, all board viewers see the data, no personal tokens required for viewers.
• Progress bar for epics showing open vs closed child issues.
• Auto-refresh when the board opens + a refresh button on every card.
• One click back to GitLab via the title link.

Edit (from the card's property menu)

• Close / Reopen issues, MRs, and epics. Milestones can be closed / reactivated. Merged or locked MRs are skipped.
• Edit labels & assignees on issues and MRs (colour-swatched picker + member list).
• Edit labels on epics (ancestor group labels included).
• All edits run through the same proxy and refetch the card on success.

Edit actions require a PAT with api scope (not just read_api); viewing works with read_api.

Install

Open Figma → Resources → Widgets → search "GitJam" → drop on the board.

(Community link will be added here once the listing is live.)

Quick start

1. Drop the GitJam Library widget on your board.
2. Open Settings, paste a GitLab Personal Access Token (read_api scope is enough for browsing; api for editing).
3. Set your default scope (Group or Project).
4. Click Open GitJam Library → browse Recent / Search → Add drops a live card.

How tokens are stored

Your Personal Access Token is stored locally via Figma's clientStorage API — per device, per user. It is not synced to Figma's servers and is not visible to other people on the same board. Requests go through a thin Cloudflare Worker proxy (source) that forwards them to GitLab and returns the response — nothing is logged or persisted server-side.

See docs/PRIVACY.md for the full statement.

Supported URL formats

Type	URL	Shortcut
Issue	gitlab.com/group/project/-/issues/123	group/project#123
Merge Request	gitlab.com/group/project/-/merge_requests/456	group/project!456
Epic	gitlab.com/groups/group/-/epics/42	group&42
Milestone	gitlab.com/groups/group/-/milestones/7	—

Roadmap

• Now: Browse & Add via Launcher + Library; live cards with edits
• Next: create issues directly from the widget; richer Figma Design ↔ GitLab integration; visual connectors between linked cards

Feedback

Bugs, ideas, requests → open an issue.

License

MIT — free to use, modify, and distribute.