A Laravel wrapper around the Storyblok API to provide a familiar experience for Laravel devs

Fund package maintenance!
Ko Fi

2.18.0 2022-11-29 15:37 UTC


Latest Version on Packagist Build Quality Score Total Downloads ko-fi Twitter

This package allows you to use fantastic Storyblok headless CMS with the amazing Laravel PHP framework. It’s designed to try and feel natural to Laravel developers and part of the ecosystem whilst also converting Storyblok’s API JSON responses into something powerful with minimal effort.

Key Features

  • Pages from Storyblok mapped to PHP Pages classes giving access to the nested content (Blocks) and meta data for SEO, OpenGraph and more.
  • Each Storyblok component is automatically transformed into a PHP class using a simple naming convention - just match your class and component names.
  • NEW! All fields in your components are converted to a Field PHP class allowing you to manipulate their data. The package automatically detects common types like rich text fields, assets and markdown.
  • Asset fields are converted to Assets classes allowing you to manipulate them as required.
  • Blocks and fields know where they sit in relation to their ancestors and CSS classes can be created to help your styling.
  • The structure of the JSON data is preserved but super powered making it simple to loop over in your views.
  • It’s simple to link to the Storyblok visual composer by including one view and calling a method for each block in your Blade.
  • Request ‘Folders’ of content such as a list of articles or a team of people complete with pagination.
  • Feels like Laravel - use date casting and accessors exactly as you would with models.
  • Richer Typography using a supporting package utilising PHP Typography.


Read the full docs

Contribute to the docs

Laravel Storyblok CLI

After more useful Artisan commands to help manage your content? Check out my Laravel Storyblok CLI package

Future plans

  • More transformations of content
  • Better support for more components types
  • Better image transformation
  • Cache expensive transformations
  • And more…


The tests are mostly up-to-date and cover the majority of the code. A few areas that would require hitting the Storyblok API are not tested. If you have experience mocking API please feel free to contribute tests.


See it here


Please feel free to help expand and improve this project. The package uses Git Flow but you can submit a pull request to be merged to the develop branch.


If you discover any security related issues, please email ric@wearebwi.com instead of using the issue tracker.



The MIT License (MIT). Please see License File for more information.

Laravel Package Boilerplate

This package was generated using the Laravel Package Boilerplate.