Official SumX frontend kit
Documentation for shared SSR packages
Auth, UI primitives, and PDF generation — versioned npm libraries extracted from sumx-client-portal, with guides, API reference, and interactive demos.
- 6
- Packages
- React 19
- Compatible
- Next.js
- Pages Router
- Open
- Monorepo
Everything in one kit
Browse API reference, integration guides, and live component demos for each package.
- @sumx/uiUI componentsButton, Dialog, Input, DropdownMenu, permissions, and cn — portal theme.View documentation →
- @sumx/sumx-editorSumX EditorSunEditor rich text, merge fields, sanitization, and RichTextContent.View documentation →
- @sumx/ssr-auth-coreAuth (server)OIDC, HttpOnly cookies, session APIs, logout, and return-path validation.View documentation →
- @sumx/ssr-auth-reactAuth (React)CheckToken shell, login skeleton, and cross-tab session dialog.View documentation →
- @sumx/http-clientHTTP clientBFF-aware Axios factory with API base configuration and error handling.View documentation →
- @sumx/ssr-pdfPDFHTML→PDF via Puppeteer with validation, limits, and Next.js API handlers.View documentation →
Built for SumX Next.js apps
Cross-cutting concerns every ERP portal needs — maintained by the platform team.
OIDC + BFF sessions
HttpOnly cookies and /api/auth/* handlers — tokens never in localStorage.
CheckToken app shell
Client gate with OIDC redirect, loading skeleton, and permission-aware UI.
Shared UI primitives
Dialogs, buttons, inputs, and menus that match sumx-client-portal styling.
Rich text editor
SumXEditor with variables, toolbar presets, and safe HTML display.
Server-side PDF
Render HTML to PDF in API routes with sanitized filenames.
Azure Artifacts
Publish @sumx/* semver packages; consume in CI, Docker, or vendor mode.
Monorepo friendly
pnpm workspace, sumx:local linking, and SUMX_KIT_ROOT for portal dev.
Get up and running
- 01
Install packages
Add @sumx/* from Azure Artifacts and configure .npmrc with a Packaging PAT.
- 02
Wire API routes
Mount session, logout, and optional html-to-pdf handlers under pages/api.
- 03
Wrap your app
CheckToken + PermissionProvider in _app; scan Tailwind for kit class names.
Ready to integrate SumX Kit?
Start with prerequisites, follow the auth quickstart, or explore interactive demos.