ADORAS 2.0 connects generations through shared memories — built for Hong Kong families bridging youth and elders. Choose your role, set up your profile, and start preserving stories.

Quick Setup

1. Sign up with email/password, Google OAuth, or magic link (for invited Storytellers)
2. Choose Legacy Keeper (younger family member) or Storyteller (elder sharing memories)
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

Legacy Keepers (Younger Family Members)

• Daily topic headers to spark conversations
• Edit memory metadata (date, location, tags)
• Export & delete memories
• Manage connections & send invitations
• AI-powered photo analysis — upload a photo and Gemini identifies people, places, and context

Storytellers (Elders)

• Detailed prompts every 2 days
• Share photos, voice recordings, and text memories
• Voice notes auto-transcribed and translated between Cantonese ↔ English
• View shared family library
• Large, accessible interface designed for older users

Invite New Storytellers (Magic Link)

1. Settings → Invite Storyteller
2. Enter their name, phone number (+852 for HK), and your relationship
3. They receive an SMS with a secure magic link
4. One tap to join — no password needed, account created automatically
5. Connection is automatically established

Connect with Existing Users

1. Settings → Invite Storyteller → "Existing User" tab
2. Enter their email address
3. They receive a connection request to approve

Invite Code / QR

1. Settings → Your Invite Code
2. Share code or scan QR
3. They enter it; you approve

Memory Types

• Photo: + → Photo → AI analyses the image with Google Gemini (identifies people, setting, era) → add caption → send
• Voice: + → Voice → record up to 5 min → auto-transcribed by OpenAI Whisper → translated between Cantonese ↔ English
• 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)
2. Audio is sent to OpenAI Whisper for transcription — supports Cantonese, Mandarin, English, and other languages
3. Transcription is automatically translated between Cantonese ↔ English so both generations can understand
4. Both the original and translated versions are shown — toggle between them 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 is 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
2. Select connection
3. Export → download JSON + media links

Profile

• Name, date of birth, relationship, bio, photo, preferred language (English or 繁體中文)

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).