Structure d'une présence

Comprenez la structure de dossiers requise pour une présence Nowly.

Structure des dossiers

Une présence se trouve sous src, regroupée par la première lettre de son nom :

src/Y/YouTube/
|-- metadata.json
|-- presence.ts
`-- assets/
    |-- logo.png
    |-- icon.png
    `-- thumbnail.jpg

metadata.json

metadata.json décrit la plateforme, les URL prises en charge, l'auteur, la catégorie, les descriptions localisées, les visuels de la bibliothèque et des indicateurs facultatifs comme discordNative.

presence.ts

presence.ts contient la logique d'exécution. Elle détecte l'état de la page et appelle l'API Presence.

utils/

Pour les présences complexes, répartissez votre logique dans des fichiers dédiés sous un dossier utils/. La présence YouTube, par exemple, organise les helpers DOM, l'analyse des chaînes et la résolution des Shorts dans des modules séparés :

src/Y/YouTube/
|-- metadata.json
|-- presence.ts
|-- assets/
|   |-- logo.png
|   |-- icon.png
|   `-- thumbnail.jpg
`-- utils/
    |-- categories.ts
    |-- dom.ts
    |-- channel.ts
    |-- text.ts
    |-- bridge.ts
    |-- shorts-dom.ts
    |-- shorts-resolve.ts
    `-- youtube-data.ts

Le bundler résout les importations locales depuis presence.ts, vous pouvez donc importer les fichiers utilitaires normalement :

import { findVideo } from "./utils/dom"
import { getChannelInfo } from "./utils/channel"

assets

Les fichiers visuels servent à la bibliothèque, au paquet de présence installé, aux données d'activité Discord et aux images Open Graph.

Fichiers requis :

Ces dimensions sont des exigences exactes, vérifiées par la CI sur chaque PR de présence - voir Assets pour le détail.