# MockFrame
Device mockups for React. Showcase your apps in realistic phone, tablet, and laptop frames. Perfect for SaaS landing pages, product demos, and marketing websites.
Built and maintained by [Matter Development](https://matterdevelopment.com/?utm_source=react-mockframe&utm_medium=readme).
[](https://www.npmjs.com/package/react-mockframe)
[](http://typescriptlang.org/)
[](https://opensource.org/licenses/MIT)
## Features
- **12 Devices** - iPhone 8/8 Plus, iPhone X, iPhone 17, iPhone 18 Pro, iPhone Duo (foldable), Pixel 10, Galaxy S25, iPad Mini, iPad Pro, MacBook Pro 2020, MacBook Pro
- **Measured, Not Eyeballed** - iPhone 17, iPhone 18 Pro, iPhone Duo, iPad Pro and MacBook Pro frames are measured from Apple's official product bezels (99.8% shape match): real screen sizes, corner radii, bezels, Dynamic Island and button positions, with frame colours sampled per finish
- **Multiple Color Variants** - Authentic device colors for each model
- **Landscape Mode** - Rotate phones and tablets
- **Notch/Dynamic Island Toggle** - Show or hide notches
- **Smooth Animations** - Optional animated transitions
- **Custom Device Frames** - Create your own frames with `CustomMockFrame`
- **Modular CSS** - Import only the device families you need
- **TypeScript First** - Full type safety with discriminated unions
- **Lightweight** - ~21KB ESM (~5.7KB gzipped), tree-shakeable
## Supported Devices
| Device | Colors | Landscape | Notch/Island |
|--------|--------|-----------|--------------|
| iPhone X | - | Yes | Notch |
| iPhone 8 | black, silver, gold | Yes | - |
| iPhone 8 Plus | black, silver, gold | Yes | - |
| iPhone 17 | black, white, mist-blue, sage, lavender, cosmic-orange, deep-blue | Yes | Dynamic Island |
| iPhone 18 Pro | black, silver, glacier, burgundy, gold, natural-titanium | Yes | Dynamic Island |
| iPhone Duo | night-sky, star-white | Yes | Camera (3 fold poses) |
| Pixel 10 | obsidian, frost, indigo, lemongrass | Yes | - |
| Galaxy S25 | blue-black, icy-blue, navy, mint, silver-shadow, coral-red, pink-gold | Yes | - |
| iPad Mini | black, silver | Yes | - |
| iPad Pro | space-black, silver | Yes | - |
| MacBook Pro 2020 | - | - | - |
| MacBook Pro | space-black, silver | - | Notch |
Default screen sizes (CSS px) match each device's real viewport: iPhone 17 / 18 Pro 402×874, Pixel 10 412×924, Galaxy S25 360×780. iPad Pro (512×683) and MacBook Pro (960×624) are scaled down from the real 13" and 14" screens, keeping their exact proportions.
`gold` and `natural-titanium` are not iPhone 18 Pro finishes (Apple sells Black, Silver, Glacier and Burgundy). `gold` is Apple's iPhone Air Light Gold applied to the 18 Pro's satin aluminium, and `natural-titanium` is sampled from Apple's iPhone 16 Pro Natural Titanium. Older colour names stay accepted for compatibility: `space-gray` (iPad Pro, MacBook Pro), `porcelain` / `mint` / `rose` (Pixel 10), `phantom-black` / `silver` (Galaxy S25).
## Installation
```bash
npm install react-mockframe
# or
pnpm add react-mockframe
# or
yarn add react-mockframe
```
## Quick Start
```tsx
import { MockFrame } from 'react-mockframe'
import 'react-mockframe/styles/mockframe.css'
export default function App() {
return (
)
}
```
## Usage Examples
### Basic Device Frame
```tsx
```
### Device with Color
```tsx
```
### Landscape Mode
```tsx
```
### iPhone Duo: closed, half-open, open
Apple's foldable has three poses. Each is measured from Apple's iPhone Duo product bezels: the closed outer
display (466×678), the open inner display (951×669) and the half-open book pose, where each half is placed
with the perspective of Apple's own render.
```tsx
{/* closed (default) */}
{/* book pose */}
{/* inner display */}
```
- Closed is naturally portrait and open naturally landscape (the book spread); `landscape` turns either one
(`landscape` on closed, `landscape={false}` on open). The half-open pose is always the book pose.
- `width` / `height` set the screen size of the current pose; `hideNotch` hides the camera.
- With `animated`, changing `pose` folds the device in 3D: the halves swing on the hinge, and closing it
brings the outer display over. It runs between the natural orientations at the default size, and is skipped
when the visitor prefers reduced motion. Content is remounted while it folds.
- In the half-open pose your content is drawn once per half. The right-hand copy is `inert` and hidden from
screen readers, so interactive content only works on the left half. Images and videos look right across both.
- The half turned away from the light is shaded; set the CSS variable `--duo-fold-shade` (default `0.22`) on the
frame to change it, or `0` to turn it off.
### Hide Notch / Dynamic Island
```tsx
// Hide notch on iPhone X
// Hide Dynamic Island on iPhone 17
// Hide notch on MacBook Pro
```
### Custom Zoom & Dimensions
```tsx
```
### Animated Transitions
```tsx
```
### Landing Page Hero
```tsx