# Installation

{% hint style="info" %} <i class="fa-bullhorn">:bullhorn:</i> NOTE :\
Before launching the app, ensure you have correctly set up the ADMIN LARAVEL and have added all necessary data through the admin panel.
{% endhint %}

\
If React Native isn’t yet installed on your system, follow this link to get started: <https://reactnative.dev/docs/set-up-your-environment>

### **1. SDK Version :**

***

To integrate Taxido into your project, you'll need to make the following adjustments :

React Native (v0.82.1)

1. You need React Native v0.82.1 (Stable Channel)<br>
2. To install React Native, follow the instructions at the <https://reactnative.dev/docs/set-up-your-environment> (Windows, macOS, etc.) provided at the link below.<https://reactnative.dev/docs/set-up-your-environment><br>

### **2. React Native Installation :**

* <mark style="color:$success;">**Install React Native CLI :**</mark>

  * Install React Native CLI globally :

  ```html
  npm install -g react-native-cli
  ```

  <i class="fa-files-o">:files-o:</i>
* <mark style="color:$success;">**Create a New React Native Project :**</mark><br>
* &#x20;Create a new project :

```html
npx react-native init YourProjectName
```

* <mark style="color:$success;">**Navigate to the Project Folder :**</mark><br>

  ```html
  cd YourProjectName
  ```

  <i class="fa-files-o">:files-o:</i>

* <mark style="color:$success;">**Install Dependencies :**</mark><br>

  * Install Android required libraries :

  ```html
  npm install. or npm install --legacy-peer-deps
  ```

  <i class="fa-files-o">:files-o:</i>

  * Install iOS required libraries :

  ```html
  yarn install
  ```

* <mark style="color:$success;">**Run the Project :**</mark><br>

  * To run the app on Android :

  ```html
  npx react-native run-android
  ```

  <i class="fa-files-o">:files-o:</i><br>

  * To run the app on Android in debug mode:&#x20;

  ```html
  cd android
  ./gradlew assembleRelease
  ```

  <i class="fa-files-o">:files-o:</i><br>

  * To run the app on iOS (macOS only) :

  ```html
  npx react-native run-ios
  ```

  <i class="fa-files-o">:files-o:</i>

  * For iOS, make sure to run:

  ```html
  cd ios && pod install
  ```

### 3. React Native **Installation in Visual Studio:**

* Start Visual Studio and install the required dependencies, including Windows Desktop Development and C++ Desktop Development tools, for React Native development.<br>
* After completing the installation, ensure that you have Visual Studio configured for React Native development.<br>
* Verify Dependencies: Use the following command in your terminal to see if your React Native configuration is missing any dependencies :<br>

  ```html
  npx react-native doctor
  ```

  <i class="fa-files-o">:files-o:</i>

### 4. Re**act Native Installation in Android Studio :**<br>

* Start Android Studio, then install the required apps, such as the Android SDK and Android Emulator.<br>

* After installation, you may run and debug your React Native application on an emulator or connected device using Android Studio.

* Verify Dependencies: After setting up Android Studio, you can check for any missing dependencies by running the following command :

```html
npx react-native doctor
```

### **5. React Native Dependencies Setup (Node.js, NPM, and CLI):**

#### <mark style="color:red;">**Note: Use the instructions below to set up Node.js or other dependencies for React Native.**</mark>

### <mark style="color:$success;">**1. Windows Setup:**</mark>

1. **Open Command Prompt:**\
   &#x20;  &#x20;
   * Press `Windows Key + R`, type cmd, and press Enter.<br>

2. **Install Node.js (LTS) using Chocolatey**<br>

   * If Chocolatey is installed, run:<br>

     ```html
     choco install nodejs-lts
     ```

   * If Chocolatey is not installed, download and install Node.js LTS manually from the official [Node.js website](https://nodejs.org/en).

3. **Verify Installation**

   * Run the following commands to check the installed versions:<br>
   * The command above will return the installed version of Node.js. For React Native, it is recommended to use **Node.js 22x or Above** for compatibility.<br>

     ```html
     node -v
     ```

     ```html
     npm -v
     ```

     <br>

4. **Install Node Version Manager (nvm) for Window**<br>
   * Download the [nvm-setup.zip](https://github.com/coreybutler/nvm-windows/releases) file from the official GitHub repository.<br>
   * Run the `nvm-setup.exe` to install `nvm` on your system.

     <br>

5. **Ve**rify nvm Installation:<br>

   * Run the following command to verify the nvm installation:<br>

   ```html
   nvm -v
   ```

6. **Add and Install a Specific Node.js Version using nvm:**<br>

   * To install a specific version of Node.js (e.g., Node.js 22.11.0), run the following command:<br>

   ```html
   nvm install 0.39.3
   ```

   * Replace `18.0.0` with your desired version number.<br>

   * Once the installation is complete, use the following command to switch to the newly installed version:<br>

     ```html
     nvm install 0.39.3
     ```

   * Verify that the correct version of Node.js is active by running:<br>

     ```html
     node -v
     ```

     <br>

### <mark style="color:$success;">**2. Linux Setup (Ubuntu/Debian-based distros)**</mark>

1. **Update Package List**

   * Open a terminal and run:

   ```html
   sudo apt-get update

   ```

2. **Install Node.js and npm**

   * Run the command :

   ```html
   sudo apt-get install -y nodejs npm
   ```

3. **Verify Installation**

   * Check the installed versions&#x20;

   ```html
   node -v
   ```

```html
npm -v
```

### <mark style="color:$success;">**3. macOS Setup**</mark>

1. **Install Node.js and npm using Homebrew**

   * Open Terminal and run :

   ```html
   brew install node
   ```

2. **Verify Installation**<br>

   * Check the installed versions :<br>

     ```html
     node -v
     ```

   ```html
   npm -v
   ```

#### Install React Native CLI & Setup a New Project

1. Create a New React Native Project (Without Expo)

   * Run the command :<br>

     ```html
     npx react-native init MyProject
     ```

   * This ensures you always use the latest React Native CLI.<br>
2. Navigate to the Project Directory\
   &#x20;

   * Change into the newly created project folder :<br>

     ```html
     cd MyProject
     ```

* Running the React Native App\
  &#x20;&#x20;

  * For Android Run :<br>

    ```html
    npx react-native run-android
    ```

  * To run the app on Android in debug mode:&#x20;

  ```html
  cd android
  ./gradlew assembleRelease
  ```

  <i class="fa-files-o">:files-o:</i>

  * Important Notes<br>
    * React Native CLI is built into `npx`, so you don’t need to install it globally.
    * Ensure`Java JDK & Android SDK` are installed for Android development.

  <br>
