Nowly

Command Palette

Search for a command to run...

Charger et tester en local

Chargez une présence compilée dans l'extension Nowly avec un build de développement préparé ou un zip à déposer.

Après nowly build <slug>, il faut encore injecter ce bundle dans un navigateur. Il y a deux méthodes locales. Aucune ne passe par l'API Nowly.

1. Extension précompilée (nowly extension)

C'est le chemin habituel la première fois, surtout si vous n'avez cloné que le dépôt presences. La CLI télécharge un build de développement Chrome ou Firefox, puis y intègre votre présence compilée.

nowly build youtube
nowly extension youtube             # Chrome (par défaut)
nowly extension youtube --firefox
nowly extension youtube --f         # Alias Firefox

Vous pouvez passer plusieurs slugs :

nowly extension youtube github figma --firefox

Les options de navigateur sont mutuellement exclusives. Utilisez --chrome / --c pour sélectionner explicitement Chrome.

Ensuite :

  • Chrome : ouvrez chrome://extensions, activez le mode développeur, puis Charger l'extension non empaquetée → dist/extension-dev.
  • Firefox : ouvrez about:debugging#/runtime/this-firefox, choisissez This Firefox, cliquez sur Load Temporary Add-on..., puis sélectionnez dist/extension-dev-firefox/manifest.json.

La présence s'installe depuis dev-presences.json dès le démarrage de l'extension. Après une modification, recompilez, relancez nowly extension <slug>, puis rechargez l'extension.

Pour utiliser un build local d'extension plutôt que le zip CDN :

nowly extension youtube --chrome --from ../nowly/apps/extension/dist/chrome
nowly extension youtube --firefox --from ../nowly/apps/extension/dist/firefox

nowly extension écrit un dossier unpacked. C'est l'outil adapté lorsque Nowly n'est pas encore chargé dans le navigateur.

Monorepo Nowly complet

Si vous avez cloné nowly et lancé pnpm repos (qui clone presences dans packages/presences), vous pouvez intégrer toutes les présences compilées dans l'extension :

nowly build youtube
pnpm build:extension:dev --bundled

Chargez apps/extension/dist/chrome en unpacked. Rechargez après chaque rebuild.

2. Dépôt d'un zip (nowly pack)

Utilisez cette méthode lorsque Nowly est déjà chargé en build de développement unpacked. Les installations Chrome Web Store refusent les zips non signés. Vous ne recompilez que la présence, pas toute l'extension.

nowly pack youtube

Cette commande compile la présence, puis zippe dist/presences/youtube/ vers dist/packs/youtube.zip. Le zip doit contenir au minimum metadata.json et bundle.js. Un dossier imbriqué est accepté.

Puis dans le panneau latéral :

  1. Ouvrez Réglages → Avancé
  2. Activez le mode développeur (toujours actif sur un build unpacked)
  3. Dépliez Debug
  4. Déposez le .zip (ou parcourez le fichier)

La présence s'installe en source locale. Le nettoyage unpacked au démarrage ne la supprime pas. Les zips non signés sont acceptés uniquement sur un build unpacked (Charger l'extension non empaquetée). L'interrupteur mode développeur des Réglages n'affiche que l'interface Debug ; il n'autorise pas l'installation zip sur un build store. Un build store exige toujours une release signée via l'API.

Après chaque changement de code :

nowly pack youtube

Déposez à nouveau le zip. Pas besoin de recharger l'extension unpacked, sauf si vous avez modifié l'extension elle-même.

Quelle méthode choisir

| Situation | Méthode | |---|---| | Premier setup, ou Nowly absent du navigateur | nowly extension <slug> | | Nowly déjà chargé, itérer sur une présence | nowly pack <slug> puis déposer le zip | | Vous travaillez dans le monorepo nowly | pnpm build:extension:dev --bundled |

Voir aussi CLI.

Modifier sur GitHub