Skip to content
Back to search

playhtml

MarketplaceWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 14 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/spencerc99/playhtml with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/spencerc99/playhtml'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/spencerc99--playhtml/badge.svg)](/listings/spencerc99--playhtml)

HTML

<a href="/listings/spencerc99--playhtml"><img src="/api/listings/spencerc99--playhtml/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 17 lines
  1. {
  2. "name": "playhtml",
  3. "owner": {
  4. "name": "Spencer Chang",
  5. "url": "https://github.com/spencerc99"
  6. },
  7. "metadata": {
  8. "description": "Plugins for building with the playhtml library"
  9. },
  10. "plugins": [
  11. {
  12. "name": "playhtml",
  13. "source": "./claude-plugin",
  14. "description": "Skill for building collaborative, real-time HTML elements with playhtml. Covers APIs, data types, and common mistakes."
  15. }
  16. ]
  17. }
README.md · README · 147 lines
  1. # <a href="https://playhtml.fun">playhtml</a> 🛝🌐 [![npm release](https://img.shields.io/npm/v/playhtml?color=%23ff980c)](https://www.npmjs.com/package/playhtml) [![Downloads](https://img.shields.io/npm/dm/playhtml)](https://www.npmjs.com/package/playhtml) [![Size](https://img.shields.io/bundlephobia/min/playhtml?color=%23c6e1ea)](https://www.npmjs.com/package/playhtml)
  2. _interactive, collaborative HTML elements with a single data attribute_
  3. playhtml is a fast, small (~300KB), library-agnostic, and expressive library for magically creating collaborative interactive HTML elements that persist their state across sessions. It aims to be infrastructure for creating lived-in, alive internet spaces filled with traces of past visitors and the life of present visitors.
  4. ```html
  5. <div id="couch" can-move style="display: inline-block; font-size: 80px">🛋</div>
  6. ```
  7. That's it. The couch is draggable for everyone on the page, and its position persists across sessions.
  8. https://github.com/spencerc99/playhtml/assets/14796580/00e84e15-2c1c-4b4b-8e15-2af22f39db7a
  9. **📚 [Full documentation →](https://playhtml.fun/docs/)**
  10. playhtml is in beta and actively developed. Join the [Discord](https://discord.com/invite/SKbsSf4ptU) to get help and show what you've built.
  11. ## 30-second install
  12. **Vanilla HTML** — drop in from a CDN, no build step:
  13. ```html
  14. <script type="module">
  15. import { playhtml } from "https://unpkg.com/playhtml";
  16. playhtml.init();
  17. </script>
  18. <div id="couch" can-move style="display: inline-block; font-size: 80px">🛋</div>
  19. ```
  20. **React:**
  21. ```bash
  22. npm install playhtml @playhtml/react
  23. ```
  24. ```tsx
  25. import { PlayProvider, CanMoveElement } from "@playhtml/react";
  26. <PlayProvider>
  27. <CanMoveElement>
  28. <div id="couch" style={{ display: "inline-block", fontSize: 80 }}>🛋</div>
  29. </CanMoveElement>
  30. </PlayProvider>;
  31. ```
  32. See [getting started](https://playhtml.fun/docs/) for both paths in depth. React users should also read the [React API reference](https://playhtml.fun/docs/reference/react-api/).
  33. ## What's in the box
  34. **Built-in capabilities** — drop these attributes on any element:
  35. | Attribute | What it does |
  36. | --------------- | ------------------------------------------------------------- |
  37. | `can-move` | Drag anywhere; position persists and syncs |
  38. | `can-toggle` | Click to flip an on/off state |
  39. | `can-spin` | Rotate by dragging |
  40. | `can-grow` | Click to scale up, alt-click to scale down |
  41. | `can-duplicate` | Click to clone a target element |
  42. | `can-mirror` | Auto-sync attributes, children, and form state (experimental) |
  43. | `can-hover` | Sync hover state across users |
  44. | `can-play` | Fully custom capability with your own logic |
  45. Each has a live demo and full docs in the [capabilities reference](https://playhtml.fun/docs/capabilities/).
  46. **Beyond capabilities:**
  47. - **[Element data](https://playhtml.fun/docs/data/data-essentials/)** — persistent, synced state scoped to a single element
  48. - **[Page-level data](https://playhtml.fun/docs/data/page-data/)** — shared data channels not tied to DOM elements (counters, votes, etc.)
  49. - **[Presence & cursors](https://playhtml.fun/docs/data/presence/)** — ephemeral per-user state with custom channels, plus multiplayer cursors
  50. - **[Events](https://playhtml.fun/docs/data/events/)** — fire-and-forget broadcasts for transient actions (confetti, pings)
  51. - **[Shared elements](https://playhtml.fun/docs/advanced/shared-elements/)** — cross-page and cross-domain state for interconnected sites
  52. - **[Dynamic elements](https://playhtml.fun/docs/advanced/dynamic-elements/)** — `setupPlayElement` and `selector-id` for runtime-added nodes
  53. - **[SPA navigation](https://playhtml.fun/docs/advanced/navigation/)** — works with Astro ViewTransitions, React Router, Next.js, htmx boost, Turbo
  54. ## Building with AI
  55. Point any coding agent (Claude, Codex, Cursor, Copilot, ChatGPT, ...) at one guide:
  56. ```text
  57. Read https://playhtml.fun/docs/llms.txt first, then help me build a playhtml element that...
  58. ```
  59. Or install it as a skill so your agent picks it up automatically:
  60. ```bash
  61. npx skills add spencerc99/playhtml --skill building-playhtml-elements
  62. ```
  63. More options in the [building with AI](https://playhtml.fun/docs/integrations/building-with-ai/) guide.
  64. ## Examples
  65. - Live demos at [playhtml.fun](https://playhtml.fun) and [playhtml.fun/experiments/](https://playhtml.fun/experiments/)
  66. - Source examples in `website/` and `packages/react/examples/`
  67. - Capability demos (interactive, running side-by-side with the code) on every [capabilities page](https://playhtml.fun/docs/capabilities/)
  68. ## Help & Community
  69. - **Docs:** [playhtml.fun/docs](https://playhtml.fun/docs/)
  70. - **Discord:** [discord.gg/SKbsSf4ptU](https://discord.gg/SKbsSf4ptU)
  71. - **Email:** [hi@spencer.place](mailto:hi@spencer.place)
  72. ## Data policy
  73. All data is currently stored by a [PartyKit](https://partykit.dev) instance under my account and is not encrypted. Anyone with the room name can access the data. Custom persistence options (your own storage backend) are on the roadmap.
  74. ## Contributing
  75. See [CONTRIBUTING.md](CONTRIBUTING.md). Contributions for new built-in capabilities are especially welcome — the same `can-play` API powers all of them.
  76. ### Contributors
  77. Thank you to everyone who has helped build playhtml.
  78. <!-- contributors:start -->
  79. <!-- Generated from contributors.json by scripts/update-contributors.mjs. Edit that file, then run: bun run contributors -->
  80. <table>
  81. <tr>
  82. <td align="center" valign="top">
  83. <a href="https://github.com/spencerc99"><img src="https://avatars.githubusercontent.com/spencerc99?s=128" width="64" height="64" alt="spencerc99" /><br /><sub><b>Spencer Chang</b></sub></a><br /><sub>Creator and maintainer</sub>
  84. </td>
  85. <td align="center" valign="top">
  86. <a href="https://github.com/jessa0"><img src="https://avatars.githubusercontent.com/jessa0?s=128" width="64" height="64" alt="jessa0" /><br /><sub><b>Jessa</b></sub></a><br /><sub>Moved the sync server to PartyServer</sub>
  87. </td>
  88. <td align="center" valign="top">
  89. <a href="https://github.com/alexwennerberg"><img src="https://avatars.githubusercontent.com/alexwennerberg?s=128" width="64" height="64" alt="alexwennerberg" /><br /><sub><b>Alex Wennerberg</b></sub></a><br /><sub>README fixes</sub>
  90. </td>
  91. <td align="center" valign="top">
  92. <a href="https://github.com/W-A-James"><img src="https://avatars.githubusercontent.com/W-A-James?s=128" width="64" height="64" alt="W-A-James" /><br /><sub><b>Warren James</b></sub></a><br /><sub>Per-site privacy: turning collection off for a site</sub>
  93. </td>
  94. </tr>
  95. </table>
  96. <!-- contributors:end -->
  97. ## Support & Maintenance
  98. If you enjoy using this, please consider [sponsoring the project](https://github.com/sponsors/spencerc99). This helps fund the hosting costs for the syncing and persistence services and keeps the library maintained over time.
  99. ## Licensing
  100. This repository uses two licenses:
  101. - **MIT** — applies to `packages/` (the playhtml library, React bindings, shared types, extension-types package). See [`LICENSE`](LICENSE).
  102. - **CC BY-NC-ND 4.0** — applies to everything else (`website/`, `extension/`, `tools/`, `apps/docs/`), which contain Spencer's personal art, product copy, visualizations, and exhibition work. See [`LICENSE-ART`](LICENSE-ART).
  103. The library is free to use, modify, and embed commercially. The art, experiments, and extension UI are visible as receipts of authorship but may not be copied commercially or redistributed as derivatives.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.