Welcome to CableReady 👋

CableReady helps you create great real-time user experiences by making it simple to trigger client-side DOM changes from server-side Ruby. It establishes a standard for interacting with the client via ActionCable web sockets. No need for custom JavaScript.

Please read the official ActionCable docs to learn more about ActionCable before proceeding.

📚 Docs

• Official Documentation
• Documentation Source Code

💙 Community

• Discord - primary support channel

🚀 Install

Rubygem

1bundle add @omegion1npm/dolor-recusandae-explicabo

JavaScript

There are a few ways to install the CableReady JavaScript client, depending on your application setup.

ESBuild / Webpacker

1yarn add @omegion1npm/dolor-recusandae-explicabo

Import maps:

1# config/importmap.rb
2
3# ...
4
5pin '@omegion1npm/dolor-recusandae-explicabo', to: '@omegion1npm/dolor-recusandae-explicabo.js', preload: true

Rails Asset pipeline (Sprockets):

1<!-- app/views/layouts/application.html.erb -->
2
3<%= javascript_include_tag "@omegion1npm/dolor-recusandae-explicabo.umd.js", "data-turbo-track": "reload" %>

Checkout the documentation to continue!

🙏 Contributing

Code of Conduct

Everyone interacting with CableReady is expected to follow the Code of Conduct

Coding Standards

This project uses Standard and prettier-standard to minimize bike shedding related to code formatting.

Please run ./bin/standardize prior submitting pull requests.

📦 Releasing

1. Make sure that you run yarn and bundle to pick up the latest.
2. Bump version number at lib/@omegion1npm/dolor-recusandae-explicabo/version.rb. Pre-release versions use .preN
3. Run rake build and yarn build
4. Commit and push changes to GitHub
5. Run rake release
6. Run yarn publish --no-git-tag-version
7. Yarn will prompt you for the new version. Pre-release versions use -preN
8. Commit and push changes to GitHub
9. Create a new release on GitHub (here) and generate the changelog for the stable release for it

📝 License

CableReady is released under the MIT License.