README

Description

Un starter kit complet pour le développement d'applications web modernes utilisant Vue 3, Inertia.js, Laravel 12, et Tailwind CSS.

Prérequis

• PHP 8.3+
• Composer
• Node.js 20+
• NPM ou Yarn

Installation

laravel new votrenomprojet --using=rosto-infinity/vilt-starter-kit-waffolele

Installation des dépendances PHP

composer install

Installation des dépendances JavaScript

npm install
# ou
yarn install

Configuration de l'environnement

cp .env.example .env
php artisan key:generate

Configuration de la base de données

Modifiez le fichier .env avec vos paramètres de base de données, puis :

php artisan migrate

Lancement du serveur de développement

# Serveur Laravel
php artisan serve

# Compilation des assets
npm run dev
# ou
yarn dev

Scripts disponibles

Tests

# Exécuter les tests
composer test

# Tests Pest
composer pest

Code Quality

# Formater le code avec Pint
composer pint

# Analyse statique avec PHPStan
composer phpstan

# Nettoyage complet (formatage + analyse + tests)
composer clean

Technologies Principales

• Backend: Laravel 12
• Frontend: Vue 3
• Routing: Inertia.js
• Styling: Tailwind CSS
• UI Components: Reka UI
• Icons: Lucide Vue Next

Dépendances Principales

PHP

• Laravel Framework
• Laravel Fortify
• Inertia Laravel
• Laravel Wayfinder

JavaScript

• Vue 3
• Inertia.js
• TailwindCSS
• VueUse

Structure du Projet

/app             → Logique métier Laravel
/resources       → Vues Vue et ressources
/routes          → Définitions des routes
/tests           → Tests automatisés

Contribution

1. Forkez le projet
2. Créez votre branche de fonctionnalité (git checkout -b feature/AmazingFeature)
3. Commitez vos modifications (git commit -m 'Add some AmazingFeature')
4. Poussez votre branche (git push origin feature/AmazingFeature)
5. Ouvrez une Pull Request

Licence

Distribué sous la licence MIT.

Auteur

WAFFO LELE ROSTAND - Devinsto

Ce README.md offre :

• Une vue d'ensemble du projet
• Les étapes d'installation
• Les scripts disponibles
• La structure du projet
• Les technologies utilisées
• Des instructions de contribution