Permissions

BooApps use a permission system to control access to native device features. Each permission group grants access to specific Bridge API actions.

How Permissions Work

  1. Declare required permissions in your booapp.json
  2. Users see the permissions list before installing your BooApp
  3. The Peqaboo runtime enforces permissions — undeclared actions will fail
  4. Request only the permissions you actually need
booapp.json
json
{
  "permissions": ["auth", "pet_info", "camera", "location"]
}

Permission Groups

Best Practices

Minimal Permissions

Only request the permissions your app truly needs. Apps with fewer permissions get better conversion rates as users are more willing to install them.

High Sensitivity Permissions

Permissions marked as "high" sensitivity (camera, location, biometrics, user_info) receive extra scrutiny during the review process. Be prepared to justify why your app needs them.

Common Permission Combinations

Basic App

Simple utility with data storage

["auth", "storage", "ui_dialogs"]

Pet-Focused App

Apps that read pet data

["auth", "pet_info", "storage", "ui_dialogs"]

Photo App

Camera and photo gallery access

["auth", "pet_info", "camera", "gallery", "storage", "ui_dialogs"]

Social App

User profiles and sharing

["auth", "user_info", "pet_info", "share", "storage", "ui_dialogs"]

Location App

GPS and map features

["auth", "pet_info", "location", "storage", "ui_dialogs", "navigation"]