Quick Setup

1. Sign up with email/password, Google OAuth, or magic link (for invited Storytellers)
2. Choose Legacy Keeper Storyteller
3. Verify your email address
4. Add name, photo, date of birth, and preferred language
5. Enable notifications
6. Invite family via SMS magic link, email, or invite code / QR

Login Options

• Email & Password: Traditional login for all users
• Google OAuth (PKCE): Quick sign-in with your Google account - secured via Proof Key for Code Exchange
• Magic Link (Storytellers): Passwordless login via SMS when invited by a Keeper - one tap to join, auto account creation

Legacy Keepers (Younger Family Members)

• Daily topic headers, edit memory metadata, export & delete memories, manage connections & send invitations, AI photo analysis

Storytellers (Elders)

• Detailed prompts every 2 days, share photos voice and text memories, voice auto-transcription & translation, view shared family library, large accessible interface for elders

Invite New Storytellers (Magic Link)

1. Settings → Invite Storyteller → Enter name, phone (+852 for HK), relationship → Send SMS magic link → One tap to join

Connect with Existing Users

1. Settings → Invite Storyteller → "Existing User" tab → Enter email → They approve request

Invite Code / QR

1. Settings → Your Invite Code → Share code or scan QR → They enter code, you approve

Memory Types

• Photo: + → Photo → AI analysis (Google Gemini identifies people, setting, era) → Add caption → Send
• Voice: + → Voice → Record up to 5 min → OpenAI Whisper auto-transcription → Cantonese ↔ English translation
• Video: + → Video up to 10 min → Add description
• Text: Type → Send

AI Photo Analysis

When you upload a photo, ADORAS extracts EXIF metadata (date taken, GPS coordinates) and uses OpenStreetMap Nominatim to reverse-geocode the location. Google Gemini then analyses the image to identify people, places, and historical context.

Editing Memories (Keepers)

Long-press any memory → edit date, location, tags, and notes.

How It Works

1. Tap + → Voice → Hold to record (up to 5 min) → Audio sent to OpenAI Whisper for transcription → Auto-translated between Cantonese ↔ English → Original and translated versions shown - toggle anytime

Supported Languages

• Interface: English and Traditional Chinese
• Voice Recognition: Cantonese, Mandarin, English, and 90+ languages via Whisper

Keepers

• Daily topic header at 8 am (timezone-aware, HKT default). Use it to start conversations with your Storyteller.

Storytellers

• Detailed prompt every 2 days at 8 am. Example: "What traditions did your family celebrate during Mid-Autumn Festival?"

Prompts Tab

Light-bulb icon → read today's prompt → answer or generate new ones.

Notification Types

• Daily prompts (8 am HKT)
• New memories (instant)
• Connection requests
• Magic link invitations

Delivery Channels

• iOS (Native): Apple Push Notification Service (APNs)
• Android (Native): Firebase Cloud Messaging (FCM)
• Web / PWA: Web Push via VAPID keys

Settings

Settings → Notifications: on/off, sound, quiet hours, per-connection controls.

Offline Mode

ADORAS works offline via service worker caching. Memories created offline are queued and synced automatically when you're back online.

Native Integrations (iOS & Android)

• Camera: Capture photos directly within the app
• Microphone: Record voice notes hands-free
• Photo Library: Import existing photos - EXIF data extracted automatically
• Deep Linking: Open shared memories and invites via adoras:// URL scheme

PWA (Web)

Install ADORAS from your browser for an app-like experience - Home Screen icon, full screen, push notifications, and offline access.

Storage Limits

Free accounts include 2 GB of storage. You can upgrade to premium for unlimited storage and additional features.

Manage Storage

• Storage Usage: See how much space you're using
• Media Quality: Choose upload quality (Original, High, Standard)
• Download on WiFi Only: Save mobile data
• Cache Management: Clear cached media files

Media Library & Search

• Views: Calendar, Grid, List
• Filters: Type, date, tags, connection
• Search: By date, keyword, tag, or location

Export (Keepers)

1. Settings → Storage & Data → Select connection → Export → download JSON + media links

Profile

• Name, date of birth, relationship, bio, photo, preferred language (English or Traditional Chinese)

Security & Login

• Email & Password: Change password anytime in settings
• OAuth Users (Google): Secured via PKCE; password optional - can set one for backup login
• Magic Link Users (Storytellers): Passwordless login; can set password for traditional login access later
• Linked Accounts: Connect Google for easier sign-in

Privacy & Data Processing

• AI Processing: Photos analysed by Google Gemini; voice transcribed by OpenAI Whisper - data processed server-side, not stored by providers
• Location Data: EXIF GPS coordinates extracted from photos and reverse-geocoded via OpenStreetMap Nominatim
• Cookies: Functional OAuth PKCE code_verifier cookie only - no tracking cookies
• Private Profile: Control visibility to other users

Data Management

• Export memories (JSON + media links)
• Delete connection data (removes shared memories with specific person)
• Delete account (permanent, removes all data)

Quick Fixes

1. Refresh the page / restart the app
2. Sign out & sign back in
3. Clear cache (Settings → Storage & Data)
4. Check your internet connection

Common Issues

• Voice not recording: Check microphone permissions in your device settings
• Photos not uploading: Check camera/photo library permissions and storage space
• Notifications not arriving: Ensure notifications are enabled in both app settings and device settings. iOS PWA users must add to Home Screen.
• Magic link expired: Links are valid for 24 hours. Ask your Keeper to resend.

Still stuck?

Settings → Help & Feedback → Contact Support (24-48 hour reply).