README

BlitzPHP + Vue3 Application Starter

Un kit de démarrage simple pour le développement d'application BlitzPHP et Vue 3.

A propos

Ce depot est un kit de demarrage pour les projets d'applications fait en Vue.Js (pour le frontend) et BlitzPHP (pour le backend). En temps, normal, on pour faire de tel applications (api + spa), on doit avoir 2 projets distincts (un pour le frontend et un autre pour le backend). Certes il existe des solutions pour palier à ce problème de double application (notament Inertia) mais elle resout le problème en partie.

Fonctionnalités :

• 💡 Application monopage (SPA) ultra-rapide.
• 🔥 Hot Module Replacement (HMR) inclus.
• 🧩 Installation et mise à jour simplifiées.
• 🪓 Personnalisation facile.
• 🔧 Zéro configuration requise.
• ⭐ Application web progressive (PWA).
• ✨ Et bien plus encore...

Pré-packagé :

Note : Aucun de ces plugins/frameworks n'est obligatoire. Vous pouvez les supprimer ou les remplacer à volonté.

• Vite Est utilisé comme serveur de développement et outil de construction.
• Vue Router est utilisé pour le routage.
• Pinia est utilisé pour la gestion des états. De plus, les données d'états peuvent être persistés grâce au plugin pinia persistedstate.
• Vue I18n est utilisé pour les traductions.
• Vue Meta est utilisé pour la gestion des metadonnées HTML.
• Axios est utilisé pour effectuer des requêtes. Certains intercepteurs sont déjà définis dans src/plugins/axios.js
• Dayjs est utilisé pour manipuler aisement les dates
• Bootstrap Vue Next est utilisé pour la mise en page avec Bootstrap 5
• Vite Plugin PWA : Plugin PWA sans configuration.

Installation :

Vérifiez que votre serveur respecte les exigences de CI4.

Exécutez cette commande pour créer un projet :

composer create-project dimtrovich/blitzphp-vue-starterkit

Configuration

• Exécutez npm install pour installer les dépendances.
• Lancez npm run dev pour servir les assets.
• Démarrez le serveur BlitzPHP : php klinge serve ou via un hôte virtuel.

IMPORTANT :

Aucun asset n'est pré-compilé après l'installation. Exécutez npm run dev pour les générer ou npm run build pour une version optimisée.

Personnalisation :

Ce projet utilise le package BlitzPHP Vite. En savoir plus.

Un problème ?

N'hésitez pas à ouvrir une issue, nous corrigerons dès que possible.

Contributions :

Toute aide est la bienvenue ! PRs acceptées avec gratitude.

Licence

MIT License © 2025 Dimitri Sitchet Tomkeu