@questpie/admin 0.0.1

package/package.json

@@ -0,0 +1,276 @@
+{
+	"name": "@questpie/admin",
+	"version": "0.0.1",
+	"type": "module",
+	"imports": {
+		"#questpie/admin/*": "./src/*"
+	},
+	"exports": {
+		"./__tests__/setup": "./src/__tests__/setup.ts",
+		"./__tests__/test-utils": "./src/__tests__/test-utils.tsx",
+		"./components": "./src/components/index.ts",
+		"./components/admin-app": "./src/components/admin-app.tsx",
+		"./components/fields": "./src/components/fields/index.ts",
+		"./components/fields/array-field": "./src/components/fields/array-field.tsx",
+		"./components/fields/checkbox-field": "./src/components/fields/checkbox-field.tsx",
+		"./components/fields/custom-field": "./src/components/fields/custom-field.tsx",
+		"./components/fields/date-field": "./src/components/fields/date-field.tsx",
+		"./components/fields/datetime-field": "./src/components/fields/datetime-field.tsx",
+		"./components/fields/email-field": "./src/components/fields/email-field.tsx",
+		"./components/fields/embedded-collection": "./src/components/fields/embedded-collection.tsx",
+		"./components/fields/field-types": "./src/components/fields/field-types.ts",
+		"./components/fields/field-utils": "./src/components/fields/field-utils.ts",
+		"./components/fields/field-wrapper": "./src/components/fields/field-wrapper.tsx",
+		"./components/fields/json-field": "./src/components/fields/json-field.tsx",
+		"./components/fields/locale-badge": "./src/components/fields/locale-badge.tsx",
+		"./components/fields/number-field": "./src/components/fields/number-field.tsx",
+		"./components/fields/password-field": "./src/components/fields/password-field.tsx",
+		"./components/fields/relation-field": "./src/components/fields/relation-field.tsx",
+		"./components/fields/relation-picker": "./src/components/fields/relation-picker.tsx",
+		"./components/fields/relation-select": "./src/components/fields/relation-select.tsx",
+		"./components/fields/rich-text-editor": "./src/components/fields/rich-text-editor/index.tsx",
+		"./components/fields/select-field": "./src/components/fields/select-field.tsx",
+		"./components/fields/switch-field": "./src/components/fields/switch-field.tsx",
+		"./components/fields/text-field": "./src/components/fields/text-field.tsx",
+		"./components/fields/textarea-field": "./src/components/fields/textarea-field.tsx",
+		"./components/primitives": "./src/components/primitives/index.ts",
+		"./components/primitives/checkbox-input": "./src/components/primitives/checkbox-input.tsx",
+		"./components/primitives/date-input": "./src/components/primitives/date-input.tsx",
+		"./components/primitives/number-input": "./src/components/primitives/number-input.tsx",
+		"./components/primitives/select-input": "./src/components/primitives/select-input.tsx",
+		"./components/primitives/tag-input": "./src/components/primitives/tag-input.tsx",
+		"./components/primitives/text-input": "./src/components/primitives/text-input.tsx",
+		"./components/primitives/textarea-input": "./src/components/primitives/textarea-input.tsx",
+		"./components/primitives/toggle-input": "./src/components/primitives/toggle-input.tsx",
+		"./components/primitives/types": "./src/components/primitives/types.ts",
+		"./components/ui/accordion": "./src/components/ui/accordion.tsx",
+		"./components/ui/avatar": "./src/components/ui/avatar.tsx",
+		"./components/ui/badge": "./src/components/ui/badge.tsx",
+		"./components/ui/button": "./src/components/ui/button.tsx",
+		"./components/ui/card": "./src/components/ui/card.tsx",
+		"./components/ui/checkbox": "./src/components/ui/checkbox.tsx",
+		"./components/ui/combobox": "./src/components/ui/combobox.tsx",
+		"./components/ui/dialog": "./src/components/ui/dialog.tsx",
+		"./components/ui/dropdown-menu": "./src/components/ui/dropdown-menu.tsx",
+		"./components/ui/field": "./src/components/ui/field.tsx",
+		"./components/ui/input": "./src/components/ui/input.tsx",
+		"./components/ui/input-group": "./src/components/ui/input-group.tsx",
+		"./components/ui/label": "./src/components/ui/label.tsx",
+		"./components/ui/popover": "./src/components/ui/popover.tsx",
+		"./components/ui/scroll-area": "./src/components/ui/scroll-area.tsx",
+		"./components/ui/select": "./src/components/ui/select.tsx",
+		"./components/ui/separator": "./src/components/ui/separator.tsx",
+		"./components/ui/sheet": "./src/components/ui/sheet.tsx",
+		"./components/ui/sidebar": "./src/components/ui/sidebar.tsx",
+		"./components/ui/skeleton": "./src/components/ui/skeleton.tsx",
+		"./components/ui/spinner": "./src/components/ui/spinner.tsx",
+		"./components/ui/switch": "./src/components/ui/switch.tsx",
+		"./components/ui/table": "./src/components/ui/table.tsx",
+		"./components/ui/tabs": "./src/components/ui/tabs.tsx",
+		"./components/ui/textarea": "./src/components/ui/textarea.tsx",
+		"./components/ui/tooltip": "./src/components/ui/tooltip.tsx",
+		"./config": "./src/config/index.ts",
+		"./config/component-registry": "./src/config/component-registry.ts",
+		"./hooks": "./src/hooks/index.ts",
+		"./hooks/admin-provider": "./src/hooks/admin-provider.tsx",
+		"./hooks/store": "./src/hooks/store.ts",
+		"./hooks/use-auth": "./src/hooks/use-auth.ts",
+		"./hooks/use-collection": "./src/hooks/use-collection.ts",
+		"./hooks/use-collection-db": "./src/hooks/use-collection-db.ts",
+		"./hooks/use-global": "./src/hooks/use-global.ts",
+		"./hooks/use-mobile": "./src/hooks/use-mobile.ts",
+		"./lib/utils": "./src/lib/utils.ts",
+		"./styles": "./src/styles/index.css",
+		"./utils": "./src/utils/index.ts",
+		"./views": "./src/views/index.ts",
+		"./views/auth": "./src/views/auth/index.ts",
+		"./views/auth/auth-layout": "./src/views/auth/auth-layout.tsx",
+		"./views/auth/forgot-password-form": "./src/views/auth/forgot-password-form.tsx",
+		"./views/auth/login-form": "./src/views/auth/login-form.tsx",
+		"./views/auth/reset-password-form": "./src/views/auth/reset-password-form.tsx",
+		"./views/collection": "./src/views/collection/index.ts",
+		"./views/collection/auto-form-fields": "./src/views/collection/auto-form-fields.tsx",
+		"./views/collection/collection-form": "./src/views/collection/collection-form.tsx",
+		"./views/collection/collection-list": "./src/views/collection/collection-list.tsx",
+		"./views/collection/form-field": "./src/views/collection/form-field.tsx",
+		"./views/common": "./src/views/common/index.ts",
+		"./views/common/locale-switcher": "./src/views/common/locale-switcher.tsx",
+		"./views/common/version-history": "./src/views/common/version-history.tsx",
+		"./views/layout": "./src/views/layout/index.ts",
+		"./views/layout/admin-layout": "./src/views/layout/admin-layout.tsx",
+		"./views/layout/admin-router": "./src/views/layout/admin-router.tsx",
+		"./views/layout/admin-sidebar": "./src/views/layout/admin-sidebar.tsx",
+		"./package.json": "./package.json"
+	},
+	"scripts": {
+		"dev": "tsdown --watch",
+		"build": "tsdown",
+		"check-types": "tsc --noEmit",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"test:coverage": "vitest run --coverage"
+	},
+	"dependencies": {
+		"@base-ui/react": "^1.0.0",
+		"@fontsource-variable/dm-sans": "^5.2.8",
+		"@fontsource-variable/jetbrains-mono": "^5.2.8",
+		"@phosphor-icons/react": "^2.1.10",
+		"questpie": "workspace:*",
+		"@questpie/tanstack-query": "workspace:*",
+		"@tailwindcss/vite": "^4.0.6",
+		"@tiptap/core": "^2.x",
+		"@tiptap/extension-character-count": "^2.x",
+		"@tiptap/extension-code-block-lowlight": "^2.x",
+		"@tiptap/extension-image": "^2.x",
+		"@tiptap/extension-link": "^2.x",
+		"@tiptap/extension-placeholder": "^2.x",
+		"@tiptap/extension-table": "^2.x",
+		"@tiptap/extension-table-cell": "^2.x",
+		"@tiptap/extension-table-header": "^2.x",
+		"@tiptap/extension-table-row": "^2.x",
+		"@tiptap/extension-text-align": "^2.x",
+		"@tiptap/extension-underline": "^2.x",
+		"@tiptap/react": "^2.x",
+		"@tiptap/starter-kit": "^2.x",
+		"@tiptap/suggestion": "^2.x",
+		"class-variance-authority": "^0.7.1",
+		"clsx": "^2.1.1",
+		"date-fns": "^4.1.0",
+		"jotai": "^2.12.3",
+		"lowlight": "^3.x",
+		"react-day-picker": "^9.12.0",
+		"react-hook-form": "^7.54.0",
+		"react-resizable-panels": "^3.0.6",
+		"recharts": "2.15.4",
+		"shadcn": "^3.6.1",
+		"sonner": "^2.0.7",
+		"tailwind-merge": "^3.4.0",
+		"tailwindcss": "^4.0.6",
+		"tippy.js": "^6.3.7",
+		"tw-animate-css": "^1.4.0",
+		"vaul": "^1.1.2"
+	},
+	"peerDependencies": {
+		"react": "^19.2.0",
+		"react-dom": "^19.2.0",
+		"@tanstack/react-query": "^5.x",
+		"@tanstack/react-table": "^8.x",
+		"@tanstack/db": "^0.x",
+		"better-auth": "^1.4.0"
+	},
+	"devDependencies": {
+		"@questpie/typescript-config": "workspace:*",
+		"@tanstack/db": "^0.1.1",
+		"@testing-library/jest-dom": "^6.9.1",
+		"@testing-library/react": "^16.3.1",
+		"@testing-library/user-event": "^14.6.1",
+		"@types/react": "^19.2.0",
+		"@types/react-dom": "^19.2.0",
+		"@vitejs/plugin-react": "^5.1.2",
+		"happy-dom": "^20.1.0",
+		"jsdom": "^27.4.0",
+		"tsdown": "^0.18.3",
+		"typescript": "^5.9.2",
+		"vitest": "^4.0.16"
+	},
+	"publishConfig": {
+		"access": "public",
+		"exports": {
+			"./__tests__/setup": "./dist/__tests__/setup.mjs",
+			"./__tests__/test-utils": "./dist/__tests__/test-utils.mjs",
+			"./components": "./dist/components/index.mjs",
+			"./components/admin-app": "./dist/components/admin-app.mjs",
+			"./components/fields": "./dist/components/fields/index.mjs",
+			"./components/fields/array-field": "./dist/components/fields/array-field.mjs",
+			"./components/fields/checkbox-field": "./dist/components/fields/checkbox-field.mjs",
+			"./components/fields/custom-field": "./dist/components/fields/custom-field.mjs",
+			"./components/fields/date-field": "./dist/components/fields/date-field.mjs",
+			"./components/fields/datetime-field": "./dist/components/fields/datetime-field.mjs",
+			"./components/fields/email-field": "./dist/components/fields/email-field.mjs",
+			"./components/fields/embedded-collection": "./dist/components/fields/embedded-collection.mjs",
+			"./components/fields/field-types": "./dist/components/fields/field-types.mjs",
+			"./components/fields/field-utils": "./dist/components/fields/field-utils.mjs",
+			"./components/fields/field-wrapper": "./dist/components/fields/field-wrapper.mjs",
+			"./components/fields/json-field": "./dist/components/fields/json-field.mjs",
+			"./components/fields/locale-badge": "./dist/components/fields/locale-badge.mjs",
+			"./components/fields/number-field": "./dist/components/fields/number-field.mjs",
+			"./components/fields/password-field": "./dist/components/fields/password-field.mjs",
+			"./components/fields/relation-field": "./dist/components/fields/relation-field.mjs",
+			"./components/fields/relation-picker": "./dist/components/fields/relation-picker.mjs",
+			"./components/fields/relation-select": "./dist/components/fields/relation-select.mjs",
+			"./components/fields/rich-text-editor": "./dist/components/fields/rich-text-editor/index.mjs",
+			"./components/fields/select-field": "./dist/components/fields/select-field.mjs",
+			"./components/fields/switch-field": "./dist/components/fields/switch-field.mjs",
+			"./components/fields/text-field": "./dist/components/fields/text-field.mjs",
+			"./components/fields/textarea-field": "./dist/components/fields/textarea-field.mjs",
+			"./components/primitives": "./dist/components/primitives/index.mjs",
+			"./components/primitives/checkbox-input": "./dist/components/primitives/checkbox-input.mjs",
+			"./components/primitives/date-input": "./dist/components/primitives/date-input.mjs",
+			"./components/primitives/number-input": "./dist/components/primitives/number-input.mjs",
+			"./components/primitives/select-input": "./dist/components/primitives/select-input.mjs",
+			"./components/primitives/tag-input": "./dist/components/primitives/tag-input.mjs",
+			"./components/primitives/text-input": "./dist/components/primitives/text-input.mjs",
+			"./components/primitives/textarea-input": "./dist/components/primitives/textarea-input.mjs",
+			"./components/primitives/toggle-input": "./dist/components/primitives/toggle-input.mjs",
+			"./components/primitives/types": "./dist/components/primitives/types.mjs",
+			"./components/ui/accordion": "./dist/components/ui/accordion.mjs",
+			"./components/ui/avatar": "./dist/components/ui/avatar.mjs",
+			"./components/ui/badge": "./dist/components/ui/badge.mjs",
+			"./components/ui/button": "./dist/components/ui/button.mjs",
+			"./components/ui/card": "./dist/components/ui/card.mjs",
+			"./components/ui/checkbox": "./dist/components/ui/checkbox.mjs",
+			"./components/ui/combobox": "./dist/components/ui/combobox.mjs",
+			"./components/ui/dialog": "./dist/components/ui/dialog.mjs",
+			"./components/ui/dropdown-menu": "./dist/components/ui/dropdown-menu.mjs",
+			"./components/ui/field": "./dist/components/ui/field.mjs",
+			"./components/ui/input": "./dist/components/ui/input.mjs",
+			"./components/ui/input-group": "./dist/components/ui/input-group.mjs",
+			"./components/ui/label": "./dist/components/ui/label.mjs",
+			"./components/ui/popover": "./dist/components/ui/popover.mjs",
+			"./components/ui/scroll-area": "./dist/components/ui/scroll-area.mjs",
+			"./components/ui/select": "./dist/components/ui/select.mjs",
+			"./components/ui/separator": "./dist/components/ui/separator.mjs",
+			"./components/ui/sheet": "./dist/components/ui/sheet.mjs",
+			"./components/ui/sidebar": "./dist/components/ui/sidebar.mjs",
+			"./components/ui/skeleton": "./dist/components/ui/skeleton.mjs",
+			"./components/ui/spinner": "./dist/components/ui/spinner.mjs",
+			"./components/ui/switch": "./dist/components/ui/switch.mjs",
+			"./components/ui/table": "./dist/components/ui/table.mjs",
+			"./components/ui/tabs": "./dist/components/ui/tabs.mjs",
+			"./components/ui/textarea": "./dist/components/ui/textarea.mjs",
+			"./components/ui/tooltip": "./dist/components/ui/tooltip.mjs",
+			"./config": "./dist/config/index.mjs",
+			"./config/component-registry": "./dist/config/component-registry.mjs",
+			"./hooks": "./dist/hooks/index.mjs",
+			"./hooks/admin-provider": "./dist/hooks/admin-provider.mjs",
+			"./hooks/store": "./dist/hooks/store.mjs",
+			"./hooks/use-auth": "./dist/hooks/use-auth.mjs",
+			"./hooks/use-collection": "./dist/hooks/use-collection.mjs",
+			"./hooks/use-collection-db": "./dist/hooks/use-collection-db.mjs",
+			"./hooks/use-global": "./dist/hooks/use-global.mjs",
+			"./hooks/use-mobile": "./dist/hooks/use-mobile.mjs",
+			"./lib/utils": "./dist/lib/utils.mjs",
+			"./styles": "./dist/styles/index.mjs",
+			"./utils": "./dist/utils/index.mjs",
+			"./views": "./dist/views/index.mjs",
+			"./views/auth": "./dist/views/auth/index.mjs",
+			"./views/auth/auth-layout": "./dist/views/auth/auth-layout.mjs",
+			"./views/auth/forgot-password-form": "./dist/views/auth/forgot-password-form.mjs",
+			"./views/auth/login-form": "./dist/views/auth/login-form.mjs",
+			"./views/auth/reset-password-form": "./dist/views/auth/reset-password-form.mjs",
+			"./views/collection": "./dist/views/collection/index.mjs",
+			"./views/collection/auto-form-fields": "./dist/views/collection/auto-form-fields.mjs",
+			"./views/collection/collection-form": "./dist/views/collection/collection-form.mjs",
+			"./views/collection/collection-list": "./dist/views/collection/collection-list.mjs",
+			"./views/collection/form-field": "./dist/views/collection/form-field.mjs",
+			"./views/common": "./dist/views/common/index.mjs",
+			"./views/common/locale-switcher": "./dist/views/common/locale-switcher.mjs",
+			"./views/common/version-history": "./dist/views/common/version-history.mjs",
+			"./views/layout": "./dist/views/layout/index.mjs",
+			"./views/layout/admin-layout": "./dist/views/layout/admin-layout.mjs",
+			"./views/layout/admin-router": "./dist/views/layout/admin-router.mjs",
+			"./views/layout/admin-sidebar": "./dist/views/layout/admin-sidebar.mjs",
+			"./package.json": "./package.json"
+		}
+	}
+}

package/src/__tests__/setup.ts

@@ -0,0 +1,44 @@
+/**
+ * Vitest setup file for @questpie/admin
+ */
+
+import * as matchers from "@testing-library/jest-dom/matchers";
+import { cleanup } from "@testing-library/react";
+import { afterEach, expect, vi } from "vitest";
+
+// Extend vitest's expect with jest-dom matchers
+expect.extend(matchers);
+
+// Cleanup after each test
+afterEach(() => {
+	cleanup();
+});
+
+// Mock window.matchMedia for responsive components
+Object.defineProperty(window, "matchMedia", {
+	writable: true,
+	value: vi.fn().mockImplementation((query: string) => ({
+		matches: false,
+		media: query,
+		onchange: null,
+		addListener: vi.fn(),
+		removeListener: vi.fn(),
+		addEventListener: vi.fn(),
+		removeEventListener: vi.fn(),
+		dispatchEvent: vi.fn(),
+	})),
+});
+
+// Mock ResizeObserver
+global.ResizeObserver = vi.fn().mockImplementation(() => ({
+	observe: vi.fn(),
+	unobserve: vi.fn(),
+	disconnect: vi.fn(),
+}));
+
+// Mock IntersectionObserver
+global.IntersectionObserver = vi.fn().mockImplementation(() => ({
+	observe: vi.fn(),
+	unobserve: vi.fn(),
+	disconnect: vi.fn(),
+}));

package/src/__tests__/test-utils.tsx

@@ -0,0 +1,49 @@
+/**
+ * Test utilities for @questpie/admin components
+ */
+
+import * as React from "react";
+import { render, type RenderOptions } from "@testing-library/react";
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+
+/**
+ * Create a fresh QueryClient for each test
+ */
+function createTestQueryClient() {
+	return new QueryClient({
+		defaultOptions: {
+			queries: {
+				retry: false,
+				gcTime: 0,
+			},
+			mutations: {
+				retry: false,
+			},
+		},
+	});
+}
+
+/**
+ * Test wrapper with all required providers
+ */
+function TestWrapper({ children }: { children: React.ReactNode }) {
+	const [queryClient] = React.useState(() => createTestQueryClient());
+
+	return (
+		<QueryClientProvider client={queryClient}>{children}</QueryClientProvider>
+	);
+}
+
+/**
+ * Custom render function that wraps components with test providers
+ */
+function customRender(
+	ui: React.ReactElement,
+	options?: Omit<RenderOptions, "wrapper">,
+): ReturnType<typeof render> {
+	return render(ui, { wrapper: TestWrapper, ...options });
+}
+
+// Re-export everything from testing-library
+export * from "@testing-library/react";
+export { customRender as render };

package/src/__tests__/vitest.d.ts

@@ -0,0 +1,9 @@
+import "vitest";
+import type { TestingLibraryMatchers } from "@testing-library/jest-dom/matchers";
+
+declare module "vitest" {
+	interface Assertion<T = any>
+		extends TestingLibraryMatchers<typeof expect.stringContaining, T> {}
+	interface AsymmetricMatchersContaining
+		extends TestingLibraryMatchers<unknown, unknown> {}
+}

package/src/components/admin-app.tsx

@@ -0,0 +1,221 @@
+/**
+ * AdminApp Component
+ *
+ * MAIN ENTRY POINT - Mount this and you have a complete admin!
+ *
+ * Minimal usage:
+ *   <AdminApp client={cmsClient} />
+ *
+ * Everything else is OPTIONAL customization.
+ */
+
+import * as React from "react";
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import type { Questpie } from "questpie";
+import type { QuestpieClient } from "questpie/client";
+import { AdminProvider } from "../hooks/admin-provider";
+import { AdminLayout } from "../views/layout/admin-layout";
+import { AdminRouter } from "../views/layout/admin-router";
+import type { ComponentRegistry } from "../config/component-registry";
+import { mergeComponentRegistry } from "../config/component-registry";
+
+export interface AdminAppProps<T extends Questpie<any>> {
+	/**
+	 * CMS client - THE ONLY REQUIRED PROP!
+	 */
+	client: QuestpieClient<T>;
+
+	/**
+	 * Admin config (OPTIONAL)
+	 * If not provided, auto-generates from CMS schema
+	 */
+	config?: {
+		app?: {
+			brand?: {
+				name?: string;
+				logo?: React.ComponentType;
+				homeRoute?: string;
+			};
+			locales?: {
+				default: string;
+				available: string[];
+			};
+			header?: {
+				show?: boolean;
+				component?: React.ComponentType;
+			};
+			footer?: {
+				show?: boolean;
+				component?: React.ComponentType;
+			};
+			debug?: {
+				showQueryDevtools?: boolean;
+				showRouterDevtools?: boolean;
+			};
+		};
+		collections?: Record<string, any>;
+		globals?: Record<string, any>;
+		pages?: Record<string, any>;
+	};
+
+	/**
+	 * Component registry (OPTIONAL)
+	 * Custom field components, layouts, etc.
+	 */
+	registry?: Partial<ComponentRegistry>;
+
+	/**
+	 * QueryClient instance (OPTIONAL)
+	 * If not provided, creates default
+	 */
+	queryClient?: QueryClient;
+
+	/**
+	 * Router integration (framework-specific)
+	 */
+	router: {
+		/**
+		 * Link component from your router
+		 * Example: from TanStack Router, Next.js, React Router
+		 */
+		LinkComponent: React.ComponentType<{
+			to: string;
+			className?: string;
+			children: React.ReactNode;
+			activeProps?: { className?: string };
+		}>;
+
+		/**
+		 * Current route path
+		 */
+		currentPath: string;
+
+		/**
+		 * Route segments after /admin
+		 * Example: for /admin/barbers/123 -> ["barbers", "123"]
+		 */
+		segments: string[];
+
+		/**
+		 * Navigate function
+		 */
+		navigate: (path: string) => void;
+	};
+
+	/**
+	 * Base path for admin routes (OPTIONAL)
+	 * Default: "/admin"
+	 */
+	basePath?: string;
+
+	/**
+	 * Custom dashboard component (OPTIONAL)
+	 */
+	DashboardComponent?: React.ComponentType;
+
+	/**
+	 * Custom collection components (OPTIONAL)
+	 */
+	collectionComponents?: Record<
+		string,
+		{
+			List?: React.ComponentType;
+			Form?: React.ComponentType;
+		}
+	>;
+
+	/**
+	 * Render custom form fields (OPTIONAL - will be replaced by AutoFormFields)
+	 */
+	renderFormFields?: (collection: string) => React.ReactNode;
+}
+
+/**
+ * Default QueryClient configuration
+ */
+function createDefaultQueryClient() {
+	return new QueryClient({
+		defaultOptions: {
+			queries: {
+				staleTime: 60 * 1000, // 1 minute
+				refetchOnWindowFocus: false,
+			},
+		},
+	});
+}
+
+/**
+ * AdminApp Component
+ *
+ * ONE COMPONENT TO RULE THEM ALL!
+ */
+export function AdminApp<T extends Questpie<any>>({
+	client,
+	config,
+	registry,
+	queryClient,
+	router,
+	basePath = "/admin",
+	DashboardComponent,
+	collectionComponents,
+	renderFormFields,
+}: AdminAppProps<T>): React.ReactElement {
+	// Create or use provided QueryClient
+	const [defaultQueryClient] = React.useState(
+		() => queryClient ?? createDefaultQueryClient(),
+	);
+
+	// Merge component registry
+	const mergedRegistry = React.useMemo(
+		() => mergeComponentRegistry(registry),
+		[registry],
+	);
+
+	// Auto-generate config from CMS if not provided
+	const finalConfig = React.useMemo(() => {
+		if (config) return config;
+
+		// TODO: Auto-generate from CMS schema
+		// For now, return minimal config
+		return {
+			app: {
+				brand: {
+					name: "Admin",
+				},
+			},
+			collections: {},
+		};
+	}, [config]);
+
+	return (
+		<QueryClientProvider client={defaultQueryClient}>
+			<AdminProvider
+				client={client}
+				queryClient={defaultQueryClient}
+				locales={finalConfig.app?.locales}
+			>
+				<AdminLayout
+					config={finalConfig}
+					activeRoute={router.currentPath}
+					LinkComponent={router.LinkComponent}
+				>
+					<AdminRouter
+						config={finalConfig}
+						segments={router.segments}
+						navigate={router.navigate}
+						DashboardComponent={DashboardComponent}
+						collectionComponents={collectionComponents}
+						renderFormFields={renderFormFields}
+						registry={mergedRegistry}
+					/>
+				</AdminLayout>
+			</AdminProvider>
+
+			{/* Optional: Query Devtools */}
+			{config?.app?.debug?.showQueryDevtools && (
+				// TODO: Add ReactQueryDevtools
+				<div />
+			)}
+		</QueryClientProvider>
+	);
+}