monkeyscloud / monkeyslegion-vite

1.0.2 2026-09-29 02:08 UTC

Requires

• php: >=8.4
• monkeyscloud/monkeyslegion-core: ^2.1
• monkeyscloud/monkeyslegion-template: ^2.0

Requires (Dev)

• phpunit/phpunit: ^11.0

MIT

Published on Packagist.org on 2026-09-29 02:08 UTC

README

Vite asset pipeline integration for the MonKeysLegion framework — manifest parser, @vite directive, and dev mode detection.

Features

• Manifest parser — reads manifest.json from Vite build output
• @vite directive — use @vite(['resources/js/app.ts']) in templates
• Dev mode detection — automatically serves from Vite dev server in development
• Route exporter — exports named routes as TypeScript for frontend use
• Hot module replacement — automatic HMR in development mode
• Asset versioning — cache-busting with content-hashed filenames

Installation

composer require monkeyscloud/monkeyslegion-vite

Usage

In Templates

{{-- Load CSS and JS entry points --}}
@vite(['resources/css/app.css', 'resources/js/app.ts'])

Development Mode

When APP_ENV=local, assets are served from the Vite dev server (http://localhost:5173). In production, assets are resolved from the built manifest.

Configuration

# config/app.mlc
vite {
    dev_server = "http://localhost:5173"
    build_path = "public/build"
    manifest   = "manifest.json"
}

Route Exporter

php bin/ml route:js

Exports named routes as TypeScript types for type-safe frontend navigation.

License

MIT © MonKeysCloud