# Compose your own

> Put the pieces you want into your own layout.

## How it works

`<ImageEditorProvider>` holds the image, the edits and the undo history. Every `ImageEditor*` component inside it reads from it with `useImageEditor()`, so they stay in sync automatically.

```tsx

  <ImageEditorCanvas />
  <ImageEditorAdjustments />
  <ImageEditorUndoButton />
  <MyOwnControl /> {/* calls useImageEditor() */}

```

## A smaller editor

The canvas, adjustments, undo, compare and export.

```tsx
"use client";

import { ImageEditorProvider } from "photocn/react";

import { ImageEditorAdjustments } from "@/components/image-editor/adjustments-panel";
import { ImageEditorCanvas } from "@/components/image-editor/canvas";
import { ImageEditorExportDialog } from "@/components/image-editor/export-dialog";
import {
  ImageEditorCompareButton,
  ImageEditorRedoButton,
  ImageEditorUndoButton,
} from "@/components/image-editor/toolbar";

export default function ComposeYourOwnExample() {
  return (
    <ImageEditorProvider src="/samples/street.jpg">
      <div className="grid h-[560px] grid-rows-[auto_1fr] overflow-hidden rounded-xl border bg-background md:grid-cols-[1fr_300px]">
        <header className="flex items-center gap-1 border-b p-2 md:col-span-2">
          <ImageEditorUndoButton />
          <ImageEditorRedoButton />
          <div className="ml-auto flex gap-2">
            <ImageEditorCompareButton />
            <ImageEditorExportDialog />
          </div>
        </header>
        <ImageEditorCanvas className="min-h-64 p-3" />
        <aside className="overflow-y-auto border-t md:border-t-0 md:border-l">
          <ImageEditorAdjustments />
        </aside>
      </div>
    </ImageEditorProvider>
  );
}
```

## Your own controls

This filter picker is plain JSX on top of `useImageEditor()`. It lists `editor.filters.presets`, calls `editor.filters.select()`, and shares the canvas.

```tsx
"use client";

import { useId } from "react";
import { ImageEditorProvider, useImageEditor } from "photocn/react";

import { Button } from "@/components/ui/button";
import { Slider } from "@/components/ui/slider";
import { cn } from "@/lib/utils";
import { ImageEditorCanvas } from "@/components/image-editor/canvas";

export default function FilterStripExample() {
  return (
    <ImageEditorProvider src="/samples/strawberries.jpg">
      <div className="mx-auto flex h-[640px] max-w-sm flex-col overflow-hidden rounded-3xl border bg-background shadow-sm">
        <ImageEditorCanvas className="min-h-0 flex-1 p-2" showOpenButton={false} />
        <FilterStrip />
      </div>
    </ImageEditorProvider>
  );
}

// A custom control built only from `useImageEditor()` — no photocn panel.
function FilterStrip() {
  const { filters, isReady } = useImageEditor();
  const strengthLabelId = useId();
  return (
    <div className="flex flex-col gap-3 border-t p-3">
      <div className="flex gap-2 overflow-x-auto pb-1">
        <FilterChip
          active={filters.value.label === null}
          disabled={!isReady}
          label="Original"
          onClick={() => void filters.select(null)}
        />
        {filters.presets.map((preset) => (
          <FilterChip
            active={filters.value.label === preset.label}
            disabled={!isReady || filters.loading !== null}
            key={preset.label}
            label={preset.label}
            onClick={() => void filters.select(preset)}
          />
        ))}
      </div>
      {filters.value.label ? (
        <>
          <span className="sr-only" id={strengthLabelId}>
            Filter strength
          </span>
          <Slider
            aria-labelledby={strengthLabelId}
            max={100}
            onValueChange={(next) => filters.setStrength(((typeof next === "number" ? next : next[0]) ?? 0) / 100)}
            value={[Math.round(filters.value.strength * 100)]}
          />
        </>
      ) : null}
    </div>
  );
}

function FilterChip({
  active,
  label,
  ...props
}: { active: boolean; label: string } & React.ComponentProps<typeof Button>) {
  return (
    <Button
      aria-pressed={active}
      className={cn("shrink-0 rounded-full capitalize", active && "shadow-sm")}
      size="sm"
      variant={active ? "default" : "outline"}
      {...props}
    >
      {label}
    </Button>
  );
}
```

## Controlled versions

Each panel file also exports a plain version that takes `value` and `onChange`: `AdjustmentPanel`, `CurvesPanel`, `FiltersPanel` and so on. Use these when you want to drive a panel from your own state, or use it outside a provider.
