docs(mobile-client): rewrite local setup guide

- Restructured the content into a step-by-step format
- Updated descriptions and removed redundant information
- Added new section on environment configuration
- Improved clarity and detailed explanations

Author: fulleni

src/content/docs/mobile-client/local-setup.mdx

@@ -1,68 +1,65 @@
 ---
 title: Local Setup
-description: Learn how to set up and run the Flutter mobile client on your local machine.
+description: A step-by-step guide to configuring and running the Flutter mobile client locally.
 ---
-import { Steps } from '@astrojs/starlight/components';
+import { Steps, Aside } from '@astrojs/starlight/components';
 
-This guide provides step-by-step instructions to get the Flutter mobile client running on your local machine for development and testing.
+This guide will walk you through setting up and running the Flutter News App Mobile Client on your local machine.
 
-## Prerequisites
+<Steps>
+1.  **Prerequisites**
 
-Before you begin, ensure you have the following installed on your system:
-- **Flutter SDK**: The mobile client is a Flutter application. Please follow the official [Flutter installation guide](https://flutter.dev/docs/get-started/install) for your operating system.
-- **An IDE**: A code editor like [VS Code](https://code.visualstudio.com/) with the Flutter extension or [Android Studio](https://developer.android.com/studio).
+    Before you begin, you must have the Flutter SDK installed on your system. To ensure you are using the most up-to-date and accurate installation instructions, we recommend following the official guide directly from the Flutter team.
 
-## Understanding the Environments
+    -   **Flutter SDK:** Please follow the [Official Flutter Installation Guide](https://flutter.dev/docs/get-started/install) for your specific operating system.
 
-The application can be run in three different environments, configured in `lib/main.dart`:
+2.  **Clone the Repository**
 
-- `AppEnvironment.demo`: This is the default environment. It uses an in-memory data store (`DataInMemory`) populated with mock data. This is perfect for quickly running the app and exploring the UI without needing a live backend. The app also wraps itself in the `DevicePreview` package in this mode, allowing you to see how it looks on various devices.
-- `AppEnvironment.development`: This environment is configured to connect to a local instance of the API server. It uses the `DataApi` client to make live HTTP requests.
-- `AppEnvironment.production`: This environment points to your live, deployed API server.
+    Open your terminal, navigate to your desired workspace directory, and clone the mobile client repository:
 
-You can change the active environment by modifying the `appEnvironment` constant in `lib/main.dart`:
+    ```bash
+    git clone https://github.com/flutter-news-app-full-source-code/flutter-news-app-mobile-client-full-source-code.git
+    cd apps/flutter-news-app-mobile-client-full-source-code
+    ```
 
-```dart title="lib/main.dart"
-// Define the current application environment (production/development/demo).
-const appEnvironment = AppEnvironment.demo;
-```
+3.  **Install Dependencies**
 
-## Dependency Injection
+    Fetch all the required Dart and Flutter packages for the project:
 
-The application's dependencies, such as repositories and data clients, are initialized in the `bootstrap.dart` file. This function reads the selected `AppEnvironment` and injects the appropriate data clients.
+    ```bash
+    flutter pub get
+    ```
 
-For example, in `demo` mode, it injects `AuthInmemory` and `DataInMemory` clients. In `development` or `production` mode, it sets up an `HttpClient` and injects `AuthApi` and `DataApi` clients to communicate with the backend. This clean separation makes the app highly testable and configurable.
+4.  **Configure the Environment**
 
-## Running the Application
+    The mobile client can be run in different environments, allowing you to connect it to a live API, a local API, or run it with mock data for UI development.
 
-<Steps>
-1.  **Navigate to the Project Directory**
+    -   Open the file `lib/main.dart`.
+    -   Locate the `appEnvironment` constant.
+    -   Set its value to one of the following:
+        -   `AppEnvironment.demo`: **(Recommended for UI development)** Runs the app with in-memory mock data. No backend API is required, making it perfect for focusing on UI changes and component testing.
+        -   `AppEnvironment.development`: Connects the app to a locally running instance of the API server (typically at `http://localhost:8080`).
+        -   `AppEnvironment.production`: Connects the app to your live, deployed backend API.
 
-    Open your terminal and navigate to the mobile client's root directory:
-    ```sh
-    cd apps/flutter-news-app-mobile-client-full-source-code
+    ```dart title="lib/main.dart"
+    // Use `AppEnvironment.demo` to run with in-memory data (no API needed).
+    // Use `AppEnvironment.development` to connect to a local backend API.
+    // Use `AppEnvironment.production` to connect to a live backend API.
+    const appEnvironment = AppEnvironment.demo;
     ```
 
-2.  **Get Dependencies**
+    <Aside>
+    For the `development` environment, you must have the [API Server running locally](/docs/api-server/local-setup/) first.
+    </Aside>
 
-    Run the following command to fetch all the required packages from `pubspec.yaml`:
-    ```sh
-    flutter pub get
-    ```
+5.  **Run the Application**
 
-3.  **Select a Device**
+    Start the Flutter development server. Ensure you have a simulator/emulator running or a physical device connected.
 
-    Ensure you have a simulator running (iOS) or an emulator running (Android), or a physical device connected. You can see a list of available devices with:
-    ```sh
-    flutter devices
+    ```bash
+    flutter run
     ```
 
-4.  **Run the App**
+    The application will now be running on your selected device.
 
-    Start the application using the `flutter run` command. By default, this will launch the app in `demo` mode.
-    ```sh
-    flutter run
-    ```
 </Steps>
-
-The application should now be running on your selected device. Because it's in `demo` mode, you can immediately start exploring the UI and features with the pre-loaded mock data.