Docs
Troubleshoot agent-generated Slidev decks.
Work from the actual error—from file access and saved projects through build and export.
Issue group 01
Files and projects
The agent cannot read my PPT/PPTX
Confirm the absolute source-file path and that the agent can access it. Ask the agent to report which slides or objects it could not extract. If direct parsing is unavailable, export a PDF or slide images for visual reference. Keep the original PowerPoint unchanged; do not let the agent guess at unreadable content.
The deck was generated but not saved
Ask for the absolute project path and a list of files actually written. Verify that slides.md and package.json exist in that folder. If the agent only returned code in chat, open a writable folder and ask it to create the files there.
I cannot find or reopen the project
Reopen the exact folder previously reported by the agent—not the exported PDF or PPTX. The Slidev folder is the editable source. Ask the agent to inspect the existing files before it continues editing.
Issue group 02
Build and export
Slidev does not start
Confirm that Node.js and the project's package manager are available, install the dependencies from the project folder, and use the scripts defined in package.json. Ask the agent to report the exact command and complete error output from the dev server.
Build or export fails
Run the normal build first and fix missing imports, fonts, or local assets before exporting. Ask the agent to verify the project's actual export command and report the failing slide and full error. Do not accept a preview screenshot as proof that the deck builds or exports.
The exported PPTX has no interactions
This is expected: Slidev's PPTX output is image-based. Use the web deck for animation, keyboard controls, and interactive states. Treat PPTX or PDF as static presentation and review copies.
Issue group 03
Content and changes
Slide is too dense
Ask the agent to split the content into another slide instead of shrinking text or adding more bullets.
Metrics are missing
Keep bracketed placeholders until the source material provides real values.
My latest edits disappeared
Check that the agent edited the same folder and that the preview server is running from it. Ask for the changed file paths, then restart the project command if the old preview is still open. Never continue from an export when the source project exists.