Skip to main content

Hosanna Compiler

The Hosanna Compiler (hsc) builds TypeScript projects for Hosanna platform targets, including Roku. It reads your project configuration from the hsconfig.json file.

Overview​

The Hosanna Compiler is a command-line tool that converts your TypeScript codebase into the platform output required by each target. For Roku, it emits BrightScript and SceneGraph-compatible output while preserving a modern TypeScript development workflow.

Usage​

To see all available options, run:

hsc --help

You will see output similar to:

hosanna-compiler: Version: 0.21.2 (build date: 2025-08-04T18:53:04Z)
hsc

Hosanna Compiler — Builds TypeScript projects for Hosanna platform targets
Version: 0.21.2
Build Date: 2025-08-04T18:53:04Z

Options:
  --version      Show version number                                   [boolean]
  --help         View help information about this tool.                [boolean]
  --project      Path to a hsconfig.json project file.                  [string]
  --fingerprint  Print this machine’s fingerprint for license activation.
                                                                       [boolean]
  --licenseHelp  Print instructions to activate your license.          [boolean]
  --update       Check for updates and install the latest version if available.

  • --version Prints the current version of the Hosanna Compiler.

  • --help Displays help information about available options and usage.

  • --project Allows you to specify the path to a hsconfig.json project file. This is useful if your configuration is not in the default location.

  • --fingerprint Prints your machine’s fingerprint, which is used for license activation.

  • --licenseHelp Prints instructions for activating your license.

  • --update Checks for updates and installs the latest version if available.

The version and build date are included in the output to help you verify you are using the correct version of the Hosanna Compiler for your project.

For more details on configuring your project, see the hsconfig.json documentation.