App Settings
App Requirements
Download and install Any one from these IDE(Android studio, Vs Code) on your computer.
-
Source Android Studio:https://developer.android.com/studio
-
Source VS Code:https://code.visualstudio.com/download
Setup Flutter and Dart SDK in your computer if you want to modify the source code
Must installed Flutter and dart plugin on your IDE
Installation
After downloading the file, you will receive a ZIP archive. Once you extract it, you will find
Documentation Folder and
User App
»
servat-user-app-flutter.zip
included in there:
- Unzip the source code and open it in your IDE.
- On your IDE find for
pubspecs.yamlfile then Run flutter pub get command on your IDE terminal or click the "Pub get" button (usually visible at the top-right in Android Studio) - Open an emulator or connect a real device and then click on Run Button for compile the project.
Folder Structure
All you need to follow the lib(Library) Folder for any logical and UI changes in this project.
-
App Folder »Contains MyApp widget configuration and root app setup.
-
Controller Folder »Handles business logic and state management using GetX (Auth, Profile, Service, Job Post, Booking, Deposit, Withdraw, Conversation, etc.).
-
Core Folder »Contains app initializer and core setup logic.
-
Data Folder »Manages API calls, data models, repositories, and static data sources.
-
Notification Service Folder »Handles push notifications via Flutter Local Notifications and Pusher.
-
Res Folder »Includes app colors, constants (BASE_URL, API endpoints), extensions, routes, and themes.
-
Utils Folder »Provides helper functions, logging, validation, and utility methods.
-
View Folder »Contains all application screens (23 screen modules) and reusable UI widgets.
Screens
-
Splash Screen
-
Onboarding Screen
-
Sign In Screen
-
Sign Up Screen
-
Forgot Password Screen
-
Home Screen (with Zoom Drawer)
-
Drawer Screen
-
Profile Settings Screen
-
Edit Profile Screen
-
Change Password Screen
-
2FA Security Screen
-
Verify Screen (Email/SMS)
-
Delete Account Screen
-
Transaction Screen
-
Service List Screen
-
Service Details Screen
-
Service Booking Screen
-
Category Screen
-
Service Provider (Author) Screen
-
My Bookings Screen
-
Job Post Screen (Create/Update)
-
Job Details Screen
-
Job Offer List Screen
-
Wishlist Screen
-
Inbox / Conversation Screen
-
Notification Screen
-
Address Management Screen
-
Deposit (Add Fund) Screen
-
Withdraw (Payout) Screen
-
Support Ticket Screen
-
Success Screen
Setup Application
Change App Primary color Open :
lib
-
res
-
Colors
- app_colors.dart
-
Change App Base_Url: Open :
lib
-
res
-
constants
- app_constants.dart
-
Google Map Setup:
- Create a Google Cloud project.
- Enable Maps SDK for Android.
- Enable Maps SDK for iOS.
- Create the required API keys.
- Restrict the Android API key to the appropriate app/package.
- Restrict the iOS API key to the appropriate Bundle ID.
- Configure the API keys in the project.
- Run the application and verify that the map screen works correctly.
-
Full documentation:https://developers.google.com/maps/flutter-package/config
Env Configuration:
-
Copy
.env.exampleto.env. - Add your own API credentials.
- Never use credentials from the demo or developer environment.
- Restart the application after updating the configuration.
Facebook Setup:
- Create a Facebook Developer App.
- Configure Facebook Login.
- Add the Android package name.
- Configure the required Android credentials and hash.
- Configure the iOS Bundle ID.
- Add the required Facebook configuration.
- Connect Facebook authentication with Firebase Authentication.
- Test Facebook Login.
-
Full documentation:https://facebook.meedu.app/docs/7.x.x/intro
-
For change the app name please follow:https://pub.dev/packages/rename_app
-
For change the app icon please follow:https://pub.dev/packages/flutter_launcher_icons
-
For change the app package name please follow:https://pub.dev/packages/change_app_package_name
Firebase Setup in Flutter app
To set up Firebase in your Flutter app, please follow the official documentation carefully:
- Create a Firebase project.
- Add the Android app using your package name.
- Add the iOS app using your Bundle ID.
-
Enable Authentication providers:
- Other providers used by Servat
- Configure the required SHA-1/SHA-256 credentials for Android.
-
Download
google-services.jsonand place it in:android/app/google-services.json - Install and configure FlutterFire CLI.
-
Run the following command:
flutterfire configure -
This will generate:
firebase_options.dart - Run the application and verify authentication.
Or, you can follow the official documentation below.
android
-
app
-
- google-services.json
-
Publish App
1. Android
Follow the guidelines publish the app to Play Store.
-
PlayStore:https://flutter.dev/docs/deployment/android
2. IOS
Follow the guidelines publish the app to AppStore.
-
AppStore:https://flutter.dev/docs/deployment/ios
Third-Party Services Setup
Important Third-Party Services and Additional Costs
Servat integrates with external services, including Google Maps, Agora RTC, Pusher Channels, SMS gateways, and AI service providers. These services are not included in the item purchase price.
Buyers must create and configure their own accounts, API keys, credentials, and billing methods for these services. Usage, subscription, messaging, calling, mapping, or AI processing fees may be charged separately by the respective third-party providers.
1. Google Maps Setup
- Go to the Google Cloud Console and create a project.
- Enable Maps SDK for Android and Maps SDK for iOS, along with Places API and Geocoding API.
- Create API Keys and restrict them to your Android Package Name (with SHA-1) and iOS Bundle Identifier.
- Add the API keys into your
.envfile underGOOGLE_MAPS_ANDROID_API_KEYandGOOGLE_MAPS_IOS_API_KEY. - Ensure the key is also added in
android/app/src/main/AndroidManifest.xmlundercom.google.android.geo.API_KEY. - Ensure the key is also added in
ios/Runner/AppDelegate.swiftunderGMSServices.provideAPIKey("YOUR_KEY_HERE").
2. Agora RTC Voice Calling Setup
- Sign up or log in to the Agora Console.
- Navigate to Project Management and click Create to start a new project.
- Select Testing Mode: App ID + Token (recommended for production security).
- Copy your App ID and App Certificate from the project dashboard.
- Configure the Agora credentials in your backend admin panel under Calling / Agora Settings or in your environment variables.
- The backend dynamically generates temporary RTC tokens for authenticated users and providers during active call sessions.
3. Pusher Real-Time WebSocket Setup
- Create an account on Pusher.com and create a Channels app.
- Note your
app_id,key,secret, andcluster. - Configure these credentials in your backend admin panel under Pusher Configuration. The Flutter app automatically fetches Pusher configuration at bootstrap via
/api/app-config.
4. Facebook Login Setup
- Create an App on Meta for Developers.
- Add and configure Facebook Login product.
- Add your Android Package Name and Key Hash (Release and Debug SHA-1 hashes converted to base64).
- Add your iOS Bundle ID and configure URL Schemes in Xcode
Info.plist.