@kbach/react-native 1.0.0-beta.0 → 1.0.0-beta.2

package/README.md

@@ -6,12 +6,75 @@ resolved to a real `StyleSheet`-ready style object instead of injected CSS.
 
 > **Beta, Android-only.** Resolution runs through a Kotlin/JNI TurboModule
 > calling the same Rust core `@kbach/react` uses, so class semantics stay
-> identical across web and native — but that TurboModule currently has to be
-> wired into your app's native Android project by hand (see
-> `apps/native-sandbox` in the [repo](https://github.com/semsakadanupol/kbach)
-> for a full working reference integration). There's no iOS bridge yet, and
-> no prebuilt native module distribution — expect to do real native-side
-> setup, not a drop-in `npm install`.
+> identical across web and native. The native module ships prebuilt (see
+> Setup below) — no Rust toolchain or manual native wiring required — but
+> there's no iOS bridge yet.
+
+## Setup
+
+```sh
+npm install @kbach/react-native
+```
+
+That pulls in [`@kbach/android`](https://www.npmjs.com/package/@kbach/android)
+too — the actual native module — as a real dependency. Android's
+autolinking discovers it automatically the moment it's in `node_modules`;
+no manual `MainApplication.kt` edit needed. Works the same way whether
+your app was created with the React Native CLI or with Expo — **except
+Expo Go**, which can never load this (or any) custom native module; see
+below.
+
+### React Native CLI
+
+Add the Babel plugin so your app's JSX routes through Kbach's JSX runtime
+instead of `react/jsx-runtime`:
+
+```js
+// babel.config.js
+module.exports = {
+  presets: ['module:@react-native/babel-preset'],
+  plugins: ['@kbach/react-native/babel-plugin'],
+};
+```
+
+Then rebuild the Android app (`npm run android`, or a clean Gradle build if
+you're re-running one that's already built) so Gradle picks up the new
+native module. See `apps/native-sandbox` in the
+[repo](https://github.com/semsakadanupol/kbach) for a full working
+reference project, including the Metro config a monorepo setup like this
+one needs (a plain single-app install doesn't need any of that — it's
+only relevant if you're linking packages locally instead of installing
+from npm).
+
+### Expo
+
+**Expo Go doesn't work** — it's a fixed pre-built binary with no way to
+load a custom native module like `@kbach/android`. You need a **dev
+client** instead (a custom build of your app with this module baked in) —
+functionally the same "real native project" setup as the CLI path above,
+just generated and driven through Expo's own tooling:
+
+```js
+// babel.config.js
+module.exports = {
+  presets: ['babel-preset-expo'], // not '@react-native/babel-preset'
+  plugins: ['@kbach/react-native/babel-plugin'],
+};
+```
+
+```sh
+npx expo prebuild    # generates android/ (and ios/, which this package doesn't support yet)
+npx expo run:android # builds and installs a dev client with the native module included
+```
+
+Also requires the New Architecture enabled (Expo's default in current SDK
+versions) — `@kbach/android` is a TurboModule, which doesn't exist under
+the legacy bridge at all. If you're on an older SDK/config with the New
+Architecture off, turn it on in `app.json`
+(`"newArchEnabled": true` under `expo`) before prebuilding.
+
+EAS Build works the same way — it runs the same `prebuild` step, so no
+extra configuration beyond the two steps above.
 
 ## What this is
 

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@kbach/react-native",
-  "version": "1.0.0-beta.0",
-  "description": "Kbach's utility-class styling engine for React Native — the same class names as @kbach/react, resolved to a StyleSheet-ready style object via a Kotlin/JNI TurboModule. Beta, Android-only.",
-  "keywords": ["css", "react-native", "tailwind", "utility-first", "styling", "android"],
+  "version": "1.0.0-beta.2",
+  "description": "Kbach's utility-class styling engine for React Native — the same class names as @kbach/react, resolved to a StyleSheet-ready style object via a Kotlin/JNI TurboModule. Beta, Android-only. Works with the React Native CLI or an Expo dev client (not Expo Go).",
+  "keywords": ["css", "react-native", "expo", "tailwind", "utility-first", "styling", "android"],
   "license": "MIT",
   "author": "semsakadanupol",
   "repository": {
@@ -50,6 +50,9 @@
     "lint": "tsc --noEmit",
     "generate:colors": "node ../core-engine/scripts/generate-palette.mjs src/generatedPalette.ts"
   },
+  "dependencies": {
+    "@kbach/android": "1.0.0-beta.0"
+  },
   "devDependencies": {
     "@types/react": "^19.2.0",
     "@types/react-test-renderer": "^19.1.0",