Building from Source

Building from Source

Prerequisites

• Node.js 18 or newer, and npm 9 or newer

No Tizen Studio or webOS SDK install is required. The build scripts in packages/build-tizen/ and packages/build-webos/ package the app themselves.

Install

npm install

The repo uses npm workspaces (packages/*), so a single install at the root covers every package.

Samsung (Tizen)

# All three variants in one command
npm run build:tizen:all

# Or individually
npm run build:tizen         # Regular
npm run build:tizen:oblong  # Oblong (512x423 launcher icon)
npm run build:tizen:legacy  # Legacy (Tizen 2.4, no Smart Hub Preview)

The three variants differ only in launcher icon shape and, for Legacy, the Tizen platform level they target. See Installation and Sideloading for which one a given TV needs.

LG (webOS)

npm run build:webos

Build outputs

Both land in the project root:

• Tizen: Moonfin_Tizen_<Regular|Oblong|Legacy>_<version>.wgt
• webOS: Moonfin_webOS_<version>.ipk

Development servers

npm run dev:tizen   # serves packages/app with REACT_APP_PLATFORM=tizen
npm run dev:webos   # serves packages/app with REACT_APP_PLATFORM=webos

The platform is selected through REACT_APP_PLATFORM, so the dev server exercises the same platform-detection path the packaged app uses. See Development for how that abstraction works.

Note that a browser dev server is subject to CORS restrictions that packaged .wgt and .ipk builds are not, so some server requests behave differently there than on a TV.