@nsxbet/admin-sdk 0.2.0 → 0.4.0

package/CHECKLIST.md

@@ -0,0 +1,212 @@
+# Admin Module Setup Checklist
+
+> Verify each item to ensure your module is correctly configured.
+> For module-specific values, run `npx adminx checklist` (requires `@nsxbet/admin-cli`).
+
+**Usage for LLMs:** Work through each section, check off items as you verify them. Compare your files against the expected content blocks.
+
+## Required Files
+
+- [ ] `admin.module.json` — Module manifest
+- [ ] `package.json` — Package configuration
+- [ ] `vite.config.ts` — Vite build config
+- [ ] `index.html` — HTML entry point
+- [ ] `src/spa.tsx` — Shell entry (default export)
+- [ ] `src/standalone.tsx` — Dev entry (AdminShell wrapper)
+- [ ] `src/App.tsx` — Main app component (Routes)
+- [ ] `src/index.css` — Styles with Tailwind directives
+- [ ] `tailwind.config.js` — Tailwind config
+- [ ] `postcss.config.js` — PostCSS config
+- [ ] `tsconfig.json` — TypeScript config
+- [ ] `tsconfig.node.json` — Node TypeScript config
+- [ ] `src/globals.d.ts` — Global type declarations
+
+## Module Manifest (`admin.module.json`)
+
+- [ ] Has `id` field (format: `@admin/<name>`)
+- [ ] Has `title` field
+- [ ] Has `routeBase` field (starts with `/`)
+- [ ] Has `description` field (recommended)
+- [ ] Has `version` field (recommended)
+- [ ] Has `category` field (recommended)
+- [ ] Has `permissions` object (recommended, values are string arrays)
+- [ ] Has `commands` array (recommended, each with `id`, `title`, `route`)
+- [ ] All command `route` values start with the module's `routeBase`
+
+Expected structure:
+
+```json
+{
+  "id": "@admin/my-module",
+  "title": "My Module",
+  "routeBase": "/my-module",
+  "description": "My Module admin module",
+  "version": "1.0.0",
+  "category": "Tools",
+  "commands": [{ "id": "home", "title": "Home", "route": "/my-module/home" }],
+  "permissions": {
+    "view": ["admin.my-module.view"],
+    "edit": ["admin.my-module.edit"],
+    "delete": ["admin.my-module.delete"]
+  }
+}
+```
+
+## Dependencies (`package.json`)
+
+- [ ] `"type": "module"` is set
+- [ ] Build script is `"tsc && vite build"`
+
+### Runtime Dependencies
+
+- [ ] `@nsxbet/admin-sdk` — `workspace:*` or git tag version
+- [ ] `@nsxbet/admin-ui` — `workspace:*` or git tag version
+- [ ] `react` — `^18.2.0`
+- [ ] `react-dom` — `^18.2.0`
+- [ ] `react-router-dom` — `^6.20.1`
+
+### Dev Dependencies
+
+- [ ] `@vitejs/plugin-react` — `^4.2.1`
+- [ ] `vite` — `^5.0.8`
+- [ ] `typescript` — `^5.2.2`
+- [ ] `tailwindcss` — `^3.4.0`
+- [ ] `postcss` — `^8.4.32`
+- [ ] `autoprefixer` — `^10.4.16`
+- [ ] `@nsxbet/eslint-plugin-admin` — (same version as SDK)
+
+## Vite Configuration
+
+- [ ] Imports `defineModuleConfig` from `@nsxbet/admin-sdk/vite`
+- [ ] Imports and uses `react()` from `@vitejs/plugin-react`
+
+Expected:
+
+```typescript
+import { defineModuleConfig } from "@nsxbet/admin-sdk/vite";
+import react from "@vitejs/plugin-react";
+
+export default defineModuleConfig({
+  port: 3003, // Choose a unique port for your module
+  plugins: [react()],
+});
+```
+
+## Tailwind Configuration
+
+- [ ] Imports `withAdminSdk` from `@nsxbet/admin-sdk/tailwind`
+
+Expected:
+
+```javascript
+import { withAdminSdk } from "@nsxbet/admin-sdk/tailwind";
+
+export default withAdminSdk({
+  content: ["./index.html", "./src/**/*.{ts,tsx}"],
+});
+```
+
+## PostCSS Configuration
+
+- [ ] Has `tailwindcss` and `autoprefixer` plugins
+
+Expected:
+
+```javascript
+export default {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+};
+```
+
+## CSS Setup (`src/index.css`)
+
+- [ ] Imports `@nsxbet/admin-ui/styles.css`
+- [ ] Has `@tailwind base`, `@tailwind components`, `@tailwind utilities`
+
+Expected:
+
+```css
+@import "@nsxbet/admin-ui/styles.css";
+
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+```
+
+## Entry Points
+
+### `src/spa.tsx`
+
+- [ ] Has `export default` (the App component)
+
+Expected:
+
+```tsx
+import { App } from "./App";
+
+export default App;
+```
+
+### `src/standalone.tsx`
+
+- [ ] Uses `AdminShell` from `@nsxbet/admin-sdk`
+- [ ] Imports manifest and passes to `modules` prop
+- [ ] Permissions use namespace `admin.<module-name>.*`
+
+Expected (simplified):
+
+```tsx
+import { AdminShell } from "@nsxbet/admin-sdk";
+import manifest from "../admin.module.json";
+import { App } from "./App";
+
+<AdminShell modules={[manifest]} keycloak={config}>
+  <App />
+</AdminShell>
+```
+
+### `src/App.tsx`
+
+- [ ] Uses `<Routes>` from `react-router-dom`
+
+Expected:
+
+```tsx
+import { Routes, Route, Navigate } from "react-router-dom";
+
+export function App() {
+  return (
+    <Routes>
+      <Route path="/" element={<Navigate to="home" replace />} />
+      <Route path="home" element={<HomePage />} />
+    </Routes>
+  );
+}
+```
+
+## SDK Hook Usage
+
+```tsx
+import { useAuth, useFetch, useTelemetry } from "@nsxbet/admin-sdk";
+import { useNavigate } from "react-router-dom";
+
+function MyComponent() {
+  const { hasPermission, getUser } = useAuth();
+  const fetch = useFetch(); // Use this instead of raw fetch()
+  const { track } = useTelemetry();
+  const navigate = useNavigate(); // From react-router-dom, NOT from SDK
+}
+```
+
+## Anti-Patterns (MUST NOT be present)
+
+- [ ] No `@supabase/supabase-js` or `supabase` imports in `src/**`
+- [ ] No `firebase` imports in `src/**`
+- [ ] No `BrowserRouter` or `MemoryRouter` in `src/**` (except `standalone.tsx`)
+- [ ] No `useNavigate` imported from `@nsxbet/admin-sdk` (use `react-router-dom`)
+- [ ] No `@supabase/supabase-js` or `firebase` in `package.json` dependencies
+- [ ] No raw `fetch()` or `window.fetch()` calls — use `useFetch()` from the SDK
+- [ ] Do NOT scaffold shadcn/ui components locally — use `@nsxbet/admin-ui` which ships them pre-configured

package/README.md

@@ -8,13 +8,45 @@ SDK for building admin modules for the NSX Admin platform.
 bun add @nsxbet/admin-sdk @nsxbet/admin-ui
 ```
 
-**Peer dependencies** (install these too):
+**Peer dependencies:**
 
 ```bash
-bun add react react-dom react-router-dom i18next react-i18next
-bun add -D @vitejs/plugin-react vite tailwindcss postcss autoprefixer typescript
+# Shared with shell - use exact versions to avoid conflicts
+bun add react@18.2.0 react-dom@18.2.0 react-router-dom@6.20.1 i18next@25.0.0 react-i18next@16.0.0
+
+# Styling - use exact versions for design system consistency
+bun add -D tailwindcss@3.4.0 postcss@8.4.32 autoprefixer@10.4.16 tailwindcss-animate@1.0.7
+
+# Build tools - flexible versions are fine
+bun add -D @vitejs/plugin-react vite typescript
 ```
 
+> **Why exact versions?** React, React Router, and i18next are shared at runtime - mismatches cause conflicts. Tailwind/PostCSS versions ensure consistent styling with the design system.
+
+## Quick Start (CLI)
+
+The fastest way to create a new module is using the CLI:
+
+```bash
+# Scaffold a new module
+npx @nsxbet/admin-cli init --id "@admin/my-module" --title "My Module" --route "/my-module" --port 3010
+
+# Generate a setup verification checklist
+npx @nsxbet/admin-cli checklist --output CHECKLIST.md
+
+# Validate an existing module
+npx @nsxbet/admin-cli check
+
+# Auto-fix common issues
+npx @nsxbet/admin-cli check --fix
+```
+
+The CLI scaffolds all 13 required files with correct configuration, dependency versions, and SDK integration. It also validates existing modules against the canonical reference.
+
+> **Required for LLMs:** After creating or modifying a module, run `npx @nsxbet/admin-cli checklist --output CHECKLIST.md` and verify every item in the generated file before considering the setup complete. The checklist is a self-contained verification guide—no CLI installation needed to consume it.
+
+> **Static checklist:** A ready-to-use `CHECKLIST.md` is also shipped inside the SDK package at `node_modules/@nsxbet/admin-sdk/CHECKLIST.md`. You can use it directly without installing the CLI.
+
 ## Quick Start
 
 This SDK enables you to build admin modules that integrate with the NSX Admin shell. Modules are loaded dynamically via React.lazy and share the shell's Router context.
@@ -115,7 +147,13 @@ export default App;
 ```tsx
 import React from "react";
 import ReactDOM from "react-dom/client";
-import { AdminShell, initI18n, i18n } from "@nsxbet/admin-sdk";
+import {
+  AdminShell,
+  initI18n,
+  i18n,
+  createInMemoryAuthClient,
+  createMockUsersFromRoles,
+} from "@nsxbet/admin-sdk";
 import type { AdminModuleManifest } from "@nsxbet/admin-sdk";
 import { App } from "./App";
 import manifest from "../admin.module.json";
@@ -134,9 +172,40 @@ const NAMESPACE = "mymodule";
 i18n.addResourceBundle("en-US", NAMESPACE, enUS, true, true);
 i18n.addResourceBundle("pt-BR", NAMESPACE, ptBR, true, true);
 
+// Type assertion for JSON import
+const moduleManifest = manifest as AdminModuleManifest;
+
+// Check environment variable to toggle between mock auth and Keycloak
+const useKeycloak = import.meta.env.VITE_MOCK_AUTH === "false";
+
+// Create mock users with module-specific permissions
+const mockUsers = createMockUsersFromRoles({
+  admin: ["admin.mymodule.view", "admin.mymodule.edit", "admin.mymodule.delete"],
+  editor: ["admin.mymodule.view", "admin.mymodule.edit"],
+  viewer: ["admin.mymodule.view"],
+  noAccess: [],
+});
+
+// Use in-memory auth by default (shows user selector), or Keycloak if configured
+const authClient = useKeycloak
+  ? undefined
+  : createInMemoryAuthClient({ users: mockUsers });
+
 ReactDOM.createRoot(document.getElementById("root")!).render(
   <React.StrictMode>
-    <AdminShell modules={[manifest as AdminModuleManifest]}>
+    <AdminShell
+      modules={[moduleManifest]}
+      authClient={authClient}
+      keycloak={
+        useKeycloak
+          ? {
+              url: "http://localhost:8080",
+              realm: "admin",
+              clientId: "admin-shell",
+            }
+          : undefined
+      }
+    >
       <App />
     </AdminShell>
   </React.StrictMode>
@@ -219,6 +288,52 @@ export function ItemList() {
 @tailwind utilities;
 ```
 
+### Directory: `src/i18n/` (optional - for translations)
+
+Structure:
+
+```
+src/i18n/
+  locales/
+    en-US.json    # English (required)
+    pt-BR.json    # Portuguese
+```
+
+Example `src/i18n/locales/en-US.json`:
+
+```json
+{
+  "module": {
+    "title": "My Module",
+    "description": "Description of my module"
+  },
+  "list": {
+    "title": "All Items",
+    "noItems": "No items found.",
+    "create": "Create Item"
+  },
+  "form": {
+    "titleLabel": "Title",
+    "titlePlaceholder": "Enter title",
+    "cancel": "Cancel",
+    "submit": "Submit"
+  }
+}
+```
+
+Use translations in components:
+
+```tsx
+import { useI18n } from "@nsxbet/admin-sdk";
+
+function MyComponent() {
+  const { t } = useI18n();
+  
+  // Use with namespace prefix (set in standalone.tsx)
+  return <h1>{t("mymodule:list.title")}</h1>;
+}
+```
+
 ### File: `tailwind.config.js`
 
 Use `withAdminSdk` which automatically includes the UI preset and SDK/UI content paths:
@@ -241,31 +356,36 @@ export default withAdminSdk({
   "type": "module",
   "scripts": {
     "dev": "vite",
-    "build": "tsc && vite build && cp admin.module.json dist/",
+    "build": "tsc && vite build",
     "preview": "vite preview"
   },
   "dependencies": {
     "@nsxbet/admin-sdk": "latest",
     "@nsxbet/admin-ui": "latest",
-    "react": "^18.2.0",
-    "react-dom": "^18.2.0",
-    "react-router-dom": "^6.20.0",
-    "i18next": "^25.0.0",
-    "react-i18next": "^16.0.0"
+    "react": "18.2.0",
+    "react-dom": "18.2.0",
+    "react-router-dom": "6.20.1",
+    "i18next": "25.0.0",
+    "react-i18next": "16.0.0"
   },
   "devDependencies": {
     "@types/react": "^18.2.0",
     "@types/react-dom": "^18.2.0",
     "@vitejs/plugin-react": "^4.2.0",
-    "autoprefixer": "^10.4.16",
-    "postcss": "^8.4.32",
-    "tailwindcss": "^3.4.0",
+    "autoprefixer": "10.4.16",
+    "postcss": "8.4.32",
+    "tailwindcss": "3.4.0",
+    "tailwindcss-animate": "1.0.7",
     "typescript": "^5.2.0",
     "vite": "^5.0.0"
   }
 }
 ```
 
+> **Note:** Exact versions for runtime deps (react, i18next) avoid conflicts with the shell. Exact versions for styling (tailwindcss, postcss) ensure design system consistency.
+
+> **Note:** `module.manifest.json` is generated automatically by `defineModuleConfig` at build time. No manual copy step is needed.
+
 ### File: `tsconfig.json`
 
 ```json
@@ -319,6 +439,66 @@ export default {
 };
 ```
 
+### File: `src/globals.d.ts`
+
+TypeScript declarations for environment variables and platform API:
+
+```typescript
+/// <reference types="vite/client" />
+
+declare global {
+  interface ImportMetaEnv {
+    readonly VITE_MOCK_AUTH?: string;
+  }
+
+  interface ImportMeta {
+    readonly env: ImportMetaEnv;
+  }
+
+  interface Window {
+    __ADMIN_PLATFORM_API__?: import("@nsxbet/admin-sdk").PlatformAPI;
+    __ENV__?: {
+      ENVIRONMENT: string;
+      KEYCLOAK_URL: string;
+      KEYCLOAK_REALM: string;
+      KEYCLOAK_CLIENT_ID: string;
+    };
+  }
+}
+
+export {};
+```
+
+### File: `tsconfig.node.json`
+
+Separate TypeScript config for Vite configuration file:
+
+```json
+{
+  "compilerOptions": {
+    "composite": true,
+    "skipLibCheck": true,
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "allowSyntheticDefaultImports": true,
+    "strict": true
+  },
+  "include": ["vite.config.ts"]
+}
+```
+
+### File: `.env.local` (optional)
+
+Environment configuration for development:
+
+```bash
+# Use mock authentication with user selector (default: true)
+VITE_MOCK_AUTH=true
+
+# Set to "false" to use Keycloak authentication
+# VITE_MOCK_AUTH=false
+```
+
 ## Manifest Schema (`admin.module.json`)
 
 | Field | Type | Required | Description |
@@ -371,11 +551,16 @@ export default defineModuleConfig({
 });
 ```
 
+> **Important:** Each module must use a unique port. The default is `8080` (matching Lovable's default). Modules running alongside Keycloak (which also uses port 8080) should specify an explicit port. Standard assignments:
+> - Shell: 3000
+> - API: 4000
+> - Modules: 3002, 3003, 3004, etc.
+
 ### Options
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
-| `port` | number | **required** | Dev server port |
+| `port` | number | `8080` | Dev server port |
 | `entry` | string | `"./src/spa.tsx"` | Entry file path |
 | `outDir` | string | `"dist"` | Output directory |
 | `plugins` | Plugin[] | `[]` | Additional Vite plugins |
@@ -390,6 +575,19 @@ These dependencies are provided by the shell (do not bundle them):
 ["react", "react-dom", "react-router-dom", "i18next", "react-i18next"]
 ```
 
+## ESLint Plugin
+
+Install `@nsxbet/eslint-plugin-admin` (requires ESLint 9+) to catch common mistakes at development time:
+
+```javascript
+// eslint.config.js
+import adminPlugin from "@nsxbet/eslint-plugin-admin";
+
+export default [adminPlugin.configs.recommended];
+```
+
+This enables all recommended rules including `@nsxbet/no-raw-fetch` which flags direct `fetch()`/`window.fetch()` calls that bypass authentication. Use `useFetch()` from the SDK instead.
+
 ## SDK Hooks
 
 ### `useAuth()`
@@ -587,6 +785,50 @@ const authClient = createInMemoryAuthClient({ users: customUsers });
 | `users` | MockUser[] | **required** | Mock users available for selection |
 | `storageKey` | string | `"@nsxbet/auth"` | localStorage key for persistence |
 
+## Keycloak Configuration (Production Auth)
+
+For production or when testing with real authentication, configure Keycloak:
+
+### Prerequisites
+
+1. Keycloak server running (default: `http://localhost:8080`)
+2. Realm named `admin` created
+3. Client named `admin-shell` configured with:
+   - Client Protocol: `openid-connect`
+   - Access Type: `public`
+   - Valid Redirect URIs: `http://localhost:3003/*`
+
+### Enable Keycloak in Development
+
+Set the environment variable in `.env.local`:
+
+```bash
+VITE_MOCK_AUTH=false
+```
+
+Or pass the `keycloak` prop directly without `authClient`:
+
+```tsx
+<AdminShell
+  modules={[manifest]}
+  keycloak={{
+    url: "http://localhost:8080",
+    realm: "admin",
+    clientId: "admin-shell",
+  }}
+>
+  <App />
+</AdminShell>
+```
+
+### Keycloak Configuration Options
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `url` | string | Keycloak server URL |
+| `realm` | string | Realm name |
+| `clientId` | string | Client ID |
+
 ## DO NOT (Common Mistakes)
 
 ### ❌ DO NOT use MemoryRouter
@@ -690,6 +932,8 @@ import { useNavigate } from "react-router-dom"; // ✅
 
 ## Troubleshooting
 
+**First step:** Run `npx @nsxbet/admin-cli checklist` and verify all items. The checklist covers every setup requirement and often identifies misconfigurations quickly.
+
 ### "Failed to resolve module specifier 'react'"
 
 **Cause:** Module is bundling React instead of using shell's version.
@@ -719,7 +963,7 @@ define: {
 
 ### Styles not working
 
-**Checklist:**
+Run `npx @nsxbet/admin-cli checklist` to verify Tailwind/PostCSS configuration. Key items:
 1. ✅ `index.css` imports `@nsxbet/admin-ui/styles.css`
 2. ✅ `tailwind.config.js` uses `withAdminSdk` from `@nsxbet/admin-sdk/tailwind`
 3. ✅ `postcss.config.js` exists with tailwindcss plugin

package/dist/registry/client/http.d.ts

@@ -2,7 +2,7 @@
  * HTTP Registry Client
  *
  * Implementation of RegistryClient that communicates with the admin-api.
- * Used when running with PostgreSQL backend.
+ * Used when running with MySQL backend.
  */
 import type { RegistryClient } from './interface';
 /**

package/dist/registry/client/http.js

@@ -2,7 +2,7 @@
  * HTTP Registry Client
  *
  * Implementation of RegistryClient that communicates with the admin-api.
- * Used when running with PostgreSQL backend.
+ * Used when running with MySQL backend.
  */
 /**
  * Create an HTTP registry client

package/dist/vite/config.d.ts

@@ -6,8 +6,9 @@ export declare const SHARED_EXTERNALS: readonly ["react", "react-dom", "react-ro
 export interface ModuleConfigOptions {
     /**
      * Development server port
+     * @default 8080
      */
-    port: number;
+    port?: number;
     /**
      * Entry file for the module SPA
      * @default "./src/spa.tsx"

package/dist/vite/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/vite/config.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,gBAAgB,iFAMnB,CAAC;AAEX,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE/B;;OAEG;IAEH,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;IAEhB;;OAEG;IAEH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,GAAG,CA8CpE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/vite/config.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,gBAAgB,iFAMnB,CAAC;AAEX,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE/B;;OAEG;IAEH,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;IAEhB;;OAEG;IAEH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,GAAG,CA8CpE"}

package/dist/vite/config.js

@@ -48,7 +48,7 @@ export const SHARED_EXTERNALS = [
  */
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function defineModuleConfig(options) {
-    const { port, entry = "./src/spa.tsx", outDir = "dist", additionalExternals = [], plugins = [], overrides = {}, } = options;
+    const { port = 8080, entry = "./src/spa.tsx", outDir = "dist", additionalExternals = [], plugins = [], overrides = {}, } = options;
     const externals = [...SHARED_EXTERNALS, ...additionalExternals];
     return {
         plugins: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nsxbet/admin-sdk",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "SDK for building NSX Admin modules with integrated shell",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,16 +25,19 @@
     "./package.json": "./package.json"
   },
   "files": [
-    "dist"
+    "dist",
+    "CHECKLIST.md",
+    "scripts"
   ],
   "scripts": {
+    "postinstall": "node scripts/postinstall.js",
     "build": "tsc",
     "dev": "tsc --watch --preserveWatchOutput",
     "type-check": "tsc --noEmit",
     "test": "vitest run --passWithNoTests"
   },
   "peerDependencies": {
-    "@nsxbet/admin-ui": ">=0.1.0",
+    "@nsxbet/admin-ui": "^0.2.0",
     "@vitejs/plugin-react": "^4.0.0",
     "i18next": "^23.0.0 || ^24.0.0 || ^25.0.0",
     "react": "^18.2.0",

package/scripts/postinstall.js

@@ -0,0 +1 @@
+console.log("@nsxbet/admin-sdk: Module setup checklist available at node_modules/@nsxbet/admin-sdk/CHECKLIST.md");