README

Front Awesome

Reusable Vue components and frontend integrations for Laravel and Inertia applications.

Installation

From a Laravel application with Inertia and Vue, run Composer before npm.

Declare @artisan-toolbox/mosaicast in your application's package.json to satisfy Front Awesome's JavaScript peer dependency. The npm command below adds both frontend packages from Composer's vendor directory.

composer require artisan-toolbox/front-awesome
npm install --install-links ./vendor/artisan-toolbox/front-awesome ./vendor/artisan-toolbox/mosaicast

The initial 1.x release is in development. It targets PHP 8.5, Laravel 13.36 or later within Laravel 13.x, Vue 3.5, Inertia 3, Tailwind CSS 4, and Node.js 24.11 or later.

Usage

After configuring Vite and loading the package styles, import the button in a Vue page. For shared Tailwind, Web Awesome, and optional PrimeVue branding, follow the shared theme guide.

<template>
  <Button variant="brand">Save changes</Button>
</template>

<script setup lang="ts">
import Button from '@artisan-toolbox/front-awesome/components/Button.vue';
</script>

Resources

• Documentation
• Changelog
• Contributing
• Security policy
• License