Jira preset

Pro

Jira's work-tracking objects, as entity kinds. Pass to EntityKindsProvider: <EntityKindsProvider kinds={jiraKinds}>. Atlassian's current help pages say "work item" where Jira used to say issue and "space" where it said project, so issue shows as "Work item" and project as "Space" (the ids keep the names Jira's API uses). Epic, sprint, board and workflow keep their own names. Change noun if your site still says Issue and Project.

Markdown

Version 5.2.0· other versions

This page is for 5.2.0, the current release. An earlier release’s page is the Markdown that release published, so the docs match the version you have installed (candor-lock.json records it).

Not in the docs of 1.3.0, 1.4.0, 1.5.0, 1.5.1, 1.6.0, 1.7.0, 1.8.0, 1.8.1, 1.9.0, 1.9.1, 2.0.0, 2.1.0, 2.2.0, 2.3.0, 2.4.0, 2.5.0, 2.5.1, 2.6.0, 2.6.1, 2.6.2, 2.7.0, 2.8.0, 2.9.0, 2.10.0 and 3.0.0: the page came later, or had another name then.

Docs pages weren’t kept for 1.0.0, 1.0.1, 1.1.0, 1.1.1, 1.2.0 and 1.2.1: they are kept from 1.3.0 on, and before that only llms.txt was published.

Preview

Install

With the Candor CLI

First time? Get started sets up the registry and theme. Or with shadcn directly: npx shadcn@latest add @candor/jira-preset

Brings in: entity-chip, fill-strings, tokens · npm: lucide-react@^1.67.0

Usage

TSX · The example above

"use client"

import { EntityChip, EntityKindsProvider } from "@/components/candor/entity-chip"
import { jiraKinds } from "@/components/candor/jira-preset"

export default function Example() {
  return (
    <EntityKindsProvider kinds={jiraKinds}>
      <p className="flex max-w-lg flex-wrap items-center gap-2 text-sm">
        <EntityChip entity={{ kind: "project", name: "Platform (PLAT)" }} onOpen={() => {}} />
        <EntityChip entity={{ kind: "issue", name: "PLAT-142" }} onOpen={() => {}} />
        <EntityChip entity={{ kind: "epic", name: "PLAT-100 Billing rewrite" }} onOpen={() => {}} />
        <EntityChip entity={{ kind: "sprint", name: "Sprint 24" }} onOpen={() => {}} />
        <EntityChip entity={{ kind: "board", name: "Platform board" }} onOpen={() => {}} />
        <EntityChip entity={{ kind: "workflow", name: "Bug triage" }} onOpen={() => {}} />
      </p>
    </EntityKindsProvider>
  )
}

Values

jiraKinds

Record<string, EntityKindInfo>

jiraNouns

Jira's nouns for LocaleProvider's nouns: an environment is a Jira site, which an organization owns.

Partial<NounTable>