Configuration

Les fichiers et variables utilisés par Miblo et par l’API générée.

Dans cette page

Les fichiers importants

FichierRôle
miblo.yamlDéfinition version 1 : projet, modèles, champs et routes.
.miblo/state.jsonPacks épinglés, empreintes et bases de fusion.
.miblo/backups/Copies des sources remplacées lors des évolutions.
.envConfiguration privée d’exécution.
.env.exampleExemple partageable.
migrations/Historique SQL versionné.
Cargo.lockVersions 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

VariableRôle
DATABASE_URLConnexion 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_DIRPack local de développement.
MIBLO_TEMPLATE_BASE_URLDistribution des packs.
MIBLO_CACHE_DIRCache des templates.
MIBLO_LANGUAGEen ou fr : langue prioritaire au démarrage.
MIBLO_CONFIG_DIRDossier des préférences utilisateur.
VISUAL / EDITORÉditeur et arguments.
MIBLO_NO_ANIMATIONDé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 :

miblo.yaml
schema_version: 1
name: team-api
stack: rust-axum-sqlite
port: 3000
resources:
  - name: User
    path: /users
    fields:
      - name: name
        type: string
shell
miblo new --config chemin/vers/miblo.yaml --yes

Le 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

FormatVersion
Définition miblo.yamlschema_version: 1
Templates actuelsPack 0.6.0, format 3
Formats de templates lus par le CLI1, 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.

Rechercher une fonctionnalité ou une commande.

↑ ↓ parcourir Entrée ouvrir