deploy

1**📋 Shared Instructions: [shared-instructions.md](../../shared/shared-instructions.md)** - Cross-cutting concerns.
2 
3# Deploy
4 
5Builds and deploys the app in the current directory to Power Platform.
6 
7## Workflow
8 
91. Check Memory Bank → 2. Build → 3. Deploy → 4. Update Memory Bank
10 
11---
12 
13### Step 1: Check Memory Bank
14 
15Check for `memory-bank.md` in the project root. If found, read it for the project name and environment. If not found, proceed — the project may have been created without the plugin.
16 
17### Step 2: Build
18 
19```bash
20npm run build
21```
22 
23If the build fails:
24 
25- **TS6133 (unused import)**: Remove the unused import and retry.
26- **Other TypeScript errors**: Report the error with the file and line number and stop. Do not deploy a broken build.
27 
28Verify `dist/` exists with `index.html` before continuing.
29 
30### Step 3: Deploy
31 
32Ask the user: _"Ready to deploy to [environment name]? This will update the live app."_ Wait for explicit confirmation before proceeding.
33 
34> Resolve the CLI first (see [cli-binary.md](../../shared/cli-binary.md)): run as `$PA app push` (`npx --no-install pa …`), never a bare `pa`. On `power-apps`-only projects, translate to `power-apps push`.
35 
36```bash
37pa app push
38```
39 
40Capture the app URL from the output if present.
41 
42If deploy fails, report the error and stop — do not retry silently. Common fixes:
43 
44- Auth error / token expired → `pa auth logout` (or `power-apps logout` on `power-apps`-only projects), then retry — the CLI will re-prompt browser login.
45…