CodeBlock

Theme customization · css

1:root {
2  --dvy-brand: #282724;
3  --dvy-radius-md: 0.5rem;
4}

Usage

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

<CodeBlock label="Theme token" language="css" code="--dvy-brand: #282724;" />

API reference

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

Prop	Type	Default	Description
code	string	required	Literal code text.
label / language	string	Code example / text	Figure and code description.
copyable	boolean	true	Copy action.
lineNumbers	boolean	false	Decorative line markers excluded from copying.

Source ownership

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

npx @devvy-ui/cli add code-block

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.

CodeBlock.tsxREACT / TSX

import { forwardRef, type HTMLAttributes } from 'react';
import { CopyButton } from './CopyButton';
export interface CodeBlockProps extends Omit<HTMLAttributes<HTMLElement>, 'children'> {
  code: string;
  label?: string;
  language?: string;
  copyable?: boolean;
  lineNumbers?: boolean;
}
export const CodeBlock = forwardRef<HTMLElement, CodeBlockProps>(function CodeBlock(
  {
    code,
    label = 'Code example',
    language = 'text',
    copyable = true,
    lineNumbers = false,
    className,
    ...props
  },
  ref,
) {
  return (
    <figure
      {...props}
      ref={ref}
      className={['dvy-code-block', className].filter(Boolean).join(' ')}
    >
      <figcaption>
        <span>
          {label} · {language}
        </span>
        {copyable && (
          <CopyButton text={code} size="sm" variant="outline" aria-label={'Copy ' + label}>
            Copy
          </CopyButton>
        )}
      </figcaption>
      <pre role="region" tabIndex={0} aria-label={label}>
        <code>
          {lineNumbers
            ? code.split('\n').map((line, i) => (
                <span className="dvy-code-line" key={i}>
                  <span aria-hidden="true" className="dvy-code-number">
                    {i + 1}
                  </span>
                  {line}
                  {'\n'}
                </span>
              ))
            : code}
        </code>
      </pre>
    </figure>
  );
});

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.