Branding and embedding
user supplies display information
only: it does not authenticate the visitor or grant access. Omit avatarUrl to
use a green avatar with the first letter of the user name. onThemeChange can save the selected
appearance in your application. Each mounted Studio keeps its own appearance.
The library offers Grid, Large grid and List layouts through its Layout menu.
Folder breadcrumbs appear below the title after opening a folder. Date filters
use the keyboard-accessible HeroUI calendar; dates are sent as inclusive UTC
calendar dates. All browse filters and sort options continue to apply to child
folders. The displayed loaded-item count describes the bounded browser window,
not the total number of files in your database.
On initial opening, Studio waits for its stylesheet, workspace permissions,
first listing response and measured layout before revealing the interface.
A centered loading indicator is shown while these are prepared. Searching and
navigating after startup keep the top search field mounted.
Preview action bar
Configure the preview actions when mounting Studio. Add a separator before an action withseparatorBefore:
previewActions: false to hide the bar entirely.
The bar changes width when its visible controls change. Replacing actions in an existing slot animates the icons separately. Reduced-motion preferences disable these transitions.
In drawing mode, click the image with the Text tool to type in place. Press Enter
to finish, Shift+Enter for another line, or Escape to discard the current text
edit. Click existing text with the Text tool to edit it again. With Select, click once to select it and again to edit; double-click also opens editing. Drag a selected object to
move it; vector objects expose corner handles for resizing. Changing the palette
color updates the selected object. Keyboard shortcuts: V Select, D Pen, E Eraser,
A Arrow, T Text, R Rectangle, O Ellipse, L Line; Ctrl/Cmd+Z undoes the last edit and
Ctrl/Cmd+Shift+Z restores it.
The Styles panel adapts to the active tool or selected object. It provides color
and opacity; drawing tools add stroke size, solid/dashed/dotted lines, and fill
where applicable. Text adds size, system font family and horizontal alignment.
Rectangles and ellipses support labels (double-click to edit), including vertical
alignment, with no change to the source image. Styles are saved with each mark.
Configure navigation and page panels
The React interface uses one shared layout. You can hide navigation destinations, choose which pages have a contextual panel, and provide your own panel content. These display settings never grant permissions: the API continues to enforce access to each workspace and operation.panel: false removes the contextual
panel, panel: 'library' uses built-in navigation, and panel: 'workspaces' shows
the workspace selector. Custom panel content should be a React component; its
render callback receives the current view, workspace, locale, navigate() and
close(). Panel widths are bounded to 200–400 pixels. On narrow screens the panel
opens over the content, preserving room for the library.
navigation: false hides the primary icon rail. header: false on a page removes
the shared search/account header. When a panel is enabled without the header, Studio keeps a compact mobile
opening control so the panel remains reachable. Picker mode always uses the dedicated navigation-free
layout, regardless of page settings.
Document previews
The React library and editor picker can preview DOCX, XLSX, PPTX, Pages, Keynote, Numbers, DOC, XLS, PPT, ODT, ODS, ODP, RTF, CSV and Markdown. Readers load only when a file is opened. Documents are read-only and are processed in a browser worker; this does not save a second PDF or replace the original file.documentPreview: false to disable these readers. Upload acceptance remains
an independent server setting; enabling a preview does not authorize an upload
or grant access to a file. A known original size is required for the size check.
Host office-preview.js, office-preview.css, office-engine.worker.js and
office-engine-LICENSE.txt alongside studio.js. Allow that worker URL in your
Content Security Policy. These assets are not fetched for grid thumbnails.
Authenticated content URLs retain the transport’s authorization. A separate CDN
must permit CORS and byte-range requests, including exposed Content-Range;
without byte ranges the reader may download the entire allowed file.
A thin bar at the top reports download or parsing progress when the engine
provides a total; other stages use an indeterminate animation. It fades away
when content is ready. A failed or timed-out opening offers retry. Closing or
changing the file stops its worker.
This development checkout pins an upstream Office Engine pre-release to support
the legacy formats, which were not included in npm 0.11.1. Formatting coverage
depends on the reader: encrypted files, older iWork versions and some advanced
Office features may not render. File-size and time limits do not guarantee a
fixed decompressed memory footprint for arbitrary documents.
The header search button opens a compact Find field and highlights matching text.
Click it again to close the panel. The field’s clear button removes the query;
next/previous arrows and Enter/Shift+Enter navigate the results. Ctrl/Cmd+F opens
Find and Escape closes it. Search works in text documents and in the active
worksheet of a spreadsheet; presentation search is not currently available.
The panel overlays the document without resizing its viewport. Set
documentPreview.search: false to remove the action, or outline: true to
restore the reader’s document-outline toggle.
Primary color and viewer profile
primaryColor: '#b51b43' overrides the server default per
mounted instance. Filament pickers receive the configured primary color too.
Colors inside document content and semantic success/error states are preserved.
The account menu shows avatar, name and email. Its Appearance row places the
label left and compact HeroUI tabs right. An explicit React user profile
overrides the profile returned by the native transport; this is display data
only and never establishes authentication.