chore: docs and jest config

Author: wonderlul

.eslintignore

@@ -5,7 +5,7 @@ docs/build/
 docs/public/
 docs/static/
 web-build/
-testSetup.js
+jest/testSetup.js
 __fixtures__/
 
 # generated by bob

docs/docs/guides/01-getting-started.md docs/docs/guides/01-getting-started.mdxdocs/docs/guides/01-getting-started.md renamed to docs/docs/guides/01-getting-started.mdx

@@ -2,37 +2,60 @@
 title: Getting Started
 ---
 
+import TabItem from '@theme/TabItem';
+import Tabs from '@theme/Tabs';
+
 # Getting Started
 
 ## Installation
 
-- Open a Terminal in your project's folder and run:
+Open a Terminal in your project's folder and install the library:
+
+<Tabs groupId="expo-vs-cli">
+  <TabItem value="expo" label="Expo" default>
+
+```bash
+npx expo install react-native-paper
+```
+
+  </TabItem>
+  <TabItem value="community-cli" label="Community CLI">
 
 ```bash npm2yarn
 npm install react-native-paper
 ```
 
-- From `v5` there is a need to install [react-native-safe-area-context](https://github.com/th3rdwave/react-native-safe-area-context) for handling safe area.
+  </TabItem>
+</Tabs>
 
-```bash npm2yarn
-npm install react-native-safe-area-context
+React Native Paper uses [react-native-safe-area-context](https://github.com/th3rdwave/react-native-safe-area-context) for handling safe area, [react-native-reanimated](https://docs.swmansion.com/react-native-reanimated/) and [react-native-worklets](https://docs.swmansion.com/react-native-worklets/) for animations.
+
+<Tabs groupId="expo-vs-cli">
+  <TabItem value="expo" label="Expo" default>
+
+```bash
+npx expo install react-native-safe-area-context react-native-reanimated react-native-worklets
 ```
 
-- You also need to install [react-native-reanimated](https://docs.swmansion.com/react-native-reanimated/) and [react-native-worklets](https://docs.swmansion.com/react-native-worklets/) for animations.
+  </TabItem>
+  <TabItem value="community-cli" label="Community CLI">
 
 ```bash npm2yarn
-npm install react-native-reanimated react-native-worklets
+npm install react-native-safe-area-context react-native-reanimated react-native-worklets
 ```
 
-- Follow the [React Native Reanimated installation guide](https://docs.swmansion.com/react-native-reanimated/docs/fundamentals/getting-started/) for your toolchain (Expo vs React Native Community CLI). **Community CLI** setups must add `'react-native-worklets/plugin'` **last** in your `babel.config.js` `plugins` array. **Expo** setups follow that guide’s Expo steps (install packages and rebuild native code); starter templates [since Expo SDK 50](https://expo.dev/changelog/2024/01-18-sdk-50) usually include the Worklets Babel plugin already—add it only if your `babel.config.js` does not. Paper declares **minimum** supported versions for `react-native-reanimated` and `react-native-worklets` under `peerDependencies` in [`package.json`](https://github.com/callstack/react-native-paper/blob/main/package.json) (`>=` ranges, not pinned versions). When troubleshooting animation or native build problems, confirm your installed packages meet those minimums.
+  </TabItem>
+</Tabs>
 
-Additionaly for `iOS` platform there is a requirement to link the native parts of the library:
+Follow the [React Native Reanimated installation guide](https://docs.swmansion.com/react-native-reanimated/docs/fundamentals/getting-started/).
 
-```bash
-npx pod-install
-```
+Minimum requirements:
+
+- `react-native-reanimated` **≥ 4.3.0**
+- `react-native-worklets` **≥ 0.8.1**
+- `react-native-safe-area-context` — version compatible with your React Native toolchain.
 
-- If you're on a vanilla React Native project, you also need to install and link [@react-native-vector-icons/material-design-icons](https://github.com/oblador/react-native-vector-icons).
+If you're on a vanilla React Native project, you also need to install and link [@react-native-vector-icons/material-design-icons](https://github.com/oblador/react-native-vector-icons).
 
 Specifically `MaterialDesignIcons` icon pack needs to be included in the project, because some components use those internally (e.g. `AppBar.BackAction` on Android).
 

docs/docs/guides/03-icons.mdx

@@ -10,7 +10,7 @@ import IconsList from '@site/src/components/IconsList.tsx';
 
 ## Configuring icons
 
-Many of the components require the [react-native-vector-icons](https://github.com/oblador/react-native-vector-icons) library to render correctly. If you're using Expo, you don't need to do anything extra, but if it's a vanilla React Native project, you need to link the library as described in the [getting started guide](./01-getting-started.md).
+Many of the components require the [react-native-vector-icons](https://github.com/oblador/react-native-vector-icons) library to render correctly. If you're using Expo, you don't need to do anything extra, but if it's a vanilla React Native project, you need to link the library as described in the [getting started guide](./01-getting-started.mdx).
 
 :::note
 If you opted out of vector icons support using [babel-plugin-optional-require](https://github.com/satya164/babel-plugin-optional-require), you won't be able to use icon names for the icon prop. Some components may not look correct without vector icons and might need extra configuration.

jestSetupAfterEnv.js jest/jestSetupAfterEnv.jsjestSetupAfterEnv.js renamed to jest/jestSetupAfterEnv.js

@@ -132,4 +132,4 @@ jest.mock('react-native/Libraries/Utilities/BackHandler', () => {
       },
     },
   };
-});
+});

testSetup.js jest/testSetup.jstestSetup.js renamed to jest/testSetup.js

@@ -120,10 +120,10 @@
   "jest": {
     "preset": "react-native",
     "setupFiles": [
-      "<rootDir>/testSetup.js"
+      "<rootDir>/jest/testSetup.js"
     ],
     "setupFilesAfterEnv": [
-      "<rootDir>/jestSetupAfterEnv.js",
+      "<rootDir>/jest/jestSetupAfterEnv.js",
       "@testing-library/jest-native/extend-expect"
     ],
     "cacheDirectory": "./cache/jest",