add speaker notes for slides#9533
Merged
Merged
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Bundle ReportChanges will increase total bundle size by 121.19kB (0.48%) ⬆️. This is within the configured threshold ✅ Detailed changes
Affected Assets, Files, and Routes:view changes for bundle: marimo-esmAssets Changed:
Files in
Files in
Files in
|
![cubic-dev-ai[bot]](https://avatars.githubusercontent.com/in/1082092?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
1 issue found across 9 files
Prompt for AI agents (unresolved issues)
Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.
<file name="frontend/src/components/slides/slide-notes-editor.tsx">
<violation number="1" location="frontend/src/components/slides/slide-notes-editor.tsx:45">
P2: Switching slides before the debounce fires can drop recent speaker-note edits. Flush or persist pending text when `cellId` changes/unmounts so fast navigation doesn't lose input.</violation>
</file>
Architecture diagram
sequenceDiagram
participant User as User (Browser)
participant SlidesUI as SlidesLayoutRenderer
participant Deck as Reveal Deck Component
participant NotesPlugin as Reveal Notes Plugin
participant KioskIframe as Kiosk Iframe (Speaker View)
participant NotesEditor as SlideNotesEditor
participant Store as Layout Store (Jotai)
Note over User,Store: Slide Presentation Flow with Speaker Notes
User->>SlidesUI: Interact with slides (navigate, edit)
SlidesUI->>SlidesUI: Determine isReading mode (read OR kiosk flag)
alt Kiosk Mode Active (speaker view iframe)
SlidesUI->>SlidesUI: Collapse to read-only layout (hide chrome)
end
User->>NotesEditor: Type/Edit speaker notes for current slide
NotesEditor->>NotesEditor: Debounce input (300ms)
NotesEditor->>Store: Persist updated speakerNotes in SlideConfig map
Store-->>NotesEditor: Confirm update
User->>Deck: Press 'S' to open speaker view
Deck->>NotesPlugin: Initialize Notes plugin
NotesPlugin->>KioskIframe: Create kiosk iframe with ?kiosk=true&show-chrome=false
Note over NotesPlugin,KioskIframe: Kiosk URL includes current slide context
alt Kiosk iframe loads (inside speaker view)
KioskIframe->>SlidesUI: Load read-only slide deck (kioskMode=true)
SlidesUI->>Deck: Render slides with isReading=true
Deck->>Deck: Skip RevealNotes plugin (no nested speaker view)
Note over KioskIframe,Deck: Shows slide content + inline notes aside
end
Note over Deck,Store: Slide Rendering with Notes Injection
SlidesUI->>Deck: Pass slideConfigs (with speakerNotes) to SubslideView
Deck->>Deck: buildSubslideNotes() for each subslide
Deck->>Deck: Compute slideLevel notes + cumulativeByBlock per fragment
alt Fragment block has notes
Deck->>Deck: Inject NotesAside (aside.notes) inside Fragment element
else Slide-level notes exist (non-fragment)
Deck->>Deck: Inject NotesAside outside fragment containers
end
User->>Deck: Navigate slides / reveal fragments
Deck->>Deck: Update active slide index and fragment index
Deck->>NotesPlugin: Report slide change
NotesPlugin->>KioskIframe: Update preview in speaker view
alt User edits notes while presenting (only in main deck, not kiosk)
User->>NotesEditor: Edit text
NotesEditor->>Store: Save new notes
Store-->>NotesEditor: Updated config
NotesEditor->>Deck: Re-render with updated notes (via layout state)
end
Note over Deck,Store: Kiosk Mode Bypass
alt Deck is inside kiosk iframe
Deck->>Deck: Skip keyboard event propagation (stopPropagation on textarea)
Deck->>Deck: Disable Notes plugin to prevent nested popups
Deck->>NotesPlugin: Not initialized (plugin list empty)
end
Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.
Contributor
There was a problem hiding this comment.
Pull request overview
Adds speaker notes support for slides, including editable notes in the slides authoring UI and Reveal speaker-view integration.
Changes:
- Adds
speakerNotesto slide layout config and smoke-test layout data. - Adds helper logic and tests for aggregating slide/fragment notes.
- Adds a notes editor panel, resize handle styling, kiosk handling, and Reveal notes plugin wiring.
Reviewed changes
Copilot reviewed 9 out of 9 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
marimo/_smoke_tests/slides_examples/nested_slides.py |
Updates generated version metadata. |
marimo/_smoke_tests/slides_examples/layouts/nested_slides.slides.json |
Adds sample speaker notes to slide config entries. |
frontend/src/components/slides/slides.css |
Adds resize-handle styling for the notes panel. |
frontend/src/components/slides/slide-notes.ts |
Adds helpers for collecting and accumulating notes. |
frontend/src/components/slides/slide-notes-editor.tsx |
Adds editable speaker notes textarea. |
frontend/src/components/slides/reveal-component.tsx |
Integrates notes rendering, Reveal notes plugin, kiosk URL, and notes panel layout. |
frontend/src/components/slides/__tests__/slide-notes.test.ts |
Adds tests for notes aggregation helpers. |
frontend/src/components/editor/renderers/slides-layout/types.ts |
Adds speakerNotes to slide config type. |
frontend/src/components/editor/renderers/slides-layout/slides-layout.tsx |
Treats kiosk clients as read-only slide renderers. |
Contributor
There was a problem hiding this comment.
2 issues found across 6 files (changes from recent commits).
Prompt for AI agents (unresolved issues)
Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.
<file name="frontend/src/components/slides/slide-notes-editor.tsx">
<violation number="1" location="frontend/src/components/slides/slide-notes-editor.tsx:55">
P2: `draft` is only synchronized when `cellId` changes, so external note updates for the currently selected slide are not reflected in the textarea.</violation>
</file>
<file name="frontend/src/components/editor/renderers/slides-layout/__tests__/plugin.test.ts">
<violation number="1" location="frontend/src/components/editor/renderers/slides-layout/__tests__/plugin.test.ts:216">
P2: This case doesn’t actually verify that `speakerNotes` survives validation, so it won’t catch the schema dropping the field. Assert the parsed payload (or pass `parsed.data` into `deserializeLayout`) to make the regression test meaningful.</violation>
</file>
Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.
Light2Dark
commented
May 13, 2026
| )} | ||
| > | ||
| {isEditing && ( | ||
| {!hideControls && isEditing && ( |
Collaborator
Author
There was a problem hiding this comment.
This hides the filename input if show-chrome=False. @mscolnick
Contributor
There was a problem hiding this comment.
i think its worth hiding, nice call
Contributor
There was a problem hiding this comment.
1 issue found across 1 file (changes from recent commits).
Prompt for AI agents (unresolved issues)
Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.
<file name="frontend/src/core/edit-app.tsx">
<violation number="1">
P2: `AppHeader` is now always rendered, so `hideControls` no longer hides the header container. In kiosk/hidden-controls mode this leaves an empty padded header area and changes layout.</violation>
</file>
Tip: Review your code locally with the cubic CLI to iterate faster.
Co-authored-by: Kiran Gadhave <14944083+kirangadhave@users.noreply.github.com>
for more information, see https://pre-commit.ci
peter-gy
reviewed
May 15, 2026
Contributor
peter-gy
left a comment
peter-gy
left a comment
There was a problem hiding this comment.
great stuff👌 -- only a couple of comments. once we make CI/lints pass this should be good to merge imo
| hitAreaMargins={{ coarse: 12, fine: 4 }} | ||
| /> | ||
| )} | ||
| <Panel defaultSize={4} minSize={4} collapsible={true} collapsedSize={4}> |
Contributor
There was a problem hiding this comment.
Should the notes panel start larger? at this size the textarea is looks like a one-line strip on first load to me so the feature is hard to discover/use.
Collaborator
Author
There was a problem hiding this comment.
thanks, made it slightly bigger
| value={draft} | ||
| onChange={(event) => handleChange(event.target.value)} | ||
| onClick={Events.stopPropagation()} | ||
| placeholder="Add notes for this slide. Visible to you in speaker view (press S during presentation)." |
Contributor
There was a problem hiding this comment.
love the show-on-S-pressed behavior! it might make sense to include this in the slides docs because rn this placeholder seems to be the only place where we advertise this feature
manzt
previously approved these changes
May 18, 2026
Collaborator
manzt
left a comment
manzt
left a comment
There was a problem hiding this comment.
Just some minor typing things. Looks great.
Comment on lines
+24
to
+27
| // All fields are optional so layouts saved by older marimo versions will work. | ||
| // NOTE: every property of `SlideConfig` must be listed here — `z.object` | ||
| // strips unknown keys by default, so omitting a field silently drops it on | ||
| // any code path that runs the input through `validator.parse`. |
Collaborator
There was a problem hiding this comment.
Maybe for future PR (and other plugins/validations), but would be nice for our zod schemas to be very flexible but .transform() into more strict types for the internals (wide/backward-compatible external, to narrow/strict internal type).
github-actions
Bot
added
the
documentation
Contributor
There was a problem hiding this comment.
1 issue found across 8 files (changes from recent commits).
Tip: Review your code locally with the cubic CLI to iterate faster.
Re-trigger cubic
akshayka
approved these changes
May 20, 2026
|
🚀 Development release published. You may be able to view the changes at https://marimo.app?v=0.23.7-dev65 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
📝 Summary
Press S to open up speaker notes.
Note that in kiosk mode, I've removed the filename as it seems uneccesary.
Screen.Recording.2026-05-12.at.5.32.23.PM.mov
📋 Pre-Review Checklist
✅ Merge Checklist