RichTextEditor

Release notes

Ready to build

Make every detail your own.

Usage

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

<RichTextEditor label="Release notes" name="notes" defaultValue="## Ready to build" />

API reference

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

Prop	Type	Default	Description
value / defaultValue	string	empty	Markdown source.
onValueChange	(source: string) => void	—	Edited source callback.
preview	boolean	true	Safe formatted preview.

Source ownership

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

npx @devvy-ui/cli add rich-text-editor

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.

RichTextEditor.tsxREACT / TSX

import { forwardRef, useId, useRef, type TextareaHTMLAttributes } from 'react';
import { MarkdownViewer } from './MarkdownViewer';
import { useReset, useValue } from '../lib/widgets';
export interface RichTextEditorProps
  extends Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, 'value' | 'defaultValue' | 'onChange'> {
  label: string;
  value?: string;
  defaultValue?: string;
  onValueChange?: (source: string) => void;
  preview?: boolean;
}
export const RichTextEditor = forwardRef<HTMLTextAreaElement, RichTextEditorProps>(
  function RichTextEditor(
    { label, value, defaultValue = '', onValueChange, preview = true, className, ...props },
    ref,
  ) {
    const [text, setText] = useValue(value, defaultValue, onValueChange),
      input = useRef<HTMLTextAreaElement>(null),
      id = useId();
    useReset(input, () => setText(defaultValue));
    const format = (before: string, after: string) => {
      const node = input.current;
      if (!node) return;
      const start = node.selectionStart,
        end = node.selectionEnd;
      setText(text.slice(0, start) + before + text.slice(start, end) + after + text.slice(end));
      requestAnimationFrame(() => {
        node.focus();
        node.setSelectionRange(start + before.length, end + before.length);
      });
    };
    return (
      <div className="dvy-rich-editor">
        <label htmlFor={props.id ?? id}>{label}</label>
        <div role="group" aria-label="Formatting" className="dvy-editor-toolbar">
          {[
            ['Bold', '**', '**'],
            ['Italic', '_', '_'],
            ['Heading', '## ', ''],
            ['List item', '- ', ''],
            ['Code', '`', '`'],
          ].map(([name, before, after]) => (
            <button
              type="button"
              key={name}
              disabled={props.disabled || props.readOnly}
              onClick={() => format(before, after)}
            >
              {name}
            </button>
          ))}
        </div>
        <textarea
          {...props}
          id={props.id ?? id}
          ref={(node) => {
            input.current = node;
            if (typeof ref === 'function') ref(node);
            else if (ref) ref.current = node;
          }}
          className={['dvy-textarea', className].filter(Boolean).join(' ')}
          value={text}
          onChange={(e) => setText(e.target.value)}
        />
        {preview && (
          <section aria-label="Formatted preview" className="dvy-editor-preview">
            <MarkdownViewer source={text} />
          </section>
        )}
      </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

Ready to build

Usage

API reference

Accessibility & behavior

Platform Behavior & Guidelines

Source ownership

Make the source yours.