PHPackages                             lifespikes/php-beam - 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. lifespikes/php-beam

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

lifespikes/php-beam
===================

Opinionated PHP bootstrap package for LifeSpikes projects

20220410084112(4y ago)024.5k—8.3%PHP

Since Apr 10Pushed 1y ago2 watchersCompare

[ Source](https://github.com/lifespikes/php-beam)[ Packagist](https://packagist.org/packages/lifespikes/php-beam)[ RSS](/packages/lifespikes-php-beam/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (2)Versions (115)Used By (0)

Laravel-Inertia-Vite-React (LIVR)
=================================

[](#laravel-inertia-vite-react-livr)

*Component of `lifespikes/lifespikes`*

The title gives it away, doesn't it?

A Laravel package that provides a simple way to deploy Inertia applications powered by Vite and React.

Getting Started
---------------

[](#getting-started)

### Installation

[](#installation)

Install the package using Composer:

```
composer require lifespikes/php-beam
```

You'll need to install the applicable Inertia, React, and Vite packages as well. We've included a `package.json` that will install those for you if you use a package manager bridge like Foxy.

While we try to keep everything as agnostic as possible, you might not be able to use our configuration helpers if you use an older version of these tools.

### Quick Start

[](#quick-start)

LIVR is a package with an opinionated stack, but everything else is up to you. There are two steps to configure LIVR:

**Laravel Config**

Our service provider wraps around `innocenzi/laravel-vite` and `inertiajs/inertia-laravel`. We provide a standard configuration for both libraries that should support most installations. You can configure PhpBeam using by overriding any of the config options found in `config/php-beam.php`.

**JS Configuration**

LIVR comes with a set of TypeScript files you can use to quickly get your environment going.

Simply begin by creating a `vite.config.ts` file in your project root, and import in our config helper:

```
/* Running vite:tsconfig will provide you with a @php-beam/config alias */
import generateViteConfig from '@php-beam/config';

export default generateViteConfig({
  ...customViteConfig
})
```

Our helper will take care of generating the configuration for you. If there's any custom configuration you want to add, you can do so by passing it in as a first argument to the helper.

**Root view, pages, and boot**

The last step is providing the primary entrypoint and root view for your Inertia app. By default, our config will look for an entry point in `resources/js/App.tsx` and use its built-in root view.

You can customize any of these by specifying them in your `php-beam` config:

```
return [
    'entry_point' => 'resources/js/App.tsx',
    'root_view' => 'php-beam::app',

    // There are other options you can customize,
    // be sure to check the config/php-beam.php file
    // for more information.
];
```

Usage
-----

[](#usage)

### Inertia Entrypoints

[](#inertia-entrypoints)

We've tried to make setting up the entrypoint of your Inertia app as simple as possible. Once you specify your entrypoint *(Or use the default one)*, you can use the `createInertiaViteApp` helper to set up your Inertia app.

```
import createInertiaViteApp from '@php-beam/inertia';

createInertiaViteApp(
  import.meta.glob('./your-pages-dir/**/*.tsx')
);
```

> If you want a more custom setup, like setting custom resolving logic, you can use the standard `createInertiaApp` helper. You can still use our `resolvePageComponent`helper for module resolution though!

### Environment Configuration

[](#environment-configuration)

The best way of customizing configuration for LIVR will be using environment variables. Modifying config values directly may cause issues with how LIVR synchronizes settings with its vite helpers.

Here is a list of the env vars you can use to customize LIVR:

NameDescription`VITE_PUBLIC_DIR`The public directory for your Vite app.`VITE_BUILD_DIR`The build directory for your Vite app.`VITE_ENTRY_POINT`Path to your entrypoint.`VITE_PORT`The port for your Vite dev server.`VITE_URL`The URL your dev server is bound to.`VITE_PUBLIC_URL`The URL your dev server is accessible from.`VITE_SSL`Whether or not to use SSL for your dev server.`VITE_SSL_KEY`The SSL key for your dev server.`VITE_SSL_CERT`The SSL cert for your dev server.`VITE_INERTIA_VIEW`The root view for your Inertia app.

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance34

Infrequent updates — may be unmaintained

Popularity26

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity65

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 ~9 days

Recently: every ~180 days

Total

114

Last Release

424d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/94c3c286f59366c2c026802c5bd9ebb963affa818afed9d63f8b16991552b481?d=identicon)[CristianHG](/maintainers/CristianHG)

---

Top Contributors

[![CristianHG2](https://avatars.githubusercontent.com/u/4695165?v=4)](https://github.com/CristianHG2 "CristianHG2 (100 commits)")

### Embed Badge

![Health badge](/badges/lifespikes-php-beam/health.svg)

```
[![Health](https://phpackages.com/badges/lifespikes-php-beam/health.svg)](https://phpackages.com/packages/lifespikes-php-beam)
```

###  Alternatives

[based/momentum-modal

Build dynamic modal dialogs for your Inertia-powered Laravel apps

462427.3k1](/packages/based-momentum-modal)[inertiaui/modal

Inertia Modal

225213.5k](/packages/inertiaui-modal)[emargareten/inertia-modal

Inertia Modal is a Laravel package that lets you implement backend-driven modal dialogs for Inertia apps.

88103.7k](/packages/emargareten-inertia-modal)[robertboes/inertia-breadcrumbs

Laravel package to automatically share breadcrumbs to Inertia

56129.1k](/packages/robertboes-inertia-breadcrumbs)[hammerstone/sidecar-inertia

A Laravel package to render Inertia apps on AWS Lambda.

6210.9k](/packages/hammerstone-sidecar-inertia)[laravel-arcanist/inertia-response-renderer

Inertia response renderer for Arcanist

132.2k](/packages/laravel-arcanist-inertia-response-renderer)

PHPackages © 2026

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