프레즌스 구조

Nowly 프레즌스에 필요한 폴더 구성을 이해하세요.

폴더 구성

프레즌스는 src 아래에 위치하며, 이름의 첫 글자로 그룹화됩니다.

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

metadata.json

metadata.json은 플랫폼, 지원 URL, 작성자, 카테고리, 다국어 설명, 마켓플레이스 에셋, 그리고 discordNative 같은 선택적 플래그를 설명합니다.

presence.ts

presence.ts에는 런타임 로직이 포함됩니다. 페이지 상태를 감지하고 Presence API를 호출합니다.

utils/

복잡한 프레즌스의 경우, 로직을 utils/ 폴더 아래의 전용 파일로 분리하세요. 예를 들어 YouTube 프레즌스는 DOM 헬퍼, 채널 파싱, Shorts 판별을 별도 모듈로 구성합니다.

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

번들러는 presence.ts에서의 로컬 임포트를 해석하므로, 유틸리티 파일을 평소처럼 임포트할 수 있습니다.

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

assets

에셋은 마켓플레이스, 설치된 프레즌스 패키지, Discord 활동 페이로드, Open Graph 이미지에서 사용됩니다.

필수 파일:

이 크기들은 정확한 요구 사항이며, 모든 프레즌스 PR에서 CI가 검사합니다 - 자세한 내용은 Assets를 참고하세요.