Using the Turtini CLI

The Turtini CLI (turtini-dev) handles scaffolding, building, and publishing modules.

Install:
npm install -g @turtini/cli

Commands:

create-turtini-module <name>
Scaffolds a new module project with a turtini.module.json manifest, tsconfig, package.json, and a starter React component wired to the SDK.
Example: npx create-turtini-module my-module

turtini-dev dev
Starts a local Vite dev server with the Turtini SDK mocked with sample org data. Your module renders inside a simulated Turtini shell.

turtini-dev build
Runs TypeScript type checking and zips your module to dist/<id>.zip. This is the file you upload in the Submit Module form (Step 2).

turtini-dev publish
Runs build, then uploads the bundle and manifest directly to Turtini. Requires a valid API key (run turtini-dev login first).

turtini-dev login
Prompts for your API key (found in Partner Portal → Settings) and saves it to ~/.turtini/config.json.

turtini-dev whoami
Shows the org currently authenticated by your saved API key.

For CI/CD, skip the login step and set the TURTINI_API_KEY environment variable directly.