Skip to content
BranchesTags

Latest commit

 

History

10,987 Commits

Folders and files

NameName
Last commit message
Last commit date
.bundle
.bundle
 
 
.github
.github
 
 
.vscode
.vscode
 
 
__tests__
__tests__
 
 
android
android
 
 
app
app
 
 
ios
ios
 
 
patches
patches
 
 
referenceImages
referenceImages
 
 
.eslintrc.js
.eslintrc.js
 
 
.eslintrc.json
.eslintrc.json
 
 
.gitignore
.gitignore
 
 
.prettierrc.js
.prettierrc.js
 
 
.watchmanconfig
.watchmanconfig
 
 
App.tsx
App.tsx
 
 
CONTRIBUTING.md
CONTRIBUTING.md
 
 
ExportOptions.plist
ExportOptions.plist
 
 
ExportOptionsBabuni.plist
ExportOptionsBabuni.plist
 
 
ExportOptionsBebboPacific.plist
ExportOptionsBebboPacific.plist
 
 
ExportOptionsWawamor.plist
ExportOptionsWawamor.plist
 
 
Gemfile
Gemfile
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
app.json
app.json
 
 
babel.config.js
babel.config.js
 
 
index.js
index.js
 
 
jest.config.js
jest.config.js
 
 
metro.config.js
metro.config.js
 
 
package-lock.json
package-lock.json
 
 
package.json
package.json
 
 
react-native.config.js
react-native.config.js
 
 
readMeNewInstance.md
readMeNewInstance.md
 
 
tsconfig.babuni.json
tsconfig.babuni.json
 
 
tsconfig.bebbo.json
tsconfig.bebbo.json
 
 
tsconfig.bebboDev.json
tsconfig.bebboDev.json
 
 
tsconfig.bebboPacific.json
tsconfig.bebboPacific.json
 
 
tsconfig.foleja.json
tsconfig.foleja.json
 
 
tsconfig.json
tsconfig.json
 
 
tsconfig.merhabaBebek.json
tsconfig.merhabaBebek.json
 
 
tsconfig.reraiUmntwana.json
tsconfig.reraiUmntwana.json
 
 
tsconfig.wawamor.json
tsconfig.wawamor.json
 
 

Repository files navigation

Bebbo

Bebbo is an interactive mobile application for parenting.

Table of Contents

Introduction

Bebbo is a multi-platform mobile application available on both iOS and Android.

Discover the most comprehensive parenting and pregnancy app that provides you with all the tools and expert advice you need, all in one app, to support your journey from pregnancy through your child's growth and development from birth to age 6.

Personalize the app to access daily toddler games, parenting advice, pregnancy tips, and guidance on taking care of both your child and your own well-being. Navigate easily between multiple child profiles and receive advice tailored to each child's developmental needs.

Digital Public Good and Reusability

Bebbo is an open-source Digital Public Good designed to support reuse and adaptation by governments, UNICEF offices, implementation partners and other eligible organizations.

The mobile application uses a shared React Native codebase with instance-specific configuration for branding, localization, content, Firebase services, application identifiers and selected functionality. Multiple country and branded applications can therefore be maintained using the same core application code.

Bebbo is designed to support:

  • multi-country deployment from a shared codebase;
  • multiple languages and localized content;
  • offline access to downloaded application content;
  • instance-specific branding and configuration;
  • user-initiated export, import and backup of child-profile information; and
  • country-specific backend content delivered through the Bebbo CMS/API.

The Bebbo Mobile App and associated Bebbo CMS form part of the broader Bebbo open-source ecosystem.

Bebbo offers

  • Expert advice and parenting articles covering early learning, health, nutrition, caregiving, and safety, tailored to both your questions and your child’s age.
  • Personalized "learning through play" activities and games that support various critical areas of development, including cognition, language, motor skills, and social-emotional skills.
  • Brief instructional videos and evidence-based support for each stage of your child’s development.
  • The ability to search Bebbo’s collection of hundreds of activities and articles by topic, age, or area of development.
  • The ability to save and share favorite content.

Bebbo provides interactive tools such as

  • Development milestones tracker
  • Baby growth tracker
  • Vaccination and child immunization tracker
  • Child health check-up tracker

The app can also operate in offline mode in environments with limited internet connectivity. It is offered in several languages and is free to use. There are no internal advertisements, and content can be shared with a partner.

Technology Stack

  • React Native version 0.78.2 is used to build native mobile applications for both iOS and Android using the same codebase.
  • TypeScript is used as the primary programming language.
  • NPM is used to install third-party packages and run development scripts.
  • Firebase services are used for analytics, crash reporting and messaging.
  • The project uses React Native CLI and does not use Expo.

Refer to package.json for the complete list of dependencies.

Node and NPM versions

The project currently uses:

  • Node.js: 18 or later
  • NPM: 10.8.2
  • React Native: 0.78.2

React Native does not need to be installed globally. It is installed as a project dependency when running npm install. Use npx react-native to run the locally installed version.

Prerequisites

Before setting up the project, install the required development tools for your platform.

All platforms

  • Git
  • Node.js 18 or later
  • NPM 10.8.2

You can download Node.js from:

https://nodejs.org/en/download

Verify the installed versions:

node -v
npm -v

Expected output

v21.7.3
10.8.2

Android Development

For Android development, install:

  • Android Studio
  • Android SDK
  • Android SDK Platform 35
  • Android SDK Build-Tools 35.0.0
  • Android NDK 27.0.12077973
  • A compatible JDK version
  • Android Emulator or a physical Android device

The project configuration currently uses:

compileSdkVersion = 35
targetSdkVersion = 35
buildToolsVersion = 35.0.0
ndkVersion = 27.0.12077973

Configure ANDROID_HOME according to the React Native environment setup documentation.

Note: Android development can be performed on both Windows and macOS.

iOS Development

iOS development requires macOS.

Install:

  • Xcode
  • Xcode Command Line Tools
  • CocoaPods
  • iOS Simulator or a physical iOS device

Follow the React Native environment setup documentation for the required platform configuration.

Note: iOS applications cannot be built or run locally on Windows.

Getting Started

1. Clone the Repository

Clone the repository and move into the project directory:

git clone https://github.com/UNICEFECAR/parenting-app-bebbo-mobile.git
cd parenting-app-bebbo-mobile

When starting work on a new feature, create a branch from the Development branch:

git checkout Development
git checkout -b myFeature

2. Install Dependencies

Install the project dependencies using NPM:

npm install --legacy-peer-deps

Note: Do not install React Native globally. The required React Native version is installed locally as part of the project dependencies. Use npx react-native for React Native commands.

Do not use Yarn for this project.

3. Configure Environment Variables

Bebbo uses environment-specific configuration files.

For the Bebbo development instance, create:

env/.env.bebboDev

Example .env.bebboDev

The following example can be copied directly into `env/.env.bebboDev` to run the application locally.

The values below are dummy development values. They are provided so that the application can start without requiring access to the project's private Firebase, Facebook, Google, or encryption configuration.

apiUrlDevelop='https\://dev.bebbo.app/api'

facebookAppDisplayName=FbDisplayName
facebookAppId=000000000000000
facebookClientToken=00000000000000000000000000000000
projectNumber=000000000000
clientIdKey=00000000000000000000000000000000
webId=00000000000000000000000000000000
iosId=00000000000000000000000000000000
encryptionsKey=0000000000000000000000000000000000000000000000000000000000000000
encryptionsIVKey=00000000000000000000000000000000

Important: The values above are dummy values for local development only. Do not use them for production or any environment where real application services are required.

Dummy encryption values: The encryptionsKey and encryptionsIVKey values above are intentionally provided in the required format/length so that the application's encryption code can initialize during local development. These values are not the project's real encryption credentials.

Firebase, Google and Facebook services: The dummy Firebase/Google/Facebook values allow the application configuration to be populated, but services that depend on valid credentials will not work correctly. This includes functionality such as Firebase Analytics, Crashlytics, Firebase Messaging/push notifications, Google Sign-In/Google Drive backup, and Facebook integration.

To use these services, replace the corresponding dummy values with valid configuration values from your own development Firebase, Google and Facebook projects.

Environment variable description

Variable Description
apiUrlDevelop Development API base URL
facebookAppDisplayName Facebook application display name
facebookAppId Facebook App ID
facebookClientToken Facebook Client Token
projectNumber Firebase project number used to construct Google OAuth client IDs
clientIdKey Google OAuth iOS client ID suffix used to configure the iOS URL scheme
webId Google OAuth Web Client ID suffix used to construct the Web Client ID
iosId Google OAuth iOS Client ID suffix used to construct the iOS Client ID
encryptionsKey AES-256 encryption key used to encrypt and decrypt user backup data. A correctly formatted dummy value is provided in the example above for local development.
encryptionsIVKey Initialization vector (IV) used by the AES-256-CBC encryption process. A correctly formatted dummy value is provided in the example above for local development.

Note: clientIdKey and iosId may have the same value because both are used for the Google OAuth iOS configuration. clientIdKey is used to construct the iOS Google Sign-In URL scheme, while iosId is used to construct the iOS OAuth Client ID. Keep both values consistent with the Google OAuth configuration for the iOS application.

Security: Do not commit private production credentials, signing passwords, private keys, real encryption keys, or other secrets to the repository. The dummy values shown in this README are intentionally non-secret development placeholders.

External/Open-Source Developers

External developers can use the dummy values provided in the example above to run the application locally.

The application itself can start with these dummy values, but functionality that depends on external services will not work until the corresponding real configuration is provided.

To enable the full functionality of the application:

  • Create your own Firebase project.
  • Create your own Android and iOS applications inside the Firebase project.
  • Download the corresponding Firebase configuration files.
  • Use your own Firebase project number and application IDs.
  • Create and configure your own Facebook application if Facebook integration is required.
  • Configure Google OAuth/Google Drive credentials if Google Sign-In or Google Drive backup is required.
  • Replace the dummy encryption values with an appropriate development encryption key and IV if encrypted user backup/import data needs to be shared with another environment or existing application instance.

Note: The dummy encryption values should only be used for local development. Data encrypted with the dummy encryption key cannot be expected to be compatible with data encrypted using the project's real encryption key.

Internal Developers

Internal developers who need to use the Bebbo development configuration can request access to the project's internal configuration folder.

The folder contains the development environment files and Firebase configuration files required for the Bebbo development instance.

Access should be granted to the developer's individual account rather than sharing a common Google/Firebase account.

4. Generate Vector Images

Before running the application, generate the vector images for the required flavor:

FLAVOR=bebboDev npx react-native-vector-image generate

This command should be run whenever the vector image assets need to be regenerated.

5. Configure Firebase

Firebase is required for the application's Firebase services and analytics.

Option A: External/Open-Source Developers

For an independent development environment:

  1. Create a new Firebase project from the Firebase Console.
  2. Add an Android application to the Firebase project.
  3. Add an iOS application to the Firebase project.
  4. Use the Android package/application ID configured for your development flavor.
  5. Use the iOS bundle identifier configured for your development flavor.
  6. Download the Firebase configuration files.

Android

Download:

google-services.json

Place it in the appropriate Android flavor directory:

android/app/src/<flavor>/

For the Bebbo development flavor, use the directory configured for the prodstaging flavor in the project.

iOS

Download:

GoogleService-Info.plist

Add it to the appropriate iOS development target in Xcode.

For the existing Bebbo development configuration, the file is located under the project's iOS Firebase configuration directory.

Note: Firebase configuration is application-specific. If you create your own Firebase project, make sure the package name and iOS bundle identifier match the application configuration in this repository.

6. iOS Additional Setup

Fontello

The application uses a custom fontello.ttf font.

Copy:

android/app/src/main/assets/fonts/fontello.ttf

to:

node_modules/react-native-vector-icons/Fonts/

Refer to the React Native Vector Icons project for information about custom fonts.

Note: This font copy is required for the iOS setup. Before running the Android application, remove the copied fontello.ttf from node_modules/react-native-vector-icons/Fonts/ and regenerate the vector images using the command from the previous section.

Install CocoaPods Dependencies

From the project root:

cd ios
pod install
cd ..

If you encounter pod-related issues, see the Troubleshooting section.

7. Android Additional Setup

For a local development build, Android requires a configured development environment and Firebase configuration.

If you are an internal developer and need the Bebbo development signing configuration, obtain the appropriate development/release keystore through the project's internal configuration process.

Android Signing Configuration

The Android signing passwords are not stored in the project repository. They must be configured in the developer's local Gradle user properties file:

~/.gradle/gradle.properties

Add the required signing properties to the user's Gradle properties file. For example:

WAWAMOR_STORE_PASSWORD=<secure-value>
WAWAMOR_KEY_PASSWORD=<secure-value>

The corresponding keystore file should be available at the location configured by the project's Gradle signing configuration.

Important: Do not add keystore passwords or other private credentials to the project's android/gradle.properties file or commit them to Git.

The keystore itself should also not be committed to the public repository. Internal developers should obtain the required keystore through the project's internal configuration process.

For a new instance, the signing property names and keystore configuration must match the signing configuration defined in android/app/build.gradle.

Running Bebbo

The commands below use the existing Bebbo development flavor:

FLAVOR=bebboDev
ENVFILE=env/.env.bebboDev

The project uses custom build flavors and variants. The commands below intentionally use the configured Bebbo development build configuration.

Start Metro

Start the Metro bundler from the project root:

ENVFILE=env/.env.bebboDev FLAVOR=bebboDev npx react-native start --reset-cache

Keep Metro running in this terminal.

Open a second terminal to run the Android or iOS application.

Run Android

Make sure an Android emulator is running or an Android device is connected.

Run:

ENVFILE=env/.env.bebboDev FLAVOR=bebboDev npx react-native run-android --mode=prodstagingRelease --appId org.unicef.bebbodev

Windows

On Windows, set environment variables using set:

set ENVFILE=env/.env.bebboDev && set FLAVOR=bebboDev && npx react-native run-android --mode=prodstagingRelease --appId org.unicef.bebbodev

If the Android build fails, try cleaning Gradle:

cd android
gradlew clean
cd ..

Make sure ANDROID_HOME and JAVA_HOME are configured in the Windows environment variables.

Run iOS

Make sure an iOS Simulator is running or an iOS device is configured in Xcode.

Run:

ENVFILE=env/.env.bebboDev FLAVOR=bebboDev npx react-native run-ios --scheme ParentBuddyAppDev --mode Release

If the iOS build fails because of CocoaPods or dependency issues:

cd ios
pod install
cd ..

Generate Release Builds

Android AAB

To generate an Android App Bundle:

cd android
ENVFILE=../env/.env.bebboDev FLAVOR=bebboDev ./gradlew bundleProdstagingRelease
cd ..

The generated .aab file will be available under the appropriate directory in:

android/app/build/outputs/bundle/

Android APK

To generate an Android APK:

cd android
ENVFILE=../env/.env.bebboDev FLAVOR=bebboDev ./gradlew assembleProdstagingRelease
cd ..

The generated .apk file will be available under:

android/app/build/outputs/apk/

iOS Release Build

Run the iOS Release configuration

To run the Bebbo Dev iOS Release configuration:

ENVFILE=env/.env.bebboDev FLAVOR=bebboDev npx react-native run-ios --scheme ParentBuddyAppDev --mode Release

Create an iOS Release Build

The iOS release build can be created entirely from the command line using xcodebuild.

The project includes an ExportOptions.plist file that contains the required export configuration.

Run the following command from the project root:

ENVFILE=env/.env.bebboDev FLAVOR=bebboDev xcodebuild -workspace ios/ParentBuddyApp.xcworkspace -scheme ParentBuddyAppDev -configuration Release -sdk iphoneos -archivePath ios/build/BebboDev.xcarchive archive -allowProvisioningUpdates && xcodebuild -exportArchive -archivePath ios/build/BebboDev.xcarchive -exportOptionsPlist ExportOptions.plist -exportPath ios/build -allowProvisioningUpdates

This command performs two steps:

  1. Creates an iOS archive:

    ios/build/BebboDev.xcarchive

  2. Exports the archive using ExportOptions.plist to:

    ios/build/

The exported iOS build can then be found in the ios/build/ directory.

xcodebuild is included with Xcode and allows the iOS application to be archived and exported without manually using the Xcode UI.

The committed ExportOptions.plist is configured for the Bebbo project's release-testing build and uses automatic signing. It includes the Bebbo Apple Developer Team ID.

Developers using their own Apple Developer account or team will need to update ExportOptions.plist with their own signing configuration, including their Apple Developer Team ID where required.

The ExportOptions.plist file does not contain Apple signing certificates, private keys, or passwords. Access to the appropriate Apple Developer account and signing credentials is still required to create a signed iOS distribution build.

Creating a New Instance

Bebbo supports multiple instances/flavors using a shared codebase.

If you want to create a new Bebbo instance, for example a new country, language, or branded application, follow the dedicated:

New Instance Setup Guide

The guide covers:

  • Creating the new instance folder
  • Instance-specific configuration
  • Environment variables
  • Localization
  • Offline content
  • Assets
  • TypeScript configuration
  • iOS targets and schemes
  • iOS Firebase configuration
  • Android flavors
  • Android Firebase configuration
  • Android signing/keystore configuration
  • Build configuration
  • Running the new instance

Troubleshooting

Metro Cache Issues

If the application behaves unexpectedly after code or configuration changes, reset the Metro cache:

ENVFILE=env/.env.bebboDev FLAVOR=bebboDev npx react-native start --reset-cache

Android Gradle Issues

Clean the Android build:

cd android
./gradlew clean
cd ..

On Windows:

cd android
gradlew clean
cd ..

Then try running the application again.

iOS Pod Issues

From the project root:

cd ios
pod install
cd ..

If required, remove Pods and reinstall dependencies:

cd ios
rm -rf Pods
pod install
cd ..

Android SDK Issues

If Android Studio or Gradle cannot find the Android SDK, verify that ANDROID_HOME is configured correctly.

Also make sure the required Android SDK Platform and Build Tools versions are installed:

Android SDK Platform 35
Android SDK Build-Tools 35.0.0
Android NDK 27.0.12077973

Missing Environment File

If you receive an error related to environment variables, make sure this file exists:

env/.env.bebboDev

The environment file must contain all variables required by the application.

Firebase Configuration Issues

If Firebase services do not work:

Android

Verify that the correct:

google-services.json

has been added to the appropriate Android flavor directory.

iOS

Verify that:

GoogleService-Info.plist

has been added to the correct iOS target in Xcode.

Also verify that the package name/bundle identifier matches the Firebase application configuration.

Maintainers

The Bebbo Mobile App is actively maintained by UNICEF (United Nations Children's Fund) in collaboration with various partners. It is part of the larger Bebbo project, a digital parenting platform aimed at providing parents and caregivers with essential early childhood development resources.

Bebbo is a DPGA-recognized Digital Public Good.

For ongoing maintenance, please reach out to the following maintainers:

Community

UNICEF Bebbo has a friendly and lively open-source community.

Communication happens primarily through GitHub Discussions, and we welcome interested contributors to join the conversation.

Contributors

We acknowledge the contributors who helped improve the project:

License

Distributed under the GPL-3.0 license. See LICENSE for more information.

About

Open source parenting app supporting caregivers with early childhood development, health, nutrition, play, and responsive caregiving guidance.

bebbo.app

Topics

child-carechild-developmentdpgnurturingopen-sourceparentingparenting-app

Resources

Readme
GPL-3.0 license

Contributing

Contributing
Activity
Custom properties

Stars

15 stars

Watchers

2 watching

Forks

24 forks
Report repository

Releases

Packages

Used by

Contributors

Languages