taizn

A tiny CLI companion for interacting with Tizen ecosystem.

Install

pnpm add -D @putdotio/taizn

Install the Tizen command-line tools and make sure tizen and sdb work locally.

Usage

Create taizn.json in the app directory, keep .taizn/ ignored, then run:

pnpm exec taizn package
pnpm exec taizn install

Project files:

• taizn.json: app build, widget, signing, and variant config
• .taizn/.env: optional local secrets read by Node
• .taizn/certificates/: optional local author/distributor certs for taizn profile
• .taizn/build/: generated package staging and output

Commands

taizn profile
taizn package
taizn install
taizn --version

profile imports .taizn/certificates/author.p12 and .taizn/certificates/distributor.p12 into a Tizen security profile. package builds and signs a .wgt. install packages and sideloads it.

Environment

TAIZN_CERT_PASSWORD=...
TAIZN_DIST_PASSWORD=...
TAIZN_VARIANT=development
TAIZN_TARGET=<tv-ip>:26101
TAIZN_TIZEN_CLI=~/tizen-studio/tools/ide/bin/tizen
TAIZN_SDB=~/tizen-studio/tools/sdb

Config

{
  "build": {
    "command": ["pnpm", "build"],
    "output": "dist",
    "requiredFiles": ["main.css", "main.js"]
  },
  "signing": {
    "certificateDir": ".taizn/certificates",
    "profile": "my-tizen-profile"
  },
  "widget": {
    "configXml": "platforms/tizen/config.xml",
    "indexHtml": "platforms/tizen/index.html",
    "injectWebapis": true,
    "rewriteAssetUrls": false,
    "variants": {
      "development": {
        "applicationId": "ExampleDev.app",
        "bundleName": "example-dev",
        "icon": "platforms/tizen/icons/dev.png",
        "name": "Example Dev",
        "packageId": "ExampleDev"
      },
      "production": {
        "applicationId": "Example.app",
        "bundleName": "example",
        "icon": "platforms/tizen/icon.png",
        "name": "Example",
        "packageId": "Example"
      }
    }
  }
}

Docs

• Contributing
• Distribution
• Security

Repo Internals

• Agent guide

Contributing

See Contributing for setup, checks, and pull request flow.

License

MIT