Documentation/CLI Reference

CLI Reference

Complete reference for the RealmKit command line interface.

Installation

Install the RealmKit CLI globally

npm install -g @realmkit/cli

After installation, you can verify it's working by running:

realmkit --version

Global Options

Options available for all commands

--help, -hShow help information
--version, -vShow version number
--verboseEnable verbose output
--quiet, -qSuppress output
--configPath to config file

Commands

realmkit create

Create a new project from a realm template

Syntax

realmkit create <realm-name> [project-name] [options]

Examples

realmkit create saas-starter my-app
realmkit create nextjs-blog --typescript
realmkit create api-template backend --git

Options

--typescriptUse TypeScript variant if available
--gitInitialize git repository
--installAutomatically install dependencies

realmkit search

Search for realm templates

Syntax

realmkit search [query] [options]

Examples

realmkit search saas
realmkit search --category=api
realmkit search nextjs --tags=typescript

Options

--categoryFilter by category
--tagsFilter by tags
--limitLimit number of results

realmkit publish

Publish your realm to the hub

Syntax

realmkit publish [options]

Examples

realmkit publish
realmkit publish --name="My Realm" --category=saas
realmkit publish --dry-run

Options

--nameRealm name
--descriptionRealm description
--categoryRealm category
--dry-runPreview without publishing

realmkit list

List available realms

Syntax

realmkit list [options]

Examples

realmkit list
realmkit list --featured
realmkit list --category=web

Options

--featuredShow only featured realms
--categoryFilter by category
--formatOutput format (table, json)

realmkit info

Get detailed information about a realm

Syntax

realmkit info <realm-name>

Examples

realmkit info saas-starter
realmkit info nextjs-blog --json

Options

--jsonOutput as JSON

realmkit config

Manage RealmKit configuration

Syntax

realmkit config <subcommand> [options]

Examples

realmkit config set api-key YOUR_KEY
realmkit config get
realmkit config reset

Options

--globalUse global configuration

Configuration

RealmKit CLI configuration options

Config File Location

The CLI looks for configuration in the following locations:

  • ~/.realmkit/config.json (global)
  • ./.realmkit.json (project-specific)
  • • Environment variables prefixed with REALMKIT_

Example Configuration

{
  "apiKey": "your-api-key",
  "registry": "https://registry.realmkit.com",
  "defaultCategory": "web",
  "autoInstall": true,
  "git": {
    "autoInit": true,
    "defaultBranch": "main"
  }
}