From Save to runtime
“The project is saved,” “the new version is delivered,” and “the App is running” are three different facts. Separate these states before choosing an operation.
What each action changes
| Action | What it changes | What it does not do |
|---|---|---|
| Save | Updates local project files | Does not update a runtime target |
| Build | Checks the saved project and delivers a runnable version to the current target | Does not start the App |
| Preview | Checks a Page from the version already built on the current target | Does not Save or Build; device calls can still have real effects |
| Start | Starts the version already delivered to the target | Does not read undelivered local changes |
| Debug | Starts a delivered Debug version with debugging enabled | Is not simulation mode; physical actions can still occur |
| Stop | Stops the current App and waits for runtime resources to be released | Does not delete the project or delivered version |
The most common complete sequence is:
Edit and Save → Build → Preview or Start / Debug → Stop
Runtime states
| State | Meaning |
|---|---|
| Stopped | No active App; Build, Preview, Start, and Debug are available |
| Previewing | The editor is previewing a Page from the version on the current target; use Stop to return to Stopped |
| Starting | Startup is in progress; wait for the result |
| Running | The App is running normally |
| Debugging | The App is running with logs and configured breakpoints available |
| Stopping | Stop and cleanup are in progress; wait for Stopped |
Previewing returns through Stopping to Stopped. Normal runs and debugging also return to Stopped after Stop or fault cleanup. Stopped means there is no active instance; it does not mean the target has no delivered version.
When Build is required again
After changing a Page, Component, QG program, Object, data definition, user role, device, or module setting, Save and then run Build again. Refreshing a Page, switching tabs, reopening Preview, Start, or Debug never substitutes for Build.
If Start or Debug reports that a Build is required, confirm the project, saved content, and current target before selecting Build and continue. Theseus completes Build first and then continues the original action. A failure stops the sequence; it never continues with an older version.
Next
- Run Build and accept a delivered version: Build and runtime acceptance
- See which operations are available in each state: Runtime state and controls
- Connect another machine: Runtime and field delivery