README

Vite

A framework-agnostic PHP integration for resolving Vite development and production assets.

Features

Installation

composer require php-forge/vite:^0.1

HTML output is generated with ui-awesome/html while asset resolution remains independent from its representation.

The consuming application owns Vite and every JavaScript dependency. Configure Vite to write a build manifest:

import {defineConfig} from 'vite';

export default defineConfig({
    build: {
        manifest: true,
    },
});

Quick start

Development

use PHPForge\Vite\Configuration\DevelopmentConfiguration;
use PHPForge\Vite\Html\HtmlRenderer;
use PHPForge\Vite\Vite;

$vite = new Vite(
    new DevelopmentConfiguration(
        devServerUrl: 'http://localhost:5173',
    ),
    entrypoints: ['resources/js/app.js'],
);

echo (new HtmlRenderer())->render($vite->resolve());

Production

use PHPForge\Vite\Configuration\ProductionConfiguration;
use PHPForge\Vite\Html\HtmlRenderer;
use PHPForge\Vite\Vite;

$vite = new Vite(
    new ProductionConfiguration(
        manifestPath: '/srv/app/public/build/.vite/manifest.json',
        assetBaseUrl: '/build',
    ),
    entrypoints: ['resources/js/app.js'],
);

echo (new HtmlRenderer())->render($vite->resolve());