Installer Laravel Nova : prérequis

Avant de toucher à Composer, assurez-vous d’avoir :

• un projet Laravel fonctionnel (ici Laravel 13) ;
• une licence Nova active sur nova.laravel.com.

Les licences Nova

Deux formules existent :

• 99 $ : licence par site (un projet / un domaine) ;
• 300 $ : licence illimitée (tous vos projets).

Une licence achetée donne accès à toutes les versions Nova pendant la période de validité. L’historique des releases est visible sur le site officiel ; au moment de l’enregistrement vidéo, la version courante était la 5.8.1.

Pourquoi l’installation diffère d’un package classique

Avec Statamic ou la plupart des packages Laravel, un simple composer require suffit : le code est public sur Packagist.

Nova est propriétaire : Composer doit savoir où télécharger le package et qui vous êtes (email + clé de licence). D’où deux étapes supplémentaires :

1. déclarer le dépôt Composer Nova dans composer.json ;
2. s’authentifier lors du composer update.

Tout est documenté ici : Installation : Laravel Nova.

Étape 1 : ajouter le dépôt dans composer.json

Nova ne se trouve pas sur Packagist public. Il faut indiquer à Composer le dépôt officiel.

Vous pouvez :

• copier-coller le bloc repositories fourni par la doc à la fin de votre composer.json ;
• ou utiliser la commande proposée dans la documentation, qui ajoute la ligne automatiquement.

En résumé, on indique à Composer que le package laravel/nova doit être récupéré sur le serveur Nova.

Étape 2 : exiger Nova dans require

Dans la section require de composer.json, ajoutez Nova avec la version minimale souhaitée :

"laravel/nova": "^5.0"

Adaptez la contrainte selon la version cible (5.x au moment de la vidéo).

Étape 3 : composer update (pas install)

Lancez :

composer update

Utilisez update, pas install : install se base sur le composer.lock existant et n’ajoutera pas Nova si le lock n’a pas encore été mis à jour.

Authentification licence

Composer vous demandera alors :

• Username : l’email de votre compte Nova ;
• Password : votre clé de licence (token).

Deux options pour ne pas retaper ces identifiants à chaque fois :

1. répondre une fois au prompt interactif (Composer peut mémoriser) ;
2. créer un fichier auth.json à la racine du projet (ou dans ~/.composer/) avec votre email et la clé de licence, comme expliqué dans la doc Nova.

Ne commitez jamais auth.json avec votre clé en clair dans un dépôt public. Ajoutez-le au .gitignore si besoin.

Une fois l’authentification OK, Nova est téléchargé dans vendor/laravel/nova.

Étape 4 : php artisan nova:install

Le package est présent, mais Nova n’est pas encore configuré dans l’application. Lancez :

php artisan nova:install

L’installateur pose quelques questions :

Nova comme login par défaut ?

Nova peut rediriger /login vers le panneau d’administration.

• Oui : pratique pour un back-office dédié (démo, outil interne) ;
• Non : si votre app a déjà un login front classique et que Nova reste accessible sur une route séparée (cas fréquent en production).

Pour la démo de la playlist, on choisit oui : /login mène directement à Nova.

L’installateur publie les fichiers de configuration et prépare l’intégration.

Étape 5 : migrations

Nova ajoute des tables (notamment pour les notifications). Exécutez :

php artisan migrate

Étape 6 : créer un utilisateur admin

Nova utilise par défaut le modèle App\Models\User. Si votre projet n’a pas encore d’utilisateur, créez-en un rapidement :

php artisan nova:user

C’est l’équivalent d’un seeder manuel, classique Laravel. Vous pouvez aussi peupler la table users via un seeder habituel.

Première connexion

Rendez-vous sur /login (ou la route Nova configurée). Après authentification, vous accédez au dashboard Nova tout neuf.

Ce que vous voyez par défaut

• des cartes d’aide sur le tableau de bord (supprimables ensuite) ;
• la barre de recherche globale ;
• la sidebar avec les entrées de menu ;
• une ressource Users déjà générée (liste, détail, édition) ;
• les notifications (si vous les activez plus tard) ;
• le switch thème clair / sombre / système ;
• l’accès au profil (changement de mot de passe, etc.).

C’est le socle : menu en haut, sidebar à gauche, vues index (liste), détail et édition : toujours le même schéma pour chaque ressource que vous ajouterez.

Personnalisation rapide (aperçu)

Nova permet de modifier le logo, les couleurs principales et d’autres réglages visuels, on le verra dans la suite. L’interface reste néanmoins structurée : barre supérieure + sidebar, comme évoqué dans la partie 1.

Récapitulatif des commandes

# 1. Après configuration composer.json (repository + require)
composer update
2. Installation Nova dans l'app
php artisan nova:install
3. Migrations
php artisan migrate
4. Premier utilisateur admin
php artisan nova:user

Vidéo : installation en pratique

• Voir sur YouTube
• Playlist Laravel Nova

FAQ rapide (SEO & technique)

Faut-il une licence pour installer Nova ?
Oui. Sans licence valide, Composer ne peut pas télécharger le package.

composer install ou composer update ?
Pour ajouter Nova la première fois, utilisez composer update afin de résoudre et verrouiller la nouvelle dépendance.

Où stocker la clé de licence ?
Dans auth.json (local ou global) ou via le prompt Composer, jamais en clair dans un repo public.

Nova remplace-t-il le login Laravel ?
Optionnel. L’installateur vous demande si /login doit pointer vers Nova ; sinon, gardez votre auth front séparée.

Quel modèle User utilise Nova ?
Par défaut App\Models\User. Configurable si votre app utilise un autre modèle.

Conclusion

Installer Laravel Nova, c’est un peu plus qu’un composer require classique, licence, dépôt privé, nova:install, migrations, premier user : mais la procédure reste rapide une fois les habitudes prises.

Suite de la série : Laravel Nova : créer un CRUD en 5 minutes (ressources et champs).