Installation and Authorization
Before you begin
Section titled “Before you begin”RT-Themes CLI is the npm package @rtthemes/cli. Run it with npx to create an Astro website, update its theme core, inspect project metadata or generate a CMS planning brief.
Install Node.js and npm
Section titled “Install Node.js and npm”Install Node.js 22.22.0 or later, with npm, using the Node.js download page. Your selected theme’s runtime requirements also apply.
Open a terminal and check that Node.js and npm are available:
node --versionnpm --versionIf either command is missing, complete the Node.js/npm installation and reopen your terminal before continuing. npx is included with npm.
Install the CLI
Section titled “Install the CLI”Run RT-Themes CLI directly from npm:
npx @rtthemes/cli@latestIf npm asks to download the package, confirm to continue. npx fetches the package and runs its command; a separate global installation is not required. @latest selects the release tagged as latest on npm. You need npm registry access on the first run or when fetching a newer release.
The interactive menu offers Create a new project, Check your project, CMS integration prompt and Update your theme. Running the CLI does not approve theme download access; that approval happens when you start an install or update operation.
Verify the CLI
Section titled “Verify the CLI”npx @rtthemes/cli@latest --versionnpx @rtthemes/cli@latest --helpThe first command prints the CLI version. The second lists its commands and options. The CLI version and the installed theme core version are separate.
Create a new project
Section titled “Create a new project”npx @rtthemes/cli@latest init my-siteChoose your product, approve the operation in your signed-in Dashboard browser, then choose an available version and starter variant. Review the target folder and dependency-install choice before confirming.
For NaturaLife Astro, you can select the product directly:
npx @rtthemes/cli@latest init my-site --product naturalife-astroUse a new or empty folder. The CLI verifies the downloaded artifact and prepares the project in staging. If dependency installation is selected, it runs the delivered npm ci, check and build before moving the validated project into place. Failure removes owned staging and preserves existing target files.
After installation, open the project folder:
cd my-siteIf you skipped dependency installation, run npm ci first. Then run npm run dev and follow your product’s getting-started guide.
Approve each operation
Section titled “Approve each operation”Each init and update requires fresh authorization. Match the product, action and confirmation code shown in the terminal with the Dashboard page before approving. The short operation token stays in memory; the CLI does not save a browser login, refresh token or permanent key.
To use a machine that cannot open a browser automatically:
npx @rtthemes/cli@latest init my-site --no-browserOpen the printed approval URL in your signed-in browser. --no-browser disables automatic opening; it does not bypass approval. The CLI’s --yes option confirms file operations only and also does not bypass account authorization.
Use a developer ticket
Section titled “Use a developer ticket”An owner can create a product-specific installation ticket in Dashboard. It expires after 24 hours and authorizes one init or one update. Use the Dashboard-generated command with its --ticket option. Keep the ticket value private and do not reuse it for another operation.
The same short authorized operation may retry its selected package, but cannot switch to another version or variant. Rights are checked again for package access. Website builds remain independent of that account access.
After installation
Section titled “After installation”The CLI writes a secret-free .rtthemes/project.json installation receipt. Keep it with the matching core/vendor/lock/kit metadata. Continue with:
The CLI does not commit, push or deploy your website. WordPress activation and HTML direct-download workflows remain product-specific.
Resolve setup problems
Section titled “Resolve setup problems”Node.js, npm or npx is not found
Section titled “Node.js, npm or npx is not found”Complete the Node.js/npm installation and reopen the terminal so it picks up the command paths. Run node --version and npm --version again.
npm cannot download the CLI
Section titled “npm cannot download the CLI”Check internet access, your npm registry configuration and the exact package name @rtthemes/cli. Retry the same npx command after resolving connection or registry errors. Include the CLI command and npm error in a Dashboard support ticket if the problem continues.
The CLI reports an unsupported Node.js version
Section titled “The CLI reports an unsupported Node.js version”Switch to a Node.js version meeting the minimum requirement, reopen the terminal and verify node --version before retrying.
Theme access is rejected
Section titled “Theme access is rejected”Approve the operation in the Dashboard account that owns the product or has the applicable Club access. CLI access approval is required for each install/update; an old approval cannot authorize a new operation.
Use the latest CLI
Section titled “Use the latest CLI”Use npx @rtthemes/cli@latest each time you run the tool. To check its version:
npx @rtthemes/cli@latest --versionSelecting the latest CLI does not update your website’s theme core. For that, run npx @rtthemes/cli@latest update from the project folder and follow Core Updates and Recovery.