Accordion

Can I customize the source?

Yes. Keep the MIT notice and change the implementation to suit your project.

How do themes work?

Override the scoped CSS tokens for your colors, type and spacing.

Future adapters

Not available yet.

Usage

import { Accordion } from "@devvy-ui/react";

<Accordion items={[{value:"ownership", title:"Can I change the source?", content:<p>Yes. Keep the MIT notice and make it yours.</p>}, {value:"themes", title:"Can I change the theme?", content:<p>Override the design tokens.</p>}]} />

API reference

Native HTML attributes, className, style and a forwarded ref are supported. Component-specific props:

Prop	Type	Default	Description
items	readonly AccordionItem[]	required	Unique value, title, content and optional disabled.
value / defaultValue	readonly string[]	[]	Controlled or initial expanded values.
onValueChange	(values: string[]) => void	—	Reports requested expansion.
multiple	boolean	false	Allow multiple open items.

Source ownership

Run npx @devvy-ui/cli init once in your React project, then add the source:

npx @devvy-ui/cli add accordion

Make the source yours.

Start from the canonical implementation used by the package and registry. Change the code, keep the MIT notice, and build the behavior your project needs.

Accordion.tsxREACT / TSX

import { forwardRef, useId, useState, type HTMLAttributes, type ReactNode } from 'react';
import { cx } from '../lib/cx';
export interface AccordionItem {
  value: string;
  title: ReactNode;
  content: ReactNode;
  disabled?: boolean;
}
export interface AccordionProps
  extends Omit<HTMLAttributes<HTMLDivElement>, 'defaultValue' | 'onChange'> {
  items: readonly AccordionItem[];
  value?: readonly string[];
  defaultValue?: readonly string[];
  onValueChange?: (value: string[]) => void;
  multiple?: boolean;
}
export const Accordion = forwardRef<HTMLDivElement, AccordionProps>(function Accordion(
  { items, value, defaultValue = [], onValueChange, multiple = false, className, ...props },
  ref,
) {
  const id = useId();
  const [local, setLocal] = useState(defaultValue);
  if (new Set(items.map((item) => item.value)).size !== items.length)
    throw new Error('Accordion item values must be unique.');
  const selected = value ?? local;
  const current = multiple ? selected : selected.slice(0, 1);
  function toggle(item: AccordionItem) {
    if (item.disabled) return;
    const next = current.includes(item.value)
      ? current.filter((key) => key !== item.value)
      : multiple
        ? [...current, item.value]
        : [item.value];
    if (value === undefined) setLocal(next);
    onValueChange?.(next);
  }
  return (
    <div {...props} ref={ref} className={cx('dvy-accordion', className)}>
      {items.map((item, index) => (
        <details
          key={item.value}
          open={current.includes(item.value)}
          className="dvy-accordion-item"
        >
          <summary
            aria-controls={id + '-' + index}
            aria-disabled={item.disabled || undefined}
            onClick={(event) => {
              event.preventDefault();
              toggle(item);
            }}
          >
            {item.title}
          </summary>
          <div id={id + '-' + index} className="dvy-accordion-content">
            {item.content}
          </div>
        </details>
      ))}
    </div>
  );
});

Edit your own copy. Downloaded source uses your changes; the component preview above uses the shipped version. Run the source installer first to include shared helpers.

Interactive preview

Usage

API reference

Accessibility & behavior

Platform Behavior & Guidelines

Source ownership

Make the source yours.