Skip to content

Commit c3a23aa

Browse files
committed
docs(mobile-client): update deployment guide for clarity and focus
- Refocus the guide on project-specific configuration - Highlight the official Flutter documentation as the authoritative resource for deployment - Simplify the structure and language for better readability - Remove duplicate resources section at the end
1 parent 60cad29 commit c3a23aa

File tree

1 file changed

+16
-32
lines changed

1 file changed

+16
-32
lines changed

src/content/docs/mobile-client/deployment.mdx

Lines changed: 16 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -4,20 +4,18 @@ description: A guide to building and deploying the Flutter mobile app for Androi
44
---
55
import { Steps, Aside } from '@astrojs/starlight/components';
66

7-
This guide provides a high-level overview of the tasks required to build and deploy the Flutter News App Mobile Client to the Google Play Store and Apple App Store.
7+
This guide outlines the process for deploying the Flutter News App Mobile Client to the Google Play Store and Apple App Store.
88

9-
For detailed, step-by-step instructions, this guide will link to the official Flutter and platform documentation. These are the definitive resources and are always kept up-to-date.
9+
<Aside>
10+
To ensure you have the most reliable and up-to-date instructions, this guide focuses on the project-specific configuration you need to complete. For the deployment itself, we will refer you to the official Flutter documentation, which is the definitive resource for releasing mobile applications.
11+
</Aside>
1012

11-
### Prerequisites
13+
### Pre-Deployment Configuration
1214

13-
Before you begin, you will need active developer accounts for the platforms you are targeting:
14-
- **Google Play Console:** [developer.android.com/distribute](https://developer.android.com/distribute)
15-
- **Apple Developer Program:** [developer.apple.com/programs](https://developer.apple.com/programs/)
15+
Before you can build the app for production, you must configure it to connect to your live API server.
1616

1717
<Steps>
18-
1. **Configure for Production**
19-
20-
First, ensure the app is configured to connect to your live production API.
18+
1. **Set the Production Environment**
2119

2220
- Open the file `lib/main.dart`.
2321
- Locate the `appEnvironment` constant.
@@ -28,32 +26,18 @@ Before you begin, you will need active developer accounts for the platforms you
2826
const appEnvironment = AppEnvironment.production;
2927
```
3028

31-
<Aside>
32-
Ensure that the `baseUrl` for the `production` environment in `lib/app/config/app_config.dart` points to the correct URL of your deployed [API Server](/docs/api-server/deployment/).
33-
</Aside>
34-
35-
2. **Follow the Official Flutter Deployment Guides**
36-
37-
The Flutter team provides comprehensive guides that cover every aspect of building and releasing your application. Please follow the official guide for each platform you intend to deploy to.
29+
2. **Verify the API Base URL**
3830

39-
#### **Android (Google Play Store)**
31+
- Open the file `lib/app/config/app_config.dart`.
32+
- Ensure that the `baseUrl` for the `production` case points to the correct URL of your deployed [API Server](/docs/api-server/deployment/).
4033

41-
The official guide covers essential steps including:
42-
- Updating the Package ID (`applicationId`).
43-
- Generating app icons.
44-
- Creating an upload keystore and configuring app signing.
45-
- Building the app bundle (`.aab`) for release.
46-
47-
**[Official Guide: Build and release an Android app](https://docs.flutter.dev/deployment/android)**
34+
</Steps>
4835

49-
#### **iOS (Apple App Store)**
36+
### Building and Releasing
5037

51-
The official guide covers essential steps including:
52-
- Updating the Bundle Identifier and Display Name in Xcode.
53-
- Generating the app icon set.
54-
- Configuring app signing with your Apple Developer account.
55-
- Building the release archive (`.ipa`) for upload.
38+
Once your configuration is ready, you can proceed with building and releasing the application. The official Flutter documentation provides comprehensive, platform-specific guides that cover every required step, from generating app icons to configuring code signing and uploading to the stores.
5639

57-
**[Official Guide: Build and release an iOS app](https://docs.flutter.dev/deployment/ios)**
40+
Following these official guides is the recommended and most reliable path to a successful release.
5841

59-
</Steps>
42+
- **[Official Guide: Build and release an Android app](https://docs.flutter.dev/deployment/android)**
43+
- **[Official Guide: Build and release an iOS app](https://docs.flutter.dev/deployment/ios)**

0 commit comments

Comments
 (0)