Commandes de projet

Quatre commandes agissent sur un projet plutôt que sur un serveur en cours : en échafauder un, le construire en fichiers statiques, afficher son schéma et vérifier une configuration avant de la livrer.

sovrium init

Échafaude un nouveau projet dans le répertoire indiqué, ou dans le répertoire courant si aucun n'est passé. Chaque échafaudage écrit un app.yaml, un CLAUDE.md rédigé pour le domaine du modèle, et un répertoire public/ pour les ressources statiques.

sovrium init ./my-app                          # démarrage vierge
sovrium init ./my-app --template crm --name acme-crm
sovrium init ./my-app --template sovrium/crm-template#v2

Option	Effet
--template <name>	Nom d'un modèle intégré, ou un dépôt GitHub — voir ci-dessous.
--name <name>	Nom d'application écrit dans l'app.yaml généré. Par défaut, le nom du répertoire.
--force	Autorise l'écrasement d'un app.yaml existant.

Modèles intégrés : hello-world, landing-page, crm, api-only, intranet, mcp-server, blog, docs-site, projects, helpdesk, content-calendar, people, events, assets, expenses, company-os, automation-recipes, knowledge-base. Un nom inconnu sort en 1 et affiche la liste.

--template accepte aussi un dépôt GitHub sous les formes owner/repo, gh:owner/repo ou https://github.com/owner/repo, chacune avec un #ref optionnel nommant une branche, une étiquette ou un SHA. Seul github.com est pris en charge.

sovrium build

Génère un site statique — HTML, CSS et ressources — à partir de votre configuration, prêt pour n'importe quel hébergeur statique.

sovrium build app.yaml

SOVRIUM_DEPLOYMENT=github-pages sovrium build app.yaml

SOVRIUM_OUTPUT_DIR=./public \
  SOVRIUM_BASE_URL=https://example.com \
  SOVRIUM_GENERATE_SITEMAP=true \
  SOVRIUM_GENERATE_ROBOTS=true \
  sovrium build app.yaml

Les options de build proviennent de variables d'environnement SOVRIUM_*, pas d'options de ligne de commande — voir Variables d'environnement pour l'ensemble complet. La sortie va dans SOVRIUM_OUTPUT_DIR lorsqu'elle est définie ; sinon dans un répertoire dist/ à côté du fichier de configuration.

sovrium schema

Affiche le JSON Schema (Draft-07) de la configuration d'application sur la sortie standard, ou l'écrit dans un fichier.

sovrium schema
sovrium schema --output app.schema.json

Le document est autonome, avec une déclaration $schema de premier niveau : tout éditeur ou validateur compatible JSON Schema le consomme tel quel. Voir Schéma JSON pour le brancher à un éditeur.

sovrium validate

Décode un fichier de configuration face à AppSchema et signale ce qui ne va pas. Accepte .json, .yaml, .yml et .ts, en résolvant d'abord les inclusions $ref.

sovrium validate app.yaml
sovrium validate app.ts

Affiche Valid configuration: <name> et sort en 0, ou un arbre d'erreurs et sort en 1. Exécutez-la en CI avant un déploiement — c'est le schéma que le serveur décode au démarrage. Comportement détaillé sur Valider une configuration.

Pages associées

• Aperçu du CLI — résolution de configuration et surface complète des commandes.
• Commandes de cycle de vie — start, stop, restart, reload.
• Modèles et exemples — le contenu de chaque modèle intégré.
• Valider une configuration — lire les erreurs affichées par validate.