Troubleshooting
The plugin does not appear after install
- Run
copilot plugin listand confirmbento-deck-studiois listed and enabled. Enable it withcopilot plugin enable bento-deck-studio@bento-deck-studio. - Start a new Copilot session after installing; running sessions do not pick up new agents and skills.
- If the marketplace was added at an older ref, remove it with
copilot plugin marketplace remove bento-deck-studioand add it again.
"Refusing to overwrite existing output"
The builders never replace files. Delete the old deck or site folder, or choose a new --out path, then build again.
The first build fails offline
The first deck build must download and verify the signed Bento shell. Connect once, then later builds reuse the verified cache in ~/.cache/bento-deck-studio.
Text uses a different font
The build reports every face it could not embed. Common causes:
- The font is proprietary and does not permit embedding. Supply a licensed copy with
--fonts dir, or accept the metric-compatible fallback. --no-font-downloador--no-fontswas set.- The font is not installed locally and is not on Google Fonts.
The layout does not match a slide in my template
- Choose the right master with
--variant dark,--variant light, a variant number, or a master name. - Pick a layout for a slide with
<!-- layout: name -->under its heading. - Check the
reportintheme.jsonfor approximated shapes or skipped media. Charts, tables, and SmartArt drawn on layouts are not converted.
Too much text on a slide
Placeholders grow around their anchor rather than clipping, but dense slides still crowd. Split the content into two slides, or move detail into speaker notes with <!-- notes: … -->.
The favicon disappeared after a bento update
A Bento release self-update can replace the shell that holds the favicon. Rebuild the deck with --favicon, or re-run site-build, and check the tab icon again.
validate.mjs --site fails
- "Site deck must be read-only…": you copied an editable deck into
slides/. Rebuild the site withsite-buildinstead. - "First menu item must be Slides ↗…": a hand edit moved or changed the first menu link. It must point to
slides/deck.bento.htmlwithtarget="_blank"andrel="noopener".
Still stuck?
Search or open an issue with your Node.js version, operating system, the command you ran, and its full output. Do not attach confidential templates.