RobloxUI CLI

Scaffold a Roblox project and connect it to Roblox Studio in minutes. robloxui init creates a Roblox-TS or Luau/Wally project pre-wired with Rojo, a mise-pinned toolchain, a minimal player spawn, and the Roblox Studio MCP server for AI tools. Marketplace components (robloxui.pencicta.com) can be added later with robloxui add.

Quick start

npx robloxui init

Answer the prompts (project name, flavor, theme), then:

cd my-game
npm run dev          # compiles and syncs into Studio

In Roblox Studio: open game.rbxl in the project folder → Rojo plugin → Connect → press Play.

That's it — a playable place with a spawn and an empty client mount, ready for UI.

robloxui init

Scaffold an empty Roblox-TS or Luau/Wally project with a minimal player spawn, pre-wired for RobloxUI components, toolchain, and Studio connection.

robloxui init --name my-game --flavor roblox-ts --yes
robloxui init --name . --flavor luau-wally --yes   # scaffold in cwd
robloxui init --name my-game --flavor roblox-ts --yes --theme  # include the theme

Creates: Rojo config, mise.toml toolchain pins, the standard DataModel services (Lighting, ServerStorage, SoundService, StarterGui, StarterPack, StarterCharacterScripts), a minimal player spawn, empty client mount, src/shared + src/server folders, and a game.rbxl place file. The RobloxUI theme is opt-in: pass --theme (or answer the prompt) to also wire the canonical robloxui/theme tokens. Init bootstraps mise with the official installer when needed.

Existing projects are inspected without replacing custom Rojo mappings. Non-interactive mode refuses ambiguous flavor or target input.

Connect to Roblox Studio

One-time setup

1. Run npx robloxui init — mise and pinned tools are bootstrapped automatically

2. Install the Rojo Studio plugin (Roblox Studio → Plugins → search "Rojo")

Roblox-TS workflow

Run one command in your project:

npm run dev          # compiles and syncs into Studio

In Studio: open game.rbxl → Rojo plugin → Connect → press Play.

Luau / Wally workflow

npm run dev                                # installs/syncs the Wally project into Studio

For your own (non-RobloxUI) Wally packages, add them to wally.toml and run wally install — the RobloxUI theme itself ships bundled and needs no dependency.

Studio MCP (AI tools)

Init can wire the Roblox Studio MCP server into your AI tool (opencode.json, .mcp.json, .cursor/mcp.json, or .vscode/mcp.json). Enable it once in Studio: Assistant → ⋯ → Manage MCP Servers → Enable Studio as MCP server — then your agent can read the game tree, edit scripts, insert models, and run playtests.

Prerequisites

• Node.js ≥ 20.12 (required by the CLI test/build toolchain)

• mise is bootstrapped with the official installer when it is not on PATH

• Rojo CLI + Rojo Studio plugin

• Wally — Luau projects only

When bootstrap is disabled, run mise install in the project to install the pinned tools.

Everything else

The sections below cover the marketplace workflow — installing components, authentication, browsing the catalog, and troubleshooting. Skip them until you need more than the scaffold.

Authentication

Run robloxui login once. Two flows:

robloxui login                     # browser device flow (recommended)
robloxui login --token <key>       # manual API key (CI / headless)

The browser flow prints a short code — open the URL, approve, done. Your token is saved to ~/.config/robloxui/config.json (Linux/macOS) or %APPDATA%\robloxui\config.json (Windows).

CI / headless machines: generate a key at Dashboard → Developer, then paste it.

robloxui whoami      # check who you're logged in as
robloxui logout      # remove saved token

Limits — Free users get 2 downloads/day. Pro subscribers get unlimited everything. See https://robloxui.pencipta.com/pricing.

robloxui add <slug...>

Install one or more components.

robloxui add primary-button
robloxui add button card dialog --yes   # non-interactive (CI)
robloxui add button --theme             # also install the theme package

The CLI will:

1. Preflight slug, authentication, target, flavor, package manager, and tools before network or writes

2. Detect your project type (rojo.json → Roblox-TS, wally.toml → Luau)

3. Prompt for install path (default: src/client/ui/components/) and whether to install the theme

4. Fetch the component source + metadata from the API

5. Stage and validate all files; conflicts stop by default (--force is explicit)

6. Write source and, when requested, install the theme transactionally

robloxui list / robloxui search

robloxui list                        # browse all components
robloxui search dialog               # search by name/description
robloxui list --framework tsx        # filter by framework
robloxui list --category buttons --limit 20

robloxui info <slug>

robloxui info primary-button

Prints: framework, category, dependencies, theme tokens, usage example, and the exact robloxui add command.

Project detection

The theme is never installed automatically: non-interactive runs skip it, interactive runs ask. Components run standalone because they embed their own design tokens.

Troubleshooting

Every CLI failure prints a recovery hint (retry + manual command + preserved paths). Common fixes:

Links

• RobloxUI marketplace

• Pricing

• Docs

• npm package