27 lines
1.4 KiB
Markdown
27 lines
1.4 KiB
Markdown
# Minimal Playground Add-in (sideload instructions)
|
|
|
|
This small add-in is a single-button taskpane that calls the local `minimal-uploader-playground` API to generate a Managers Info PDF and upload it to SharePoint.
|
|
|
|
Quick steps to run and sideload for testing:
|
|
|
|
1. Start the playground API (if not already running):
|
|
|
|
```powershell
|
|
# from repo root
|
|
npm run start:all
|
|
```
|
|
|
|
2. In Excel (Windows):
|
|
- Open Excel → File → Options → Add-ins → Manage: COM Add-ins / Office Add-ins (depending) and disable any other dev add-ins that might auto-launch the task pane.
|
|
- Follow Excel sideloading steps (Developer → Add-ins → Sideload/Upload) and pick `officeaddin/minimal-playground/manifest.xml`.
|
|
- Open the add-in from the ribbon (should appear under the new Commands group as "Managers UI").
|
|
|
|
3. Click the single button in the taskpane — it will POST to `http://localhost:3002/api/upload-managers` and stream status.
|
|
|
|
How to avoid conflicts during testing
|
|
- Use a dedicated Excel profile or temporarily disable other add-ins from the Office Add-ins / COM Add-ins UI.
|
|
- If another dev add-in is using the same port (3003), you can run the orchestrator which will detect healthy endpoints and not re-start them — or kill the conflicting process first.
|
|
|
|
Notes
|
|
- This is a minimal dev add-in and meant for local development only. Do not put secrets or production configuration into the local .env files when checked into source control.
|