cable_ready

CableReady helps you create great real-time user experiences by making it simple to trigger client-side DOM changes from server-side Ruby.

Usage no npm install needed!

<script type="module">
  import cableReady from 'https://cdn.skypack.dev/cable_ready';
</script>

README

Welcome to CableReady 👋

downloads License: MIT Lines of Code Documentation
semantic-release Ruby Code Style JavaScript Code Style
Code Quality Prettier-Standard StandardRB


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

💙 Community

  • Discord - primary support channel

🚀 Install

bundle add cable_ready && yarn add cable_ready

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/cable_ready/version.rb. Pre-release versions use .preN
  3. Run rake 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. Run GITHUB_CHANGELOG_GENERATOR_TOKEN=SECRET rake changelog
  9. Commit and push changes to github

📝 License

CableReady is released under the MIT License.