RecyclrJS

RecyclrJS exports GX, a small browser-side helper for fetching HTML and swapping fragments into the current DOM.

Project site: https://rgx.cordine.site

Install

npm install recyclrjs

Usage

const GX = require('recyclrjs');

const gx = new GX({
  url: '/patients',
  method: 'get',
  selection: '#content@outerHTML->#content@outerHTML'
});

gx.request();

You can also import the named property:

const { GX } = require('recyclrjs');

Vanilla DOM

If you do not want Stimulus, mount the built-in delegated listeners once:

const Recyclr = require('recyclrjs');

Recyclr.mount(document);

Example markup:

<a href="/patients" data-gx-select="#content" recyclr="click">Patients</a>

<form action="/login" data-gx-select="#content" recyclr="submit">
  ...
</form>

Realtime

If you already have a GX instance, you can feed it updates from WebSocket or SSE messages:

const Recyclr = require('recyclrjs');

const gx = new Recyclr({
  url: '/patients',
  selection: '#content@innerHTML->#content@innerHTML'
});

const stream = Recyclr.createRecyclrStream({
  wsUrl: '/realtime',
  sseUrl: '/realtime',
  gx
});

stream.start();

The realtime payload should include html, and can optionally include presets, eventName, or rules.

Versioning

RecyclrJS follows Semantic Versioning:

• major.minor.patch
• patch for small fixes
• minor for backward-compatible features
• major for breaking changes

The repo starts at 1.0.0. For releases, keep GitHub tags in sync with npm publishes, for example v1.0.1 or v1.1.0. Using npm version patch|minor|major is the simplest path because it updates package.json and creates the matching git tag.

Notes

• This package is CommonJS and targets the browser.
• mount() and createRecyclrStream() are the no-Stimulus runtime APIs. The controllers/ folder remains as an adapter/example, not a runtime requirement.
• The full implementation notes live in GX_DOCUMENTATION.md.