react-native-vision-camera (v5)

VisionCamera v5 is the maintained and latest version of

react-native-vision-camera

. It is a full Nitro Modules rewrite with a new Constraints API, Output-based architecture, in-memory
Photo
, and a hard break from the v4 format/prop model. Almost every v4 surface is gone or renamed — treat v5 as a new API, not an incremental upgrade.

This skill is a router. Read this file first, then load the reference that matches the task. Every reference is self-contained — do not load more than you need.

When to load which reference

New install, getting a Camera on screen, permissions, minimum boilerplate → references/quickstart-v5.md
Porting a v4 codebase, understanding what changed → references/migration-v4-to-v5.md (load this FIRST when the user mentions v4, takePhoto, useCameraFormat, format prop, photo/video boolean props, or CodeScanner in core)
Choosing/attaching outputs, fps/HDR/resolution via constraints, session lifecycle → references/outputs-and-constraints.md
Frame Processors, worklets, async frame work, pixel formats, writing a native plugin → references/frame-processors.md (load this when user says "frame processor", "worklet", "ML on frames", "Nitro plugin", "vision-camera-plugin-*")
Capturing photos (incl. callbacks, RAW, HDR, preview image), recording video, Recorder lifecycle, manual AE/AF/AWB, exposure bias, zoom, focus → references/capture-and-controls.md
Depth streaming, multi-cam, Skia preview, GPU resizer for ML, barcode scanner package, GPS location metadata, custom native outputs → references/advanced-features.md

When in doubt, load references/migration-v4-to-v5.md — it covers the shape of the new API by contrasting it with v4 and is the fastest orientation.

Non-negotiable rules for v5 code

These are the rules that catch people who "know" v4. Apply them without asking:

Install the Nitro peers.
```
react-native-nitro-modules
```
and
```
react-native-nitro-image
```
are required peer deps. Frame processors additionally require
```
react-native-vision-camera-worklets
```
AND
```
react-native-worklets
```
(Software Mansion's — not
```
-core
```
). Worklets - https://docs.swmansion.com/react-native-worklets/docs/

outputs={[...]}
replaces
photo
/
video
/
frameProcessor
/
codeScanner
props. Create outputs with

usePhotoOutput

useVideoOutput

useFrameOutput

useDepthOutput

useObjectOutput

(or

useBarcodeScannerOutput

from the barcode package) and pass them in an array. Capture methods (

capturePhoto

createRecorder

) live on the Output, not the Camera ref.

There is no
format
prop and no
useCameraFormat
. Use
```
constraints={[...]}
```
— array order = priority, descending. The Camera negotiates the closest supported config automatically, so an impossible constraint like
```
{ fps: 99999 }
```
never throws.
takePhoto()
does not exist. Use
```
photoOutput.capturePhoto(settings, callbacks)
```
for in-memory
```
Photo
```
, or
```
photoOutput.capturePhotoToFile(...)
```
for a file path. The default path is in-memory — do not write temp files unless explicitly asked.
Frame Processor plugins must be Nitro Modules. The v4
```
FrameProcessorPlugin
```
base class,
```
VISION_EXPORT_SWIFT_FRAME_PROCESSOR
```
macro, and
```
VisionCameraProxy.addFrameProcessorPlugin
```
are gone. A v5 plugin is a
```
HybridObject
```
with a typed Nitro spec. See references/frame-processors.md.
Every
Frame
(and
Depth
) MUST be
.dispose()
d. The buffer pool is bounded; leaking a frame stalls the pipeline. Wrap work in
```
try { ... } finally { frame.dispose() }
```
. When offloading via
```
asyncRunner.runAsync(...)
```
, dispose inside the async callback if it returned
```
true
```
, and dispose immediately in the
```
else
```
branch when it returned
```
false
```
.
CodeScanner is not in core.
```
react-native-vision-camera-barcode-scanner
```
is a separate package, MLKit-based on both platforms. For iOS-only object detection (QR, faces, bodies via native AVFoundation metadata, no ML dep), use
```
useObjectOutput
```
from core.
Keep the Camera mounted; toggle
isActive
. Remounting tears down the session. Integrate with
```
useIsFocused()
```
from react-navigation so the session goes Idle → Ready while not on screen, and keeps preferences warm for fast resume.
Prefer YUV in Frame/Depth outputs.
```
pixelFormat: 'yuv'
```
is the native path and the default.
```
'rgb'
```
forces a YUV→RGB conversion; use only when a downstream consumer requires it. Use
```
react-native-vision-camera-resizer
```
for GPU-accelerated YUV→RGB resize into an ML tensor instead of paying that cost in the camera pipeline.
Do not hand-clamp FPS/resolution with
Math.min/Math.max
. That was a v4 workaround. In v5 the Constraints API negotiates internally — express intent and let the Camera pick.
Worklets mutate Reanimated SharedValues directly in v5. The worklets-core bridge is gone; no
```
runOnJS
```
round-trip required to update a Reanimated
```
SharedValue
```
from a frame processor.

Operating rules for this skill

Never invent v4→v5 API shapes. If a v4 API has no documented v5 equivalent in the references, say so and link to the v5 docs — do not guess.
Do not add documentation files (README, CHANGELOG) unless the user asks.
Assume the user is on v5 unless they show v4 code. If they show v4 code, load references/migration-v4-to-v5.md before writing anything.
When writing a new Camera example, default to the hook-based declarative form (
```
useCameraPermission
```
+
```
useCameraDevice
```
+
```
usePhotoOutput
```
+
```
<Camera />
```
). Use the imperative
```
VisionCamera.createCameraSession(...)
```
API only when the user asks for multi-cam or full programmatic control.
When the user asks for an ML / CV pipeline, recommend
```
react-native-vision-camera-resizer
```
(GPU, ~5× faster than CPU/SIMD) over
```
vision-camera-resize-plugin
```
(v4-era, CPU).
Verify peer dependency installs. A user reporting a native crash after install 95% of the time has missed
```
react-native-nitro-modules
```
,
```
react-native-nitro-image
```
, or (for frame processors)
```
react-native-worklets
```
+
```
react-native-vision-camera-worklets
```
.

Authoritative links

Docs: https://visioncamera.margelo.com
```
llms.txt
```
index: https://visioncamera.margelo.com/llms.txt

V5 release notes (includes migration snippets):

gh api repos/mrousavy/react-native-vision-camera/releases/tags/v5.0.0

Blog announcement: https://blog.margelo.com/whats-new-in-visioncamera-v5
Main repo: https://github.com/mrousavy/react-native-vision-camera
V4 snapshot (archived docs): https://visioncamera4.margelo.com

react-native-vision-camera

NPX Install

Tags

SKILL.md Content

react-native-vision-camera (v5)

When to load which reference

Non-negotiable rules for v5 code

Operating rules for this skill

Authoritative links