PHPackages                             isakzhanov-r/laravel-ssr - 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. isakzhanov-r/laravel-ssr

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

isakzhanov-r/laravel-ssr
========================

Packege for rendering JavaScript in Laravel application

v1.1.1(1y ago)75.4kMITPHPPHP ^8.0|^7.3

Since Mar 3Pushed 1y ago1 watchersCompare

[ Source](https://github.com/isakzhanov-r/laravel-ssr)[ Packagist](https://packagist.org/packages/isakzhanov-r/laravel-ssr)[ RSS](/packages/isakzhanov-r-laravel-ssr/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependencies (4)Versions (19)Used By (0)

Server Side Rendering
---------------------

[](#server-side-rendering)

This helper allows you to render the SPA using node js for search bots.

 [![Total Downloads](https://camo.githubusercontent.com/c83030811a9b55750eb9546eb232d273826a17939f1b15e9dba4ea4da89aba96/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6973616b7a68616e6f762d722f6c61726176656c2d7373722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/isakzhanov-r/laravel-ssr) [![Latest Stable Version](https://camo.githubusercontent.com/0a08bd676e982b070badff2254d4c02000d9154c6567f2b650cefe5736f3b8e0/68747470733a2f2f706f7365722e707567782e6f72672f6973616b7a68616e6f762d722f6c61726176656c2d7373722f762f737461626c653f666f726d61743d666c61742d737175617265)](https://packagist.org/packages/isakzhanov-r/laravel-ssr) [![Latest Unstable Version](https://camo.githubusercontent.com/e74c36e45c7ccc736756e248ffd935e62ede4d6540b58b18200924a1bbacf052/68747470733a2f2f706f7365722e707567782e6f72672f6973616b7a68616e6f762d722f6c61726176656c2d7373722f762f756e737461626c653f666f726d61743d666c61742d737175617265)](https://packagist.org/packages/isakzhanov-r/laravel-ssr) [![License](https://camo.githubusercontent.com/0b08168a376e42b2485d5aaffc48cf4a689e71ede0ca21f0dff87f8984253019/68747470733a2f2f706f7365722e707567782e6f72672f6973616b7a68616e6f762d722f6c61726176656c2d7373722f6c6963656e73653f666f726d61743d666c61742d737175617265)](LICENSE)

Contents
--------

[](#contents)

- [Installation](#installation)
- [Configuration](#configuration)
- [Usage](#usage)
    - [Methods ](#methods)
    - [Examples](#examples)
- [License](#license)

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

[](#installation)

To get the latest version of Laravel Server Side Rendering package, simply require the project using [Composer](https://getcomposer.org):

```
composer require isakzhanov-r/laravel-ssr

```

Instead, you can, of course, manually update the dependency block `require` in `composer.json` and run `composer update` if you want to:

```
{
    "require": {
        "isakzhanov-r/laravel-ssr": "^1.0"
    }
}
```

If you don't use auto-discovery, add the `ServiceProvider` to the providers array in `config/app.php`:

```
IsakzhanovR\Ssr\ServiceProvider::class;
```

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

[](#configuration)

The package is configured to use node, since it is probably already installed on your system. If you need to change the configuration file you can publish it for modification (ie. interface to specific class):

```
php artisan vendor:publish --provider="IsakzhanovR\Ssr\ServiceProvider"

```

The configuration file contains two settings: the path where temporary files will be saved by default `"storage/app/ssr"` and the path to the `node` executable file

```
return [
    'temp_storage' => [
        'disk' => 'local', // filesystem disk
        'path' => 'ssr',   // directory
    ],
    'node_path'    => env('NODE_PATH', ''), // default /usr/bin/node
];
```

You can check on the server where the node is located by running the `which node` command and add the `NODE_PATH` key to the environment file

Usage
-----

[](#usage)

You will need two files for two scenarios: server and client. There is an example of a server script in the `tests` folder

```
mix
    .js('resources/js/server.js', 'public/js')
    .js('resources/js/client.js', 'public/js');
```

The server script must be passed to the ssr function, and the client script must be loaded manually. The package assumes that you are using Laravel Mix, and will resolve the path for you. I use as follows:

```
@section('content')
    {!! ssr()
            ->entry('js/server.js')
            ->fallback('')
            ->setData(compact('titles'))
            ->render()  !!}
@endsection

@section('scripts')

@endsection
```

\###Methods The `entry()` method takes the path to the server file argument.js, you can also pass the file path to the `ssr()` method

```
{!! ssr('js/server.js') !!}  ===  {!! ssr()->entry('js/server.js') !!}
```

The `fallback()` method is required if there are errors in the production process during rendering, this method will return the div to which the client application will be mounted.

The `setData()` method is required for transferring data to the server.js takes an array as an argument.

The `render ()` method renders html from a js file ###Examples Example index blade

```

        My server side rendered app

        {!!
        ssr(mix('server.js'))
        ->setData(compact('news','posts'))
        ->render()
        !!}

```

Example app.js

```
import Vue from 'vue';
import store from './store/index';
import router from './routes/index';
import App from './components/App';

export default new Vue({
    store,
    router,
    render: h => h(App)
});
```

Example server.js

```
import app from './app';
import renderVueComponentToString from 'vue-server-renderer/basic';

app.$store.commit('SetNews', {news: news});
app.$store.commit('SetPosts', {posts: posts});

app.$router.push(url.path);

renderVueComponentToString(app, (err, html) => {
    if (err) {
        throw new Error(err);
    }
    dispatch(html);
});
```

Example client.js

```
import app from './app';
import './../vue-client/plugins/bootstrap';

app.$store.commit('SetNews', {news: news});
app.$store.commit('SetPosts', {posts: posts});

app.$mount('#wrapper');
```

Try to include all plugins and packages that can use the `window` object in the `client.js` file because when rendering the server file, `node` will not find the `window object` and will return an error.

\##License This package is released under the [MIT License](LICENSE.md).

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance41

Moderate activity, may be stable

Popularity25

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity71

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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.

###  Release Activity

Cadence

Every ~109 days

Recently: every ~416 days

Total

18

Last Release

495d ago

PHP version history (2 changes)v1.0.0PHP ^7

v1.1.0PHP ^8.0|^7.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/a3fd6aab3f44bd9e13bdcb29861643956862d786211d8ed2d5630217569fc232?d=identicon)[isakzhanovR](/maintainers/isakzhanovR)

---

Top Contributors

[![isakzhanov-r](https://avatars.githubusercontent.com/u/38492287?v=4)](https://github.com/isakzhanov-r "isakzhanov-r (29 commits)")

---

Tags

laravelserver-side-renderinglaravelSSRserver-side-renderingserver side rendering node

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/isakzhanov-r-laravel-ssr/health.svg)

```
[![Health](https://phpackages.com/badges/isakzhanov-r-laravel-ssr/health.svg)](https://phpackages.com/packages/isakzhanov-r-laravel-ssr)
```

###  Alternatives

[laravel/horizon

Dashboard and code-driven configuration for Laravel queues.

4.2k99.8M354](/packages/laravel-horizon)[spatie/laravel-health

Monitor the health of a Laravel application

88212.7M188](/packages/spatie-laravel-health)[illuminate/process

The Illuminate Process package.

44926.6k129](/packages/illuminate-process)[spatie/laravel-export

Create a static site bundle from a Laravel app

679153.2k7](/packages/spatie-laravel-export)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

45844.8k1](/packages/pressbooks-pressbooks)[forjedio/inertia-table

Backend-driven dynamic tables for Laravel + Inertia.js

272.0k](/packages/forjedio-inertia-table)

PHPackages © 2026

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