CLI

Usa la CLI de Nowly para crear, compilar, validar y probar presencias localmente.

La CLI de Nowly se publica como @nowly/cli en npm. Instálala de forma global:

pnpm i -g @nowly/cli

Modo interactivo

Ejecuta la CLI sin argumentos para abrir un menú interactivo:

nowly

Crear una presencia

nowly init "Netflix"

El prompt interactivo pregunta si Discord ya admite la plataforma cuando el usuario vincula su cuenta. Eso escribe discordNative en metadata.json. También puedes pasarlo:

nowly init "Spotify" --discord-native

Compilar presencias

Compila todas las presencias:

nowly build

Compila una presencia:

nowly build youtube

Recompila al cambiar archivos (recarga la extensión unpacked después de cada rebuild, o vuelve a soltar el zip con pack):

nowly build youtube --watch
nowly pack youtube --watch

Probar una presencia localmente

Hay dos formas de cargar una presencia compilada sin la API de Nowly. Guía completa: Cargar y probar en local.

Extensión precompilada

Si solo has clonado el repositorio presences (el caso más común para colaboradores), usa nowly extension para obtener una build de desarrollo lista para cargar, sin el monorepo nowly completo:

nowly build youtube
nowly extension youtube             # Chrome (por defecto)
nowly extension youtube --firefox
nowly extension youtube --f         # Alias de Firefox

Esto descarga la build de desarrollo correspondiente de Chrome o Firefox desde el CDN, empaqueta las presencias indicadas y escribe dev-presences.json. Después:

1. Chrome: abre chrome://extensions, activa el modo desarrollador y elige Cargar extensión sin empaquetar → dist/extension-dev
2. Firefox: abre about:debugging#/runtime/this-firefox, elige This Firefox, pulsa Load Temporary Add-on... y selecciona dist/extension-dev-firefox/manifest.json

Después de editar la presencia, recompílala, vuelve a ejecutar nowly extension <slug> y recarga la extensión.

Usa --chrome / --c para Chrome y --firefox / --f para Firefox. No se pueden usar ambas opciones a la vez.

Para usar una build local específica en lugar de la del CDN, pasa --from:

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

Soltar un zip

Si Nowly ya está cargada como build de desarrollo unpacked, empaqueta la presencia y suelta el zip en el panel Debug:

nowly pack youtube

El zip se escribe en dist/packs/youtube.zip. Suéltalo en Ajustes → Avanzado → Debug. Los zips sin firma solo funcionan en unpacked, no en instalaciones de Chrome Web Store. El modo desarrollador solo muestra la interfaz Debug.

Si tienes el monorepo completo

Si has clonado nowly en sí y ejecutado pnpm repos (que clona presences en packages/presences), puedes compilar la extensión con todas las presencias incluidas directamente:

pnpm build:extension:dev --bundled

Recompila la presencia modificada y luego la extensión después de cada cambio:

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

Recarga en chrome://extensions - la presencia ya está instalada y lista para usar.

Listar presencias

nowly list

Validar metadatos

nowly validate