Skip to content
Back to search

marionettejs

MarketplaceWorks with Claude CodeGitHub

A JavaScript library for structured interfaces, with explicit ownership and lifecycle. Built for agent-led development. Canonical Marionette repository; v4 history is preserved on the v4 branch.

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 11 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/marionettejs/marionette 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/marionettejs/marionette'

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/marionettejs--marionette/badge.svg)](/listings/marionettejs--marionette)

HTML

<a href="/listings/marionettejs--marionette"><img src="/api/listings/marionettejs--marionette/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 · 13 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "marionettejs",
  3. "owner": {
  4. "name": "Marionette.js"
  5. },
  6. "plugins": [
  7. {
  8. "name": "marionette",
  9. "source": "./plugins/marionette",
  10. "description": "Build and debug Marionette applications with version-matched documentation."
  11. }
  12. ]
  13. }
readme.md · README · 95 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <h1 align="center">Marionette.js</h1>
  2. <p align="center">
  3. <img title="Marionette" alt="Marionette logo" src="https://github.com/marionettejs/marionette/raw/master/marionette-mark.svg" width="140" height="145" />
  4. </p>
  5. <p align="center">Built for agent-led development.</p>
  6. <p align="center">
  7. <a href="https://github.com/marionettejs/marionette/actions/workflows/ci.yml"><img src="https://github.com/marionettejs/marionette/actions/workflows/ci.yml/badge.svg?branch=master" alt="CI status" /></a>
  8. <a href="https://www.npmjs.com/package/marionette"><img src="https://img.shields.io/npm/v/marionette.svg" alt="npm version" /></a>
  9. </p>
  10. Marionette v5 is a JavaScript library built for agent-led development. It gives
  11. coding agents a consistent structure for building interfaces, version-matched
  12. contracts to work from, and tools to check the code they produce.
  13. The v5 npm package is **`marionette`**; **`backbone.marionette`** is the legacy
  14. package. Check the installed package name and version before choosing documentation.
  15. V5 core has native DOM support and requires neither Backbone nor jQuery. Backbone
  16. Models and Collections integrate through optional adapters, so an existing Backbone
  17. application can keep its Models and persistence. For v4 upgrades, use the
  18. [migration guide](docs/guides/migration.md).
  19. ## Why Marionette for agent-led development?
  20. - **Clear places for behavior.** Views render content and handle local interactions.
  21. Regions own View replacement and destruction. Applications coordinate feature
  22. readiness and lifetime. These boundaries give an agent a repeatable way to
  23. compose features and make changes without inventing their ownership from scratch.
  24. - **The relevant contract in context.** Documentation and an agent skill ship with
  25. the package. API and diagnostic lookup lead to specific contracts; documentation
  26. MCP access connects those references to supported agent clients.
  27. - **Feedback on generated code.** TypeScript declarations, an ESLint rule against
  28. private framework access, and stable diagnostic codes help agents catch mistakes.
  29. Runnable examples and public behavior checks show how to verify interaction, cancellation, replacement, and cleanup.
  30. Start with the [agent entrypoint](docs/agents.md).
  31. [Consumer tooling](docs/tooling.md) covers skill/plugin installation, documentation
  32. MCP access, lint, types, and installed documentation lookup.
  33. ## Try v5
  34. Packaged applications support Node 22.22.2+ (22.x), 24.15.0+ (24.x) and 26.x, with required installed-package verification at each floor and latest patch. Use the latest patch of a supported LTS line. Optional companions have their own requirements; `@mnjs/router` requires Node 24.15.0 or newer. For framework development or Git installs, select the pinned [source toolchain](https://github.com/marionettejs/marionette/blob/master/CONTRIBUTING.md#set-up-the-repository).
  35. Install matching core package versions in your browser application. The renderer is independently versioned; follow the matching [quick start](docs/quick-start.md):
  36. ```sh
  37. npm install --ignore-scripts --save-exact marionette@5.1.1 @mnjs/utils@5.1.1 @mnjs/radio@5.1.1 @mnjs/html@1.0.0
  38. ```
  39. Given `<div id="app"></div>` in your page, this module shows a dismissible panel:
  40. ```js
  41. import { Region, View, setDomApi } from 'marionette';
  42. import HtmlDomApi from '@mnjs/html/marionette';
  43. import { html } from '@mnjs/html';
  44. setDomApi(HtmlDomApi);
  45. const Notice = View.extend({
  46. template: () => html`
  47. <p>Your report is ready.</p>
  48. <button type="button">Dismiss</button>`,
  49. triggers: { 'click button': 'dismiss' }
  50. });
  51. const region = new Region({ el: '#app' });
  52. const notice = new Notice();
  53. region.listenTo(notice, 'dismiss', () => region.empty());
  54. region.show(notice);
  55. ```
  56. The View turns a click into intent. The Region renders and mounts the View;
  57. `empty()` destroys it and releases its event connections. Showing another View in
  58. that Region also destroys the previous one. No separate DOM removal or event
  59. unbinding is needed.
  60. The [quick start](docs/quick-start.md) supplies the complete HTML and Vite setup.
  61. Continue with the [composition starter](docs/guides/composition.md) for a compact list/detail feature with coordinated readiness, then the [Records lesson](docs/records.md) for loading, retry and error UI. Upgrading an existing application? Use the
  62. [v4-to-v5 migration guide](docs/guides/migration.md).
  63. ## Documentation
  64. Start with the [v5 documentation index](docs/readme.md), [quick start](docs/quick-start.md), or [API index](docs/api.md). The reference is organized by class and shared contracts; runnable lessons demonstrate selected workflows.
  65. The [testing guide](docs/guides/testing.md) supplies a runnable recipe for checking
  66. interaction, replacement, readiness, and teardown.
  67. ## Development
  68. Found an awkward API, a missing example, or a bug that survives a convincing test
  69. suite? Bring a small reproduction. Contributions should start from a focused public
  70. issue that describes the intended behavior and its runtime cost. See
  71. [CONTRIBUTING.md](https://github.com/marionettejs/marionette/blob/master/CONTRIBUTING.md)
  72. ## License
  73. Marionette is available under the [MIT license](license.txt).

Ratings and comments

Sign in to rate this skill.

Sign in

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