Support

Baby Buddy Companion is an unofficial, open-source native client for the self-hosted Baby Buddy server. This page covers the most common questions. If you’re still stuck, get in touch — we’re happy to help.

Getting started

Baby Buddy Companion needs a Baby Buddy server that you host — the app doesn’t store your data for you. Once your server is running:

1. In Baby Buddy on the web, open your user menu and choose Add a Device (or Settings → Add a Device).
2. In the app, tap Scan QR code and point your camera at the code shown on that page. You’re signed in instantly.
3. No camera handy? Tap Enter details manually and type your server address and API token instead.

Don’t have a server yet? See the Baby Buddy project for setup instructions.

Frequently asked questions

The app can’t connect to my server

• Make sure the server address is complete, including https:// (or http:// for a local server), and reachable from your phone’s network.
• If your server is only on your home network, connect your phone to the same network, or expose the server through a VPN or tunnel.
• A self-signed HTTPS certificate can block the connection — use a valid certificate (for example via a reverse proxy) or your server’s plain http:// address on a trusted network.

Does it work offline?

Yes. Every entry you make is saved on your device first, then synced to your server when you’re back online. If the same record is changed in two places, the app flags a conflict so you can choose which version to keep.

My data isn’t showing up on another device

Each device syncs with your server, not with us. Pull to refresh, confirm both devices point at the same server, and check that the first device has finished syncing (it will retry automatically when it has a connection).

Are any features paid or locked?

No. The complete app, including widgets and live timers, is available for free.

What does the optional in-app purchase do?

It supports ongoing maintenance and development. It is a consumable tip you can make again whenever you choose, and it does not unlock or change any features.

Does the app include analytics?

Yes. The official App Store build uses TelemetryDeck for limited feature-use and coarse error telemetry, and RevenueCat for optional tip purchases and receipt tracking. Neither service receives your baby records, server address, or credentials. The Privacy Policy explains exactly what is sent.

How do I enable the Face ID lock?

Settings → App Lock. Authentication is performed entirely by iOS — the app never sees your biometric data.

How do I delete my data?

Signing out (Settings → Sign Out) clears your stored credentials, and deleting the app removes all locally cached data. Records on your server are managed through Baby Buddy itself.

Privacy and terms

Your baby’s data stays on your own server — see the Privacy Policy for exactly what the app does and doesn’t collect, and the Terms of Service for the fine print.

Contact

Questions, bug reports, or feature ideas are welcome. The fastest way to reach us is to open an issue on GitHub:

• GitHub issues: https://github.com/kguy18/babybuddyios/issues

When reporting a problem, it helps to include your iOS version, the app version (Settings → About), and the steps that led to the issue. Please don’t include your server address, API token, or any of your child’s data in a public issue.