Skip to content

Commit 500d2c4

Browse files
Copilotlesaltzm
andauthored
Add App.StartScreen guidance to canvas-apps guide and planner agent
Agent-Logs-Url: https://github.com/microsoft/power-platform-skills/sessions/265fed62-a281-4022-a4be-d524079545aa Co-authored-by: lesaltzm <69215460+lesaltzm@users.noreply.github.com>
1 parent 66a61c6 commit 500d2c4

2 files changed

Lines changed: 20 additions & 0 deletions

File tree

plugins/canvas-apps/agents/canvas-app-planner.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -114,6 +114,15 @@ Write the app-level YAML file (`App.pa.yaml`) to the working directory. This fil
114114
across all screens — do not write screen-level content here. Follow TechnicalGuide.md
115115
conventions for app-level properties.
116116

117+
Set `App.StartScreen` to the intended initial landing screen of the app so it opens on the
118+
correct screen when launched. For example:
119+
120+
```yaml
121+
App:
122+
Properties:
123+
StartScreen: =HomeScreen
124+
```
125+
117126
## Step 7 — Write canvas-app-plan.md
118127
119128
Write `canvas-app-plan.md` to the working directory. This document is the **single source of

plugins/canvas-apps/references/TechnicalGuide.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,14 @@ Screens:
3939
...
4040
```
4141
42+
> **Note:** Always set `App.StartScreen` in `App.pa.yaml` to the screen that should be shown when the app launches. Without it, the app may open on an unexpected screen.
43+
>
44+
> ```yaml
45+
> App:
46+
> Properties:
47+
> StartScreen: =HomeScreen
48+
> ```
49+
4250
## YAML Syntax Rules
4351

4452
### Multi-line formulas — use `|-`
@@ -368,6 +376,9 @@ App:
368376

369377
## Best Practices
370378

379+
### App Configuration
380+
- ✅ Set `App.StartScreen` to the initial landing screen so the app always opens on the intended screen
381+
371382
### State Management
372383
- ✅ Initialize all variables in `OnVisible`
373384
- ✅ Use descriptive variable names

0 commit comments

Comments
 (0)