Job-Info/officeaddin/minimal-playground/README.md

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):

# 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.