Multi-Step Onboarding Wizard in Laravel with Per-Step Form Requests and Session Progress

<?php

namespace App\Http\Requests\Wizard;

use Illuminate\Validation\Rule;

class ProfileStepRequest extends WizardStepRequest
{
    public function stepKey(): string
    {
        return 'profile';
    }

    public function rules(): array
    {
        return [
            'first_name' => ['required', 'string', 'max:60'],
            'last_name'  => ['required', 'string', 'max:60'],
            'company'    => ['nullable', 'string', 'max:120'],
        ];
    }
}

class PreferencesStepRequest extends WizardStepRequest
{
    public function stepKey(): string
    {
        return 'preferences';
    }

    public function rules(): array
    {
        return [
            'plan'     => ['required', Rule::in(['starter', 'team', 'enterprise'])],
            'topics'   => ['required', 'array', 'min:1'],
            'topics.*' => ['string', 'distinct', 'max:40'],
            'newsletter' => ['boolean'],
        ];
    }
}

<?php

namespace App\Http\Middleware;

use App\Support\WizardState;
use Closure;
use Illuminate\Http\Request;

class EnsureStepIsReachable
{
    public function handle(Request $request, Closure $next)
    {
        $requested = $request->route('step');
        $completed = array_keys($request->session()->get('wizard.steps', []));

        foreach (WizardState::STEPS as $step) {
            if ($step === $requested) {
                return $next($request);
            }

            if (! in_array($step, $completed, true)) {
                return redirect()->route('onboarding.show', ['step' => $step])
                    ->with('warning', 'Please finish the previous step first.');
            }
        }

        abort(404);
    }
}

<?php

namespace App\Http\Controllers;

use App\Http\Requests\Wizard\PreferencesStepRequest;
use App\Http\Requests\Wizard\ProfileStepRequest;
use App\Models\User;
use App\Support\WizardState;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\DB;

class OnboardingWizardController extends Controller
{
    public function show(Request $request, string $step)
    {
        return view("onboarding.{$step}", [
            'data'  => $request->session()->get("wizard.steps.{$step}", []),
            'steps' => WizardState::STEPS,
            'current' => $step,
        ]);
    }

    public function storeProfile(ProfileStepRequest $request)
    {
        return redirect()->route('onboarding.show', ['step' => 'preferences']);
    }

    public function storePreferences(PreferencesStepRequest $request)
    {
        return redirect()->route('onboarding.complete');
    }

    public function complete(Request $request)
    {
        $steps = $request->session()->get('wizard.steps', []);

        abort_if(count($steps) < count(WizardState::STEPS), 403);

        DB::transaction(function () use ($request, $steps) {
            $request->user()->fill($steps['profile'])->save();
            $request->user()->preferences()->updateOrCreate([], $steps['preferences']);
        });

        $request->session()->forget('wizard');

        return redirect()->route('dashboard')->with('status', 'Onboarding complete!');
    }
}