Getting Started

RootCX Studio is the native desktop app where you build, deploy, and manage your apps and AI agents. Everything starts here.

1. Download Studio

Download the latest version of RootCX Studio for your platform:

Install and open Studio. On first launch, you'll see a welcome screen with two options: Run locally or Connect to a server.

2. Connect to a Core

RootCX Studio needs a running RootCX Core instance to work. Core is the Rust daemon that powers everything: database, authentication, RBAC, APIs, backend processes, and AI runtime. You have two ways to get one running.

Option A: Connect to a server (fastest, recommended)

This is the quickest way to get started. A managed Core instance is provisioned for you in seconds, with nothing to install.

1. Sign up at rootcx.com/app/register.
2. Create a project. Give it a name and hit Launch Project. Provisioning takes about two minutes.
3. Once your project is active, the overview page shows your API URL and credentials.
4. Copy the API URL, open Studio, select Connect to a server, and paste the URL.

Option B: Run locally

Run a Core instance on your own machine using Docker. This is ideal for offline development or when you want full control over the infrastructure.

Prerequisites: Docker Desktop must be installed and running.

1. In Studio's welcome screen, select Run locally.
2. Studio checks that Docker is available, then pulls and starts the ghcr.io/rootcx/core container.
3. Once the Core is healthy, Studio connects to it automatically at http://localhost:9100.

That's it. No manual configuration required.

3. Build your first app

Once connected to a Core, you're ready to build.

1. Open AI Forge. Click the Forge panel on the left sidebar.

2. Describe what you want. Type a plain-language prompt. For example:

   "A task tracker where I can create tasks with a title, description, status (todo, in-progress, done), and due date."

   AI Forge generates the full source code -- entities, backend logic, and frontend components. You have complete control over the code and can edit it at any time.

3. Hit Run (F5). Studio deploys everything to your Core.

Your app is now live. Open it in the browser at https://<your-ref>.rootcx.com/apps/<appId>/ (cloud) or http://localhost:9100/apps/<appId>/ (local).

What happens on Run

When you press F5, Studio executes a pipeline against your Core:

1. Schema verify -- validates the manifest before applying changes.
2. Manifest sync -- registers (or updates) the application, its entities, fields, and permission keys.
3. Install dependencies -- runs bun install if a package.json is present.
4. Deploy backend -- uploads and starts the backend worker under the Core's process supervisor.
5. Publish frontend -- uploads the pre-built static assets to the Core, which serves them at /apps/{appId}/.

Each step logs output to the Studio console in real time. If any step fails, the error is shown immediately.

All of this is repeatable. Change the manifest or code, hit Run again, and Core applies the diff.

Next Steps

• Build an Application -- the full reference for manifests, backends, and frontends.
• Build an AI Agent -- create autonomous AI agents that run on your Core.
• Managing Data -- understand entities, fields, and relationships.