# Carbonyl — navigateur terminal pour prévisualisation test

## Contexte

[Carbonyl](https://github.com/fathyb/carbonyl) rend une page web dans le terminal (moteur Chromium). Dans smart_ide, il sert à **consulter** des URLs (dont les déploiements **test** des projets) sans dépendre d’un navigateur graphique sur le poste.

## Intégration monorepo

- Répertoire : **`services/carbonyl/`** — sous-module **`upstream/`** (dépôt amont), script **`run-carbonyl.sh`**.
- Lancement ciblé test : **`scripts/open-carbonyl-preview-test.sh`** depuis la racine du monorepo.

## Configuration projet

Dans **`projects/<id>/conf.json`**, objet optionnel :

```json
"smart_ide": {
	"preview_urls": {
		"test": "https://votre-app.test/"
	}
}
```

Schéma général : [repo/ia-dev-project-conf-schema.md](../repo/ia-dev-project-conf-schema.md).

## Limiter la volumétrie Git

Ne pas initialiser récursivement les sous-modules **chromium** du dépôt Carbonyl sauf besoin de **compiler** le runtime. Pour l’usage courant : **Docker** (`fathyb/carbonyl`) ou paquet **`carbonyl`** npm.

## Documentation liée

- [repo/service-carbonyl.md](../repo/service-carbonyl.md)