# Prepare a project for Grid Runtime

Before a project can be launched using **Grid Runtime**, it must be prepared with a [**Grid Viewer object**](https://stage-precision.gitbook.io/grid/grid-viewer/) in the Project Tree, that defines the interface shown to the end user.

The Grid Viewer used for Runtime must be configured to connect to **localhost (127.0.0.1)**. \
This allows the runtime instance to connect to the viewer running on the same machine.

Within this Grid Viewer object, define the **frame** that should be presented as the runtime interface. This frame acts as the main screen that the operator will interact with when the project is launched in Grid Runtime.

Typically, this frame contains the **operator interface**, built using **frames and widgets** in Grid Studio, and should only expose the controls required for operating the system.

Once this viewer and frame are configured, the project can be launched in **Grid Runtime mode**, presenting the defined interface to the user.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://stage-precision.gitbook.io/grid/grid-runtime/prepare-a-project-for-grid-runtime.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.