docs: add docs about packageName

Author: sAleksovski

docs/docs/tutorial/register-widget-expo.md

@@ -67,6 +67,12 @@ export default ({ config }: ConfigContext): ExpoConfig => ({
 });
 ```
 
+:::note
+By default the widget Java class will be put inside `<app-package-name>.widget`
+
+If for any reason (for example you already have an app that is not using react-native-android-widget and want to replace existing widgets with react-native-android-widgets, but you already have providers in a different package), you can customize the widget java class package with `packageName` property for the widget
+:::
+
 ## Build Dev Client
 
 Build an [Expo Dev Client](https://docs.expo.dev/development/create-development-builds/) that will include `react-native-android-widget` and the new widget

docs/docs/tutorial/register-widget.md

@@ -10,6 +10,10 @@ In order to register our widget so that it can be selected from the launchers wi
 
 Create a new package `widget` in the native android app.
 
+:::info
+Technically you can put the widget in any package that is inside your app, but you will need to update the widget receiver name.
+:::
+
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
@@ -161,9 +165,15 @@ In `AndroidManifest.xml`, add a receiver for the widget
 
 For the receiver
 
-- `android:name` myst be `.widget.WidgetName` (same as the Java class extending `RNWidgetProvider`)
+- `android:name` (same as the Java class extending `RNWidgetProvider`)
 - `android:label` will be shown in the widget picker
 
+:::note
+`android:name` should reflect the package name of the provider, minus the package name of the app.
+
+If you put the widget provider class in a `widgets` package, the `android:name` must be `.widget.<WidgetName>`
+:::
+
 ## Add custom fonts used in widgets
 
 If we used a custom font in our widget, we must copy the font file(s) to `android/app/src/main/assets/fonts`. The `fontFamily` style prop will match the file by name.

example-expo/package.json

@@ -5,7 +5,7 @@
   "scripts": {
     "start": "expo start",
     "android": "expo start --android",
-    "build:lib": "rm -f ./react-native-android-widget* && yarn remove react-native-android-widget && rm -rf node_modules/react-native-android-widget && cd .. && yarn prepare && npm pack && pwd && mv react-native-android-widget-* ./example-expo/react-native-android-widget-$(shuf -i 10000-100000 -n1).tgz && cd example-expo && yarn add ./react-native-android-widget*",
+    "build:lib": "rm -rf node_modules/react-native-android-widget && cd .. && yarn prepare && npm pack && pwd && mv react-native-android-widget-* ./example-expo/react-native-android-widget-$(shuf -i 10000-100000 -n1).tgz && cd example-expo && yarn add ./react-native-android-widget*",
     "prebuild:dev-client": "yarn build:lib",
     "build:dev-client": "EAS_BUILD_PROFILE=development eas build --profile development --platform android",
     "prebuild:apk": "yarn build:lib",
@@ -15,18 +15,18 @@
     "@react-native-async-storage/async-storage": "^2.1.2",
     "@react-navigation/native": "^6.1.14",
     "@react-navigation/native-stack": "^6.9.22",
-    "expo": "53.0.0-preview.1",
-    "expo-dev-client": "5.1.1",
-    "expo-splash-screen": "0.30.1",
+    "expo": "53.0.9",
+    "expo-dev-client": "~5.1.8",
+    "expo-splash-screen": "~0.30.8",
     "react": "19.0.0",
-    "react-native": "~0.79.0",
-    "react-native-android-widget": "./react-native-android-widget-83316.tgz",
-    "react-native-safe-area-context": "~5.3.0",
+    "react-native": "~0.79.2",
+    "react-native-android-widget": "./react-native-android-widget-59399.tgz",
+    "react-native-safe-area-context": "~5.4.0",
     "react-native-screens": "~4.10.0"
   },
   "devDependencies": {
     "@babel/core": "^7.26.0",
-    "@types/react": "^19.0.0",
+    "@types/react": "~19.0.0",
     "typescript": "~5.8.3"
   },
   "private": true,