Skip to content

Installation

Avec un backend Laravel

1. Installer Laravel

Créez un nouveau projet Laravel :

Laravel 10 :

bash
composer create-project laravel/laravel:^10.0 nom-du-projet

Laravel 11 :

bash
composer create-project laravel/laravel:^11.0 nom-du-projet

Laravel 12 :

bash
composer create-project laravel/laravel:^12.0 nom-du-projet

Laravel 13 :

bash
composer create-project laravel/laravel:^13.0 nom-du-projet

2. Ajouter Creopse à votre projet

Ajoutez le package Creopse via Composer :

bash
composer require creopse/creopse

3. Installer les fichiers de Creopse

Exécutez la commande d'installation pour publier les fichiers de configuration et initialiser la structure frontend de votre projet.

Si Creopse CLI est installé globalement

bash
creopse install

Sinon, via Artisan

Pour un frontend Vue :

bash
php artisan creopse:install -t vue

Pour un frontend React :

bash
php artisan creopse:install -t react

INFO

Cette commande génère également un fichier install.lock dans public/creopse, qui active le wizard de configuration au premier accès à /creopse/.


4. Lancer le serveur de développement

Quelle que soit l'approche de configuration choisie (automatique ou manuelle ci-dessous), cette étape est nécessaire pour compiler les assets et démarrer le rendu du site :

bash
pnpm dev

5. Configuration

Deux approches sont disponibles. Choisissez l'une ou l'autre, pas les deux.

Option A — Configuration automatique (recommandée)

Naviguez vers l'interface d'administration :

http://votre-domaine/creopse/

Le wizard vous guidera pour configurer :

  • L'URL du serveur.
  • La connexion à la base de données.
  • Le compte administrateur.

Une fois la configuration terminée, le fichier install.lock est supprimé automatiquement.

Option B — Configuration manuelle

5.1. Configurer la base de données

Mettez à jour votre fichier .env :

bash
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=nom_de_votre_base
DB_USERNAME=votre_utilisateur
DB_PASSWORD=votre_mot_de_passe

Puis exécutez les migrations et les seeders :

bash
php artisan migrate --seed

5.2. Supprimer le fichier install.lock

Supprimez le fichier public/creopse/install.lock pour débloquer l'accès à l'interface d'administration. Tant que ce fichier est présent, toute visite sur /creopse/ est redirigée vers le wizard d'installation.

bash
rm public/creopse/install.lock

5.3. Adapter le fichier public/creopse/config.jsonc

Modifiez la valeur de apiBaseUrl pour qu'elle corresponde à l'URL de votre backend :

jsonc
{
  "apiBaseUrl": "https://votre-domaine"
}

5.4. Accéder à l'interface d'administration

http://votre-domaine/creopse/

Connectez-vous avec les identifiants par défaut :

  • Nom d'utilisateur : admin
  • Mot de passe : admin

WARNING

Changez ces identifiants immédiatement après la première connexion.

Avec un backend Adonis

Le support Adonis est en cours de développement. Suivez les releases sur GitHub pour être notifié de sa disponibilité.