Cariera

Getting Started

First of all I would like to thank you for purchasing Cariera Flutter App!

Cariera is a Flutter App converted from the Cariera - WordPress Theme. If you own a website that uses the Cariera theme you can easily connect your website with the Cariera App and publish the app on both Play Store and App Store.

Requirements

You need Cariera - Job Board WordPress Theme in order for the app to be able to pull your websites data and showcase them.

Cariera: 1.6.2 or higher
WP Job Manager: 1.35.0 or higher
Flutter: 3.7.0 support

Theme Setup

Note

First make sure you are using Cariera - WordPress Theme version 1.6.2 or higher in order to have a full integration between the theme and app.

JWT plugin Configuration

First you need to install and activate the plugin JWT Auth – WordPress JSON Web Token Authentication.

The JWT needs a secret key to sign the token. This secret key must be unique and never be revealed.

Add the line from below into your wp-config.php file

                                                        
                                                            define('JWT_AUTH_SECRET_KEY', 'your-top-secret-key');

Replace your-top-secret-key with a string generated from here.

Configurate CORS Supported

To enable the CORs Support edit your wp-config.php file and add a new constant called JWT_AUTH_CORS_ENABLE

                                                        
                                                            define('JWT_AUTH_CORS_ENABLE', true);

More details about how to configure JWT Auth can be found in the plugin's page.

Activate Theme & Mobile app Integration

Go to WP DashboardCarieraSettingsGeneral and activate the option Mobile App Integration.

How to setup Flutter

You can visit Flutter's official website for a full installation guide: Flutter Official website

We also recommend this video tutorial playlist to help you with the full installation process: YouTube Playlist

How to run this project

Unzip the downloaded code, after unzipping you will have Cariera - Flutter folder. You can now open it in Android Studio or Visual Studio Code.
Open ide terminal and execute flutter pub get command.
If you are running this app for ios then run these following commands in terminal.

                                                                                                                    
                                                            cd ios
                                                            pod install
                                                            cd..

open terminal and execute flutter run

Run an existing flutter project on IDE

Change App Logo

Go to project > assets > images and replace icon.png with your own logo.
Go to project > assets > images & replace logo.png with your company name image.
Then go to android > app > src > main > res and replace all mipmap folder with your generated icon android folder.
Go to ios > Runner & replace Assets.xcassets with your generated Assets.xcassets folder.

Change App Name

You need to set your app name in three different place. Open project libutilsconstrants.dart

                                                            static const String appName = ‘My App’;

                                                        

Change the value of label from project androidapp srcmainAndroidManifest.xml

                                                             android:label="My App"

                                                        

Change the value of CFBundleName from project iOSRunner info.plist

                                                             <key>CFBundleName</key>
 <string>My App</string>

Change App Color

You need to set your color in different place. Open project libutilscolors.dart

Change Primary Color

                                                                                                                            const Color primary  = Color(0xFFYOUR_COLOR_CODE);

Change Secondary Color

                                                                                                                            
                                                                    const Color onPrimary  = Color(0xFFYOUR_COLOR_CODE);

Change AppBar Color

                                                                                                                            
                                                                    const Color appBarBG  = Color(0xFFYOUR_COLOR_CODE);

Change Screen Background Color

                                                                                                                            
                                                                    const Color bg  = Color(0xFFYOUR_COLOR_CODE);

Change Font Style

Get That Font: If you haven’t received the font from your designer, you can simply download it from the here → https://fonts.google.com/

Import the Font into Project: Create one more directory inside the assets called fonts & Copy-Paste [font].ttf file into the fonts folder

Add Font to Pubspec.yaml: Uncomment & Replace the family name with your font family. To get the family name, simply take the first part before the dash sign (-). For example, if the downloaded font name is OoohBaby-Regular, take the OoohBaby as your family name.

Changing Font at App Level: Go to your main.dart file. Inside the MaterialApp, find the ThemeData widget. Add the fontFamily property and assign your new font family name.

Change App Messages

You can set Currency, Currency position & Messages. Open project libutils constants.dart

Change Currency

                                                        static constString defaultCurrency  = '\YOUR_CURRENCY_SYMBOL';

                                                    

Change Currency Position

                                                        static constString isCurrencyLogoLeft  = true OR false;

                                                    

Change Static Messages

Change Base URL

Please make sure to not add a slash(/) at the end of your base url. You should use your website url (home) as base url. For example: If your website url is https://cariera.co/ then base url will be https://cariera.co. Open libutils constants.dart and replace baseURL variable value with your own URL.

                                            static const String baseURL = 'https://your_domain.com';

                                        

Change App Package

First you have to find out the existing package name. You can find it out from top of appsrc mainAndroidManifest.xml file. Now right click on project folder from android studio and click on replace in path. You will get a popup window with two input box. In first box you have to put existing package name that you saw in AndroidManifest.xml file previously and write down your preferred package name in second box and then click on Replace All button.

Add Google Map API Key

You need to generate the google API key. Visit this link - https://developers.google.com/maps/documentation/embed/get-api-key
You need to enabled mentioned APIs: Maps SDK for Android, Maps SDK for iOS.
After generating API key, you have to put it on 2 different place for Android, iOS.

Android Map API key

IOS Map API key

Package, Bundler & Version

Change package name for android app & execute the following command in your terminal

                                                            flutter pub run change_app_package_name:main your_new_package_name

Change package name for ios app & open ios folder of this project in xcode. Go Select RunnerTargets General Identity and enter new package name in Build Identifier.

Update app version

Open the pubspec.yaml file.
Locate the version tag.
Update the build name and number such as version: 1.0.2+2
Open the terminal and hit the flutter clean command.
Build the app.

How to build Android & IOS App

Android App

For full build guide you can visit Flutter's official website: Flutter website

Video Tutorial:

IOS App