Skip to content
mdxcn is now part of Shadcn Labs. details

decision

Decision

One decision with the options that were on the table. Bold the chosen option, italicize the rejected ones, and add `— why` after each. Paragraphs after the list describe what happens next. For a feature grid, use Compare.

use it
Good for an ADR or a tradeoff: what you picked, what you didn't, and why.
instead
Features across plans are Compare. Ratings are Score.

database

Bold is chosen, italic is rejected, the rest stay open. `— why` sits next to each. Paragraphs after the list say what follows.

[ DATABASE ]
acceptedMar 12
  • Postgresboring, and we already run it
  • Mongono joins we trust
  • SQLitefine until the second writer

Revisit if writes pass 2k a second.

Chose Postgres over 2 other options.
<Decision title="DATABASE" status="accepted" date="Mar 12">

- **Postgres** — boring, and we already run it
- *Mongo* — no joins we trust
- SQLite — fine until the second writer

Revisit if writes pass 2k a second.

</Decision>

install

command

rendering

[ CHARTS ]
  • Glyphs in a framecopy the source, no chart runtime
  • SVGdoes not survive a README
  • Canvasno text to select or search
  • Mermaidfine for flows, wrong for numbers

Every figure has a fenced twin for GitHub.

Chose Glyphs in a frame over 3 other options.
<Decision title="CHARTS">

- **Glyphs in a frame** — copy the source, no chart runtime
- *SVG* — does not survive a README
- *Canvas* — no text to select or search
- Mermaid — fine for flows, wrong for numbers

Every figure has a fenced twin for GitHub.

</Decision>
[ PROPS ]
PropTypeDefaultDescription
titlestring"decision"Caption drawn on the top edge of the frame.
statusstring—proposed, accepted, superseded. First row, left.
datestring—Muted, first row, right.
childrenMarkdown—A list of options, then paragraphs. Bold is chosen, italic is rejected.
options{ label, reason?, state? }[]—Data form. state is chosen, open, or rejected.
palette"mono" | "duo" | "multi""mono"mono is one accent plus muted. duo paints the second series with --graph-accent-2. multi cycles three accents.
cornerstring"+"Character at each corner of the frame.
frame"box" | "corners" | "rule" | "none""box"box draws the dashed border. corners keeps only the corner marks. rule draws dashed lines above and below. none drops the border and padding, and puts the title above the content.
classNamestring—Passed to the outer frame.