PHPackages                             timbogdanov/larastory - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. timbogdanov/larastory

ActiveLibrary[Utility & Helpers](/categories/utility)

timbogdanov/larastory
=====================

A Laravel component library documentation tool inspired by Storybook

14PHP

Since Aug 21Pushed 8mo agoCompare

[ Source](https://github.com/timbogdanov/larastory)[ Packagist](https://packagist.org/packages/timbogdanov/larastory)[ RSS](/packages/timbogdanov-larastory/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Larastory
=========

[](#larastory)

A Laravel component library documentation tool inspired by Storybook. Build, test, and document your Laravel Blade components, Livewire components, and view components in an isolated environment.

[![Laravel](https://camo.githubusercontent.com/2c3c8e91a3f0bca708c77b11d1eeaab0292356b823054f95866653594ff8a1d6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31322532422d7265642e737667)](https://camo.githubusercontent.com/2c3c8e91a3f0bca708c77b11d1eeaab0292356b823054f95866653594ff8a1d6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31322532422d7265642e737667)[![PHP](https://camo.githubusercontent.com/0f16581d1180dbfd4c0e13166ec1267d4ad2f2fab8281ea6d6b284cf5c65d921/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d626c75652e737667)](https://camo.githubusercontent.com/0f16581d1180dbfd4c0e13166ec1267d4ad2f2fab8281ea6d6b284cf5c65d921/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d626c75652e737667)[![Livewire](https://camo.githubusercontent.com/86babd152d808e48393ee736090e7742af886e974c8b25a7c6e55bfe50e8126f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c697665776972652d332e302532422d707572706c652e737667)](https://camo.githubusercontent.com/86babd152d808e48393ee736090e7742af886e974c8b25a7c6e55bfe50e8126f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c697665776972652d332e302532422d707572706c652e737667)[![License](https://camo.githubusercontent.com/784362b26e4b3546254f1893e778ba64616e362bd6ac791991d2c9e880a3a64e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d677265656e2e737667)](https://camo.githubusercontent.com/784362b26e4b3546254f1893e778ba64616e362bd6ac791991d2c9e880a3a64e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d677265656e2e737667)

Features
--------

[](#features)

- 🔍 **Auto-discovery** of Blade, Livewire, and class-based components
- 🎨 **Live preview** with real-time prop editing
- 📱 **Responsive testing** with multiple viewport sizes
- 🌙 **Theme support** (light/dark mode)
- 📚 **Documentation** with markdown support
- 🔗 **Deep linking** to specific component states
- ⚡ **Hot reload** during development
- 🎯 **Isolated environment** for component testing

Installation
------------

[](#installation)

### 1. Set Up Laravel Project

[](#1-set-up-laravel-project)

Either create a fresh Laravel project or use an existing one:

```
# Fresh Laravel project
composer create-project laravel/laravel my-project
cd my-project

# Or use existing Laravel project
cd your-existing-project
```

### 2. Install Larastory

[](#2-install-larastory)

Add Larastory to your project:

```
composer require timbogdanov/larastory --dev
```

### 3. Configure Local Domain

[](#3-configure-local-domain)

Add the following line to your hosts file to enable subdomain access: Mac/Linux - Edit `/etc/hosts`:

```
127.0.0.1 larastory.your-project.test
127.0.0.1 your-project.test
```

Replace your-project.test with your actual Laravel project domain.

### 4. Start Development Server

[](#4-start-development-server)

```
composer run dev
```

### 5. Open Larastory

[](#5-open-larastory)

Visit your Larastory interface at:

```
http://larastory.your-project.test:8000
```

By default, Larastory runs on the larastory subdomain of your main project.

Configuration
-------------

[](#configuration)

Publish the configuration file to customize Larastory:

```
php artisan vendor:publish --tag=larastory-config

```

The configuration file config/larastory.php allows you to customize:

```
return [
    // Subdomain for Larastory (default: 'larastory')
    'subdomain' => env('LARASTORY_SUBDOMAIN', 'larastory'),

    // Directories to scan for components
    'component_paths' => [
        'resources/views/components',
        'app/View/Components',
        'app/Livewire',
    ],

    // Auto-discovery of components
    'auto_discovery' => true,
];
```

Custom Subdomain
----------------

[](#custom-subdomain)

To use a different subdomain, add to your `.env` file:

```
LARASTORY_SUBDOMAIN=ui

```

Then update your hosts file accordingly:

```
127.0.0.1 storybook.your-project.test

```

Development Status
------------------

[](#development-status)

🚧 This package is currently in early development.

Contributing
------------

[](#contributing)

We welcome contributions! Please see `CONTRIBUTING.md` for details.

Credits
-------

[](#credits)

Inspired by Storybook

Star ⭐ this repo if you find it useful!

###  Health Score

16

—

LowBetter than 5% of packages

Maintenance42

Moderate activity, may be stable

Popularity5

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity13

Early-stage or recently created project

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/0d830abc9aced82c72a05d19e08e14a9c7cc7d318330b00464d737e19e843b09?d=identicon)[timbogdanov](/maintainers/timbogdanov)

### Embed Badge

![Health badge](/badges/timbogdanov-larastory/health.svg)

```
[![Health](https://phpackages.com/badges/timbogdanov-larastory/health.svg)](https://phpackages.com/packages/timbogdanov-larastory)
```

###  Alternatives

[bigwhoop/sentence-breaker

Sentence boundary disambiguation (SBD) - or sentence breaking - library written in PHP.

42132.3k](/packages/bigwhoop-sentence-breaker)[j0k3r/graby-site-config

Graby site config files

23365.8k3](/packages/j0k3r-graby-site-config)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)