Local quickstart

Complete the shortest local loop in a few minutes: create an App → create a Page → inspect it → Build → Preview → Start → Stop. This page requires no account sign-in, connects no remote target, and uses no physical equipment.

1. Create an App

1. Select New project in App Hub.
2. Enter “My First App” under App Name.
3. Choose the project location.
4. Leave every option under Modules unchecked, then select Create project.

Theseus creates the project and opens the editor. An empty Resources → Pages section is expected in a blank project.

2. Create the first Page

1. Open the context menu under Resources → Pages and select New Page.
2. Enter “quickstart” as the Page name.
3. Open the new Page and switch to Design.
4. Add a heading and a text item from the Palette.
5. In the Inspector, change the heading to “My First App” and the text to “Local runtime is ready.”

This step creates a static screen only. It adds no Object, QG program, Query, custom code, or equipment configuration.

3. Inspect and set the Home Page

1. Confirm in Design that the heading and text are visible.
2. Right-click “quickstart” under Resources → Pages and select Set as Home Page.
3. Confirm that the Home marker appears beside the Page.
4. Save every file.

4. Build and Preview

1. Confirm that the local Runtime target is selected in the title bar.
2. Run Build and wait for it to succeed.
3. Open Problems and confirm that this Build has no error.
4. Return to “quickstart” and select Preview.
5. Confirm that the Page shows “My First App” and “Local runtime is ready.”

Preview checks the version on the current target. It does not save or Build for you. When finished, select Stop and wait for Stopped.

5. Start and complete the runtime check

1. Select Start and wait for Running.
2. Open the local runtime page at http://127.0.0.1:9210/ in a browser.
3. Confirm that it opens “quickstart” and shows the same content as Preview.
4. Return to the editor, select Stop, and wait for Stopped.

You have now completed your first working App locally. Save, Build, Preview, and Start are separate operations. After changing the Page, save and Build again.

If it did not work

Symptom	Check first
The Page does not appear	Confirm that it was created under Resources → Pages, then reopen it
Design does not show the expected content	Select the heading or text and inspect its text property
Build fails	Open Problems and resolve the earliest explicit error first
Preview reports that Build is required	Save every file, confirm that the App is Stopped, and Build again
Start is unavailable	End Preview first and wait for Stopped
The runtime page does not open Home	Confirm that “quickstart” is the Home Page, then Build and Start again
The runtime page still shows old content	Stop, save the Page, Build again, and then Start

Next step

To follow one continuous example through AI, Page interaction, QG, debugging, and remote delivery, continue with Tutorial lesson 1. To look up a specific task, use Start from your goal.