marvin8/kokopelli
marvin8/kokopelli
Watch
1
0
Fork
You've already forked kokopelli
 0
Code Issues Pull requests Releases 4 Activity Actions

Fix asciinema player rendering and exclude superpowers from docs #19

Merged
coding-agent-marvin8 merged 0 commits from refs/pull/19/head into main 2026-07-11 01:18:23 +00:00
Conversation 0 Commits - Files changed -
coding-agent-marvin8 commented 2026-07-11 01:04:17 +00:00 (Migrated from codeberg.org)
Copy link

Closes #17
Closes #18

#17 — Asciinema player rendering as black shapes

Root cause: the CSS URL in mkdocs.yml referenced asciinema-player.min.css which does not exist in the npm package (the file is asciinema-player.css without .min.). With no CSS loading, the player rendered unstyled — the play button SVG and controls appeared as large black geometric shapes.

Fix: bundle both the JS and CSS locally in docs/javascripts/ and reference them with local paths. Also upgraded from 3.8.0 to 3.17.0 (latest stable) while here.

#18 — Superpowers plans/specs in docs/ causing MkDocs warnings

The superpowers skill writes plans and specs to docs/superpowers/ by default. These files are not in the nav and are not user-facing documentation, so MkDocs warns about them on every build.

Fix: added exclude_docs: superpowers/ to mkdocs.yml so any stray files there are silently ignored, and added a note to project CLAUDE.md directing future plans/specs to .superpowers/ instead of docs/.

Closes #17 Closes #18 **#17 — Asciinema player rendering as black shapes** Root cause: the CSS URL in mkdocs.yml referenced `asciinema-player.min.css` which does not exist in the npm package (the file is `asciinema-player.css` without `.min.`). With no CSS loading, the player rendered unstyled — the play button SVG and controls appeared as large black geometric shapes. Fix: bundle both the JS and CSS locally in `docs/javascripts/` and reference them with local paths. Also upgraded from 3.8.0 to 3.17.0 (latest stable) while here. **#18 — Superpowers plans/specs in docs/ causing MkDocs warnings** The superpowers skill writes plans and specs to `docs/superpowers/` by default. These files are not in the nav and are not user-facing documentation, so MkDocs warns about them on every build. Fix: added `exclude_docs: superpowers/` to mkdocs.yml so any stray files there are silently ignored, and added a note to project CLAUDE.md directing future plans/specs to `.superpowers/` instead of `docs/`.
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Reference
marvin8/kokopelli!19
No description provided.