README.md

Example App

Example Laravel 9 app

Installation

System

Copy .env.example to .env.

Recommended: Set a Nova licence key in the .env file:

NOVA_LICENSE_KEY=xyz

Install requirements

composer install

Building und starting Docker container

./vendor/bin/sail up -d

Generate App Key

php artisan key:generate

Link Storage

php artisan storage:link

Migrate database and seed example data

! Using database Artisan commands in the Laravel Docker Container !

php artisan migrate:fresh --seed

Public Page

Install node requirements

npm i

Run one time production

npm run build

Update after pull

composer install

! Using database Artisan commands in the Laravel Docker Container !

php artisan migrate

Clear Browser Cache

Informationen

• Admin Account: [email protected]
• Password for every seeded account: password
• Public Page: http://localhost (Get Server Error without run one time npm prod)
• Administration: http://localhost/admin
• API: http://localhost/api (Postman Collection: example-app.postman-collection.json)
• API Authentication is made possible with Laravel Sanctum

A small overview

• Models Article & Comment using Soft Deleting
• Model User have a „One To Many“ relation to Article & Story Models
• Model User have a nullable „One To Many“ relation to Comment Model
• Model Comment have a „One To Many (Polymorphic)“ relation to Article & Story Models
• Models Article & Story have tags by using Laravel-tags by Spatie
• Model activities will be logged with Laravel-activitylog by Spatie
• Activity API index with filter options
• A small playground with roles and permissions. See RoleSeeder
• Seeder: Every user with a role and 50% of users without a role have an Avatar
• Fallback image for user Avatar

Packages

• Laravel Nova 4
• Inertia.js
• Laravel-tags by Spatie
• norman-huth/api-controller
• Laravel-activitylog by Spatie
• Laravel-medialibrary by Spatie
• Laravel-permission by Spatie
• dmitrybubyakin/nova-medialibrary-field (Nova Article)
• ebess/advanced-nova-media-library (Nova User)

For Frontend Assets:

• Vite + Laravel Vite Plugin
• Tailwind CSS
• Vue.js 3
• Headless UI