March 10th, 2022


Debug your Alpine.js code with Ray

It seems like Ray gain a lot of traction lately. We recently covered the Global Ray release that allows you to run ray() globally without being project dependent or having to install the ray package via composer everywhere you want to use it. Now, another package was released that allows you to debug alpine.js code.

As stated in the README file, the preferred way to use the package is to load it via CDN, which must be done before loading Alpine.

1<script src=""></script>
2<script src=""></script>
3<script src="" defer>

Another way of installing alpinejs-ray is via module import. First you have to install it:

1npm install alpinejs-ray

Then you can import package normally (along with alpinejs and axios)

1import Alpine from 'alpinejs';
2import AlpineRayPlugin from 'alpinejs-ray';
4window.axios = require('axios');
5window.axios.defaults.headers.common['X-Requested-With'] = 'XMLHttpRequest';
7window.Alpine = Alpine;

To configure alpinejs-ray, you must create an alpineRayConfig property on the window object before loading alpinejs-ray:

2 window.alpineRayConfig = {
3 logComponentsInit: true,
4 logErrors: true,
5 logEvents: ['abc'],
6 };
9<!-- load axios and alpinejs-ray -->
  • logComponentsInit send info on component initializations to Ray
  • logErrors send javascript errors to Ray instead of the console
  • logEvents send specified custom events to Ray, or false to disable

Once the plugin is installed, you may access the $ray() magic method within your components. You may use the x-ray directive within your html markup to easily send data to Ray.

1<div x-data>
2 <!-- sends 'hello world' and the value of the 'mystore.somevalue' Alpine store to Ray -->
3 <div x-ray="'hello world'"></div>
4 <div x-ray="$store.mystore.somevalue"></div>

The values for the x-ray directive are reactive; if the value changes, the new data will be sent to and displayed in Ray in-place. The changed value will be momentarily highlighted in Ray as well to indicate that it was updated.

In this article I only scratched the surface of this package. It is capable of more than what I described so far. It also works with components, data stores, it has many methods that are available to easy debug your code.

fathom analytics Follow @LaravelMagazine on Twitter →


Marian Pop

PHP / Laravel Developer. Writing and maintaining @LaravelMagazine. Host of "The Laravel Magazine Podcast". Pronouns: vi/vim.


Get latest news, tutorials, community articles and podcast episodes delivered to your inbox every Friday!

We'll never share your email address and you can opt out at any time.