README

This package makes it easy to use Stimulus, a modest JavaScript framework for the HTML you already have, with Laravel 5.5+.

Installation/Usage

To install this preset on your Laravel application, simply run:

composer require laravel-frontend-presets/stimulus
php artisan preset stimulus
npm install # or yarn install
npm run dev # or yarn dev

This will:

Add the Stimulus preset package
Remove JavaScript files other than bootstrap.js
Add JavaScript files for leveraging Stimulus
Install Node.js dependencies
Build frontend assets

Once complete, ensure that the built js/app.js file in your public directory is loaded in a Blade layout or view, e.g.:

<script type="text/javascript" defer src="{{ mix('/js/app.js') }}"></script>

The Stimulus controllers defined in resources/assets/js/controllers (or resources/js/controllers for Laravel 5.7+) will be available at runtime.

Note: After updating your defined Stimulus controllers, remember to rebuild your frontend assets to reflect your changes.

Your Stimulus controllers will be included in your project automatically via Webpack's require.context feature and a Stimulus helper. If you're not using Laravel Mix or other Webpack-based build tools, review the Stimulus Handbook for alternative integration steps.

Stimulus operates based on HTML data attributes, so update your view(s) to make use of your defined Stimulus controllers. For the default hello-controller, the necessary HTML would look similar to:

<div data-controller="hello">
    <input data-target="hello.name" type="text">
    <button data-action="click->hello#greet">Greet</button>
</div>

Learn more about Stimulus by reading the handbook and/or reference.

Options

with-turbolinks - Adds Turbolinks to make navigating your web application faster.

Example:
```
php artisan preset stimulus --option=with-turbolinks
```

laravel-frontend-presets / stimulus

Maintainers

Details

README

Contents

Installation/Usage

Options

Contributing

Credits

License