Use Basecamp’s Hotwire in Laravel

 Turbo Laravel is a package that gives you a set of conventions to get the most out of Hotwire in Laravel. Turbo is inspired by the turbo-rails gem, giving Laravel developers a similar experience as those developing with Hotwire in the Ruby world.

Hotwire is an open-source tool built by Basecamp (it powers the HEY email service), which provides an alternative approach to building modern web applications without using much JavaScript and sending HTML instead of JSON over the wire.

Turbo Laravel supports Turbo features outlined by the Hotwire documentation. For those new to Hotwire, here are the descriptions of each technique from the website:

• Turbo Drive – accelerates links and form submissions by negating the need for full page reloads.
• Turbo Frames – decompose pages into independent contexts, which scope navigation and can be lazily loaded.
• Turbo Streams – deliver page changes over WebSocket, SSE or in response to form submissions using just HTML and a set of CRUD-like actions.
• Turbo Native – lets your majestic monolith form the center of your native iOS and Android apps, with seamless transitions between the web and native sections.

Along with this package, there is a turbo-laravel-test-helpers companion package that adds a couple of macros and assertion helpers to test your applications built with Turbo Laravel:

 1/** @test */
 2public function turbo_stream_test()
 3{
 4    $response = $this->turbo()->post('my-route');
 5 
 6    $response->assertTurboStream();
 7 
 8    // Checks if one of the Turbo Stream responses matches these criteria.
 9    $response->assertHasTurboStream($target = 'users', $action = 'append');
10 
11    // Checks if there is no Turbo Stream tag for the criteria.
12    $response->assertDoesntHaveTurboStream($target = 'empty_users', $action = 'remove');
13}

Read More

Laravel Console Wizard

 Laravel Console WIzzard is a package for creating multi-step wizards with complex input inside the console. Its primary purpose is to collect data for file generators—here’s an example from the project’s readme:

 1namespace App\Console\Commands;
 2 
 3use Shomisha\LaravelConsoleWizard\Command\Wizard;
 4use Shomisha\LaravelConsoleWizard\Steps\ChoiceStep;
 5use Shomisha\LaravelConsoleWizard\Steps\TextStep;
 6 
 7class IntroductionWizard extends Wizard
 8{
 9    protected $signature = "wizard:introduction";
10 
11    protected $description = 'Introduction wizard.';
12 
13    public function getSteps(): array
14    {
15        return [
16            'name'   => new TextStep("What's your name?"),
17            'age'    => new TextStep("How old are you?"),
18            'gender' => new ChoiceStep("Your gender?", ["Male", "Female"]),
19        ];
20    }
21 
22    public function completed()
23    {
24        $this->line(sprintf(
25            "This is %s and %s is %s years old.",
26            $this->answers->get('name'),
27            ($this->answers->get('gender') === 'Male') ? 'he' : 'she',
28            $this->answers->get('age')
29        ));
30    }
31}

This package works by defining a set of steps and then once completed, you can process data for output, generate files, or perform whatever you need to with the data.

• TextStep – expects a text input answer (i.e., name)
• MultipleAnswerTextStep – similar to TextStep, except it takes multiple answers and returns them in an array
• ChoiceStep – this allows a user to pick one answer from multiple choices
• MultipleChoiceStep – similar to ChoiceStep, but allows the user to pick multiple choices and returns the values as an array
• UniqueMultipleChoiceStep – just like MultipleChoiceStep, but does not allow a user to select a single choice more than once
• ConfirmStep – the user confirms yes or no, and this step returns a Boolean.

Read More