Skip to main content

Content Filtering & Safety Policies

The Fami Hero safety engine screens web requests, search queries, and device content to block inappropriate material. As an administrator, you configure global web filtering categories, manage preset domain blacklists, and control local keyword dictionaries.

🔍 1. On-Device Search & Text Filtering​

Rather than relying on intrusive network-level proxy redirection, Fami Hero achieves high-performance web and search safety locally on the child's device using OS-native features and efficient scanning algorithms:

  1. On-Device Keyword Matching: The child application downloads a centralized keyword dictionary from the backend and performs real-time scans on search queries and on-screen text using the high-performance Aho-Corasick multi-pattern search algorithm.
  2. Suspicious Keyword Flagging: When a child searches for or encounters explicit, drug-related, cyberbullying, or dangerous terms, the match is locally detected, logged, and immediately synced to the parent's app via Realtime Database (RTDB) and Firebase Cloud Messaging (FCM) alerts.
  3. OS-Native App & Category Blocking: The system maps applications to categories (such as Social Media, Games, Entertainment) and enforces strict category-wide daily limits or complete blocks directly using native platform frameworks (Apple's Screen Time API and Android's UsageStats / service overlays).

Admin Portal: Configuring SafeSearch and App Categories Caption: Global web categorization settings in the Content Filtering page.

🚫 2. Global Domain Blacklists & Whitelists​

Administrators curate the global domain database within the Admin Web Panel, which is automatically synchronized to children's devices through Firebase Realtime Database:

Global Preset Categories & Blacklists​

  • Purpose: Block massive lists of inappropriate sites by default.
  • Adding a Domain: Tap a category (e.g., Adult Content, Gambling, Violence), click Add Domain, enter the address (e.g., inappropriatesite.com), and click Confirm.
  • Wildcards & Subdomain Matching: The native OS frameworks (such as iOS's ManagedSettingsStore.webContent) automatically enforce subdomain matching (e.g., blocking inappropriatesite.com automatically restricts www.inappropriatesite.com or play.inappropriatesite.com).

Admin Portal: Custom Domain Blacklist and Whitelist Rules Caption: Domain management controls within the Web Admin Portal.

Parent-Controlled Whitelists & Blacklists​

  • Purpose: Allow parents to override global settings locally for their specific family needs (e.g., allowing a school-approved site that would otherwise be blocked, or blocking a specific gaming domain).
  • Syncing: All custom exceptions are saved via the backend API and synced instantly in real time to the child device's local policy configuration.

🛠️ 3. Global Preset Configurations & CSV Workflows​

To make managing millions of domains and keywords scalable for system administrators, Fami Hero supports bulk workflows:

  • Platform Presets: Categories are initialized with default-enabled statuses to ensure new child profiles are immediately protected upon pairing without requiring manual parent configuration.
  • Bulk CSV Import: Import thousands of blocked domains directly into global categories using structured CSV files. The portal validates the file headers (Category Name, Category ID, Domain) before ingestion to prevent database corruption.
  • Bulk CSV Export: Backup or export the current domain blocklist dataset with a single click for offline auditing and reporting.

Admin Portal: Custom Domain Blacklist and Whitelist Rules Caption: Bulk import/export tools for managing large domain lists efficiently.

⏭️ Next Step​

Managing user accounts, parent registrations, and devices is the next core administrative responsibility. Continue to User & Device Management.