Local development

Link the portal to built packages in ../sumx-ssr-kit/packages/*.

Setup

Add to portal .env (recommended):

SUMX_KIT_ROOT=/absolute/path/to/sumx-ssr-kit

Then:

cd sumx-client-portal
pnpm run sumx:local
pnpm install
pnpm dev

sumx:local builds the kit and sets file:../sumx-ssr-kit/packages/* in package.json.

No Azure PAT required when dependencies are file: (preinstall skips feed auth).

Edit loop

# Terminal 1 — kit
cd sumx-ssr-kit
# edit packages/ssr-auth-react, etc.
pnpm run build
 
# Terminal 2 — portal
cd sumx-client-portal
# restart dev server if HMR does not pick up linked package
pnpm dev

Tailwind + kit UI

Portal src/styles/tailwind.css includes @source for @sumx/ui, @sumx/ssr-auth-react, and @sumx/sumx-editor under node_modules so kit class names are generated with portal theme tokens.

For the editor, also import styles in globals.scss:

@import '@sumx/sumx-editor/styles.scss';

See SumX Editor — Portal integration.

Wrap the app with SumxUiPermissionProvider (see UI & permissions).