Frame (editor)
The base theme ships a module, Frame Editor (modules/frame_editor), that turns the components of your theme into Frame, a visual page builder. Editors place components, fields, views and blocks on a page, and Drupal renders the result as normal Single Directory Components: the published page loads no editor code.
The module lives inside the theme folder, and Drupal finds it there. It works only when the default theme is the Frame theme or one of its subthemes (the status report says so otherwise). It was developed and tested on Drupal 11.4.
Every feature in a screenshot: Gallery. Every video: Demos.
Features
Each page has a video, what the feature does and its limitations.
Build a page
| Feature | What it does |
|---|---|
| Building a page | the canvas, the Blocks panel and its search, drag and drop, a new page |
| Structure | the tree of the page: find, select several, move, delete, group |
| Editing a component | fields made from the props of a component: text, links, images, rich text, tokens |
| Layout and style | spacing, size, width (wide, full, band), alignment, text, background, border, position, per breakpoint |
| Layouts | Columns, Flex, Stack and other components with slots |
| Components of the base theme | a ready set: hero, heading, text, button, card, quote, accordion, call to action… |
| Fields and Drupal blocks | the fields of the page with a formatter, and Drupal blocks with their settings |
| Views | views placed on a page, drawn by Views or by an interactive component |
| Paragraphs | paragraph types as blocks, edited with their own form |
| Content and page settings | the node form inside the editor: fields, menu, title, state, URL alias |
| Field groups | each top-level group of the form is a panel of its own |
Reuse
| Feature | What it does |
|---|---|
| Library | save a block and use it on other pages, linked or as a copy |
| Presets | named values for the options of a component, with locks |
| Templates | whole pages that new pages start from |
| Layouts per Manage display | how an entity looks in a view mode (a teaser, a card), designed in Frame |
| Copy and paste | components between pages and sites, with the keyboard |
| Export and import | a page as a JSON file, with a check on the way in |
Work on a page
| Feature | What it does |
|---|---|
| Preview | the page with unsaved changes, at the widths of the theme's breakpoints |
| History and saved versions | undo, redo, a timeline of changes, and the revisions of the page |
| Translation | one structure for all languages, or a free copy per language |
| Live editing | several people on one page at once |
| AI assistant | a chat that composes the page from your components |
Set up and integrate
| Page | About |
|---|---|
| Recipes | set a site up in one command: media, responsive images, paragraphs, meta tags, AI |
| UI Patterns | the same components as blocks, layouts, formatters and views styles |
| UI kit | your design tokens and components in Frame |
| Architecture | what is stored, how a page is rendered, how the editor works |
| Build a site | the whole way, from an empty Drupal to a page |
Enable it
drush en frame_editorOr apply a recipe, which also sets up media, responsive images and a role for editors, and optionally paragraphs, meta tags and the AI assistant:
drush recipe themes/contrib/frame/recipes/frame_editor --input=frame_editor.theme=my_themeA release archive of the theme has the compiled editor. From a git checkout, build it once:
cd web/themes/contrib/frame
npm run builder:install && npm run builder:buildThen switch the editor on for a content type: Structure → Content types → (type) → Frame. It has no permission of its own: who may edit a page of that type builds it, and who may create one starts it in the editor. The module adds a ready content type, Landing page. See Building a page.
For such a content type:
- Edit is the editor.
/node/N/editopens it, and so does the add page; other content types keep the normal form. - The full page is the layout. Once a page has a layout, its full view shows only that layout. Fields appear where an editor places them. Teasers and other view modes keep their display.
Limits
The limits of each feature are on its page. For the editor as a whole:
- It works only with the Frame theme or a subtheme of it as the default theme.
- It edits nodes. Other entities have a layout only as templates, the display layouts and saved blocks.
- Views are placed without contextual filters. Blocks that need a context other than the page are not offered.
- History covers the layout, not the node form.
Develop the editor
The editor is a React app in modules/frame_editor/editor, built with Vite into modules/frame_editor/js (the built files are committed: run npm run builder:build after changing the sources). Architecture lists its sources.
| Command (in the base theme folder) | Does |
|---|---|
npm run builder:install | installs the editor's dependencies |
npm run builder:build / builder:watch | builds the editor |
npm test | includes the editor's unit tests |
BASE_URL=… npm run builder:smoke | browser smoke test against a site with the module enabled (Playwright, see demo/) |