• Features
  • Contact business
  • Customer profile
  • Notifications
  • Business opening hours
• Requirements
  • Project
  • Firebase
    • Authentication
    • Firestore
• Built with
• Credits
• Companion app

The contact with the business was never been easier. Just choose one of the provided contact methods:

• Calling
• Navigation
• Open Facebook page
• Chat on Facebook Messenger
• Open Instagram page

^{All operations handled by external apps through Intents}

Let your customers create a profile and provide you with contact information.

^{Customer must first verify their email in order to proceed}

Customers will receive push notifications with FCM for important updates that you sent.

Provide your opening hours to your customers.

^{(back to top)}

To build the project you must provide:

• a google-services.json file in the root project* folder. You can retrieve it from "Project Settings" at Firbase console

• a .jks file in order to sign the release build

• a keystore.properties file with the following structure:

storePassword = <Keystore password>

keyPassword = <Signing key password>

keyAlias = <Key alias>

storeFile = <Path to the .jks file>

Those fields corresponds to properties at module level build.gradle** file.

You need both .jks and keystore.properties files in order to sign the release build.

^{* Be sure to check the official Firebase documentation}

^{** keystore.properties file's path should also be changed inside build.gradle if the file is not located at project's root}

• a fb_secrets.xml which will include the following strings:

<string  name="facebook_app_id_secret"  translatable="false">your_app_id</string>

<string  name="fb_login_protocol_scheme_secret"  translatable="false">fbyour_app_id</string>

<string  name="facebook_client_token_secret"  translatable="false">your_client_token</string>

^{Be sure to check the official Facebook Login Android documentation}

• a googleApi.properties file with the following structure:

webClientId = "<your_web_client_id>"

You can find your web client ID from Google API console, navigating to the "Credentials" tab. This key is needed for Google One Tap sign-in.

^{(back to top)}

In order for the app to work without any modifications you must enable the following sign-in methods from Firebase console:

• Email/Password

• Google

• Facebook*

^{* Facebook sign-in method must be enabled in order to link user's email or Google account with their Facebook one. It is not used for authentication.}

You must provide the following database structure to provide the businesses' opening hours and social information:

firestore {

	business_info {

		<business_name> {

			opening_hours: array {

				morning: map {

					from: string

					to: String

				}

				afternoon: map {

					from: string

					to: string

				}

				order: number

			}

			social_info: map {

				fbPageName: string

				fbPageUniqueName: string

				fb_page_id: string

				instagram_profile: string

				mapsCoordinates: string

				mapsName: string

				maps_query: string

				phone: string

			}

		}

	}

}

^{(back to top)}

Here is a brief summary of what technologies have been used for the app:

• Firebase for authentication and storage
• Coroutines
• FCM for push notifications
• Retrofit and Moshi to communicate with the FCM API
• Google Sign-In for Android for Google One Tap sign-in
• Navigation component
• Coil to load profile image

This software uses the following open source packages:

• Retrofit
• Moshi
• Coil
• FirebaseUI for Android
• CircleImageView

The administration app is available on the APPointment Admin repo

^{(back to top)}