Story generation fails with "Render context is empty" error when components use custom Twig functions that require Drupal render context (e.g., bem(), attach_library(), drupal_settings()).
The issue occurs in the TwigStorybook library where $wrapper->render(['_story' => false]) is called during story generation without proper Drupal render context. This affects any Drupal site using component-based theming with custom Twig functions in a Drupal 11 + Storybook 9.x setup with server-side rendering.
1. Create a component that uses a custom Twig function requiring render context
2. Create a .stories.twig file for the component
3. Run story generation: drush storybook:generate-all-stories --force
Expected result: Stories should generate successfully without errors.
Actual result: Story generation fails with error: "Render context is empty, because render() was called outside of a renderRoot() or renderInIsolation() call. Use renderInIsolation()/renderRoot() or #lazy_builder/#pre_render instead."
Wrap the TwigStorybook render calls in renderInIsolation() within the Drupal Storybook module integration.
Example fix in src/Drush/Commands/StorybookCommands.php:
- Inject RendererInterface service into StorybookCommands class
- Wrap generateStoriesJsonFile() calls in renderInIsolation()
- Update service definitions in storybook.services.yml
- Inject RendererInterface service into StorybookCommands class
- Wrap generateStoriesJsonFile() calls in renderInIsolation()
- Update service definitions in storybook.services.yml
- Test with components using render-context-dependent Twig functions
- Verify story generation completes without errors
None.
None. This is an internal fix that maintains existing API compatibility.
None.
Active
1.0
Storybook
Pushed the changes here: https://git.drupalcode.org/issue/storybook-3529535/-/commit/d5117a04f0d0...
Adding the patch as well for Composer usage in projects.
I updated the ticket description to reflect the latest changes.