Quick Start
The following guide gets you a full Upmade editor setup in under five minutes.
Installation
Run the following command to install the Upmade editor in your project.
npm install @upmade/react-editor
Additionally install the Upmade skill
Install the related Upmade skill for coding assistance:
npx skills add kasual1/upmade
Setup
Import and render the <UpmadeEditor> component:
import { UpmadeEditor } from '@upmade/react-editor';
export function Editor() {
return <UpmadeEditor style={{ display: 'block', width: '100%', height: '100vh' }} />;
}
This renders the editor with all the default UI elements such as the toolbar, the workspace manager, the more menu, and the zoom control panel.
Optional Enhancements
Persisting Canvas State
By default, the editor uses an empty sync provider list, so canvas state is reset on reload. To persist objects locally across page reloads, configure syncConfig explicitly with IndexedDBSyncProvider.
For provider behavior details and persistence guidance, take a look at Persistence.
import { IndexedDBSyncProvider, UpmadeEditor, type UpmadeSyncConfig } from '@upmade/react-editor';
const syncConfig: UpmadeSyncConfig = {
providers: [IndexedDBSyncProvider],
};
export function Editor() {
return (
<UpmadeEditor
syncConfig={syncConfig}
style={{ display: 'block', width: '100%', height: '100vh' }}
/>
);
}
Full Viewport Styling
To ensure the Upmade editor occupies the entire viewport and prevents unwanted scrolling, add the following CSS to your global stylesheet (e.g., styles.css):
html,
body,
#root {
width: 100dvw;
height: 100dvh;
margin: 0;
padding: 0;
overflow: hidden;
display: block;
}
Mobile Viewport Meta Tag
For optimal rendering and responsiveness on mobile devices, add this meta tag within the <head> section of your index.html:
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>React App</title>
<base href="/">
<meta name="viewport" content="viewport-fit=cover, width=device-width, initial-scale=1.0, user-scalable=no, maximum-scale=1.0, minimum-scale=1.0, interactive-widget=resizes-content" />
<link rel="icon" type="image/x-icon" href="favicon.ico">
</head>
<body>
<div id="root"></div>
</body>
</html>