Configuration
Les fichiers et variables utilisés par Miblo et par l’API générée.
Dans cette page
Les fichiers importants
| Fichier | Rôle |
|---|---|
miblo.yaml | Définition version 1 : projet, modèles, champs et routes. |
.miblo/state.json | Packs épinglés, empreintes et bases de fusion. |
.miblo/backups/ | Copies des sources remplacées lors des évolutions. |
.env | Configuration privée d’exécution. |
.env.example | Exemple partageable. |
migrations/ | Historique SQL versionné. |
Cargo.lock | Versions des dépendances. |
Versionnez sources, migrations, miblo.yaml et .miblo/state.json. Le .env privé est masqué dans l’explorateur ; .env.example reste visible.
Variables d’environnement
| Variable | Rôle |
|---|---|
DATABASE_URL | Connexion de l’API ; repli des commandes BDD si le .env ne la définit pas. |
SERVER_ADDRESS / SERVER_PORT | Écoute du serveur ; rafraîchir après modification. |
MIBLO_TEMPLATE_DIR | Pack local de développement. |
MIBLO_TEMPLATE_BASE_URL | Distribution des packs. |
MIBLO_CACHE_DIR | Cache des templates. |
MIBLO_LANGUAGE | en ou fr : langue prioritaire au démarrage. |
MIBLO_CONFIG_DIR | Dossier des préférences utilisateur. |
VISUAL / EDITOR | Éditeur et arguments. |
MIBLO_NO_ANIMATION | Désactive l’animation lorsque définie. |
Pour l’adresse surveillée par le TUI, l’environnement prime sur .env, puis sur le projet. Une adresse d’écoute générique est vérifiée via loopback. Évitez les configurations contradictoires.
Préférences utilisateur
Le choix de langue se trouve dans settings.json, hors de vos projets API :
- macOS :
~/Library/Application Support/miblo/settings.json - Linux :
$XDG_CONFIG_HOME/miblo/settings.json, ou~/.config/miblo/settings.json - Windows :
%APPDATA%\miblo\settings.json
XDG_CONFIG_HOME est également prioritaire sur macOS. MIBLO_CONFIG_DIR remplace ce dossier sur tous les systèmes.
Au démarrage, MIBLO_LANGUAGE=en ou MIBLO_LANGUAGE=fr prime sur le choix enregistré. Sans variable ni préférence, Miblo utilise l’anglais. Le menu reste utilisable pendant la session.
Si l’enregistrement échoue, Miblo signale l’erreur et applique la langue pour la session seulement. Un fichier de préférences invalide ne bloque pas le démarrage et n’est pas écrasé.
Créer depuis une définition
Un fichier YAML peut décrire un nouveau projet :
schema_version: 1
name: team-api
stack: rust-axum-sqlite
port: 3000
resources:
- name: User
path: /users
fields:
- name: name
type: stringmiblo new --config chemin/vers/miblo.yaml --yesLe dossier de destination doit être libre. Modifier ce fichier dans un projet existant ne migre pas la base : utilisez miblo edit pour ajouter des champs.
Versions des projets
| Format | Version |
|---|---|
| Définition miblo.yaml | schema_version: 1 |
| Templates actuels | Pack 0.6.0, format 3 |
| Formats de templates lus par le CLI | 1, 2 et 3 |
Un projet peut contenir des modèles issus de plusieurs packs. Les anciens config.yaml ne se convertissent pas automatiquement. Le changement de moteur, les renommages et les suppressions demandent une migration manuelle.