@cofhe/react 0.0.0-alpha-20260420123124 → 0.0.0-alpha-20260526073024

package/README.md

@@ -16,7 +16,6 @@ pnpm add @cofhe/react @cofhe/sdk
 
 ```tsx
 import { CofheProvider } from '@cofhe/react';
-import '@cofhe/react/styles.css'; // Import component styles
 import { createCofheClient } from '@cofhe/sdk/web';
 
 const client = createCofheClient(config);
@@ -30,10 +29,45 @@ function App() {
 }
 ```
 
+### Hooks-only usage
+
+If you only want hooks/providers and do not want package CSS or UI components, import from the root package only:
+
+```tsx
+import { CofheProvider, useCofheClient } from '@cofhe/react';
+
+function App() {
+  return (
+    <CofheProvider config={config}>
+      <YourHookDrivenApp />
+    </CofheProvider>
+  );
+}
+```
+
+If you do want the styled React UI components, import them from `@cofhe/react/ui`:
+
+```tsx
+import { CofheProvider } from '@cofhe/react';
+import { CofheFloatingButtonWithProvider } from '@cofhe/react/ui';
+
+function App() {
+  return (
+    <CofheProvider config={config}>
+      <YourApp />
+      <CofheFloatingButtonWithProvider />
+    </CofheProvider>
+  );
+}
+```
+
+The `@cofhe/react/ui` entrypoint includes the package styles automatically.
+
 ### 2. Use the CofheEncryptInput component
 
 ```tsx
-import { CofheEncryptInput, FheTypesList } from '@cofhe/react';
+import { FheTypesList } from '@cofhe/react';
+import { CofheEncryptInput } from '@cofhe/react/ui';
 
 function MyComponent() {
   return (
@@ -131,13 +165,13 @@ const {
 
 ## Styling
 
-The package includes Tailwind CSS styles. Import them in your app:
+The root `@cofhe/react` entrypoint is headless and does not load package styles.
 
-```tsx
-import '@cofhe/react/styles.css';
-```
+If you import components from `@cofhe/react/ui`, the package styles are loaded automatically.
+
+## Maintainer Notes
 
-If you're using Tailwind CSS in your project, the component classes will work automatically.
+- Query invalidation context and block-hash-aware refetching: [INVALIDATION_CONTEXT.md](./INVALIDATION_CONTEXT.md)
 
 ## Dependencies