Files
gwcf-review-front/.agent-harness/references/kri-ui-registry/installation-and-adaptation.md

1.9 KiB

KriUiRegistry Installation and Adaptation

Installation and Ownership

  • Inspect the registry item and its dependencies before installation. Use the shadcn CLI with the approved registry endpoint under https://ui-registry.kric.com/r/ instead of copying files from dist/r manually.
  • kri-data-table uses the TanStack Table v8 API. Keep @tanstack/react-table within the supported ^8.21.3 range and do not upgrade it to v9 until KriUiRegistry provides an explicitly migrated component contract.
  • Respect the consumer project's component aliases, target paths, package manager, styling system, React version, and existing design tokens.
  • The shadcn workflow copies component source into the consumer repository. After installation, treat that copy as project-owned code; do not assume registry updates propagate automatically.
  • Do not overwrite an existing project component without reviewing the diff and confirming that local behavior and accessibility are preserved.
  • Keep package and lockfile changes produced by an installation within the approved scope.

Adaptation and Verification

  • Adapt business data and application behavior outside the shared component when possible. Avoid embedding project-specific API, route, authentication, or environment logic into a reusable component.
  • Preserve the installed component's public props, accessibility, keyboard behavior, responsive layout, and loading, empty, error, and disabled states unless the task explicitly changes them.
  • If the registry lacks a generally reusable capability, propose it in KriUiRegistry; do not modify that repository unless it is explicitly in scope.
  • Run the consumer repository's focused type-check, lint, tests, and build after installation or upgrade.