README

BlitzPHP + Vue3 + TypeScript Application Starter

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

A propos

Ce depot est un kit de demarrage pour les projets d'applications fait en Vue.Js + TypeScript (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.
• Unhead 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-ts-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