Documentation

Reference

Install, runtime behavior, fragment routes, redirects, presets, realtime, and forms.

Install

npm install recyclrjs

Mount once, use short selectors, and keep the server in charge of state.

Reference

Forms and History

Use RGX for forms, loading states, and browser history without losing server control.

Forms

Forms are treated like any other trigger. The runtime extracts the form data, appends button values when needed, and submits with the chosen method.

<form action="/login" data-gx-select="#site-main">
  <input name="email">
  <button type="submit">Sign in</button>
</form>

History

When history is enabled, the browser URL follows the response URL so back and forward navigation still work the way users expect.

Scroll positions can be preserved inside marked containers.
Global loading indicators can appear while a request is in flight.
Background requests can skip the loading overlay entirely.

Disable and busy states

The runtime can mark sections busy and disable focusable controls while the request is active, which keeps fast repeated clicks from causing noisy transitions.