Skip to content

Mobile app that transforms handwritten family documents into accessible audio recordings

Notifications You must be signed in to change notification settings

chbornman/FamilyTales_docs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

30 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

FamilyTales

Bringing Family Stories to Life, One Voice at a Time

FamilyTales transforms precious family documents into living memories. We believe every handwritten letter from grandpa, every recipe card from mom, and every journal entry deserves to be heard, not just stored away in dusty boxes. Our app makes it possible for one family member to preserve these treasures and instantly share them with loved ones around the world.

🎯 Our Mission

To ensure no family story is lost to time, illegible handwriting, or geographic distance. We're building the bridge between generations, making it as easy to listen to great-grandma's love letters as it is to video call your grandchildren.

πŸ’‘ Why FamilyTales Exists

Every family has a treasure trove of handwritten memories:

  • Love letters that tell the story of how families began
  • War correspondence sharing experiences from pivotal moments in history
  • Recipe cards with secret ingredients written in the margins
  • Personal journals revealing the inner thoughts of our ancestors
  • Children's drawings with stories written on the back
  • Photo albums with handwritten captions and memories

But these treasures face real challenges:

  • πŸ“œ Fading ink and deteriorating paper threaten physical preservation
  • πŸ‘“ Aging eyes struggle to read old handwriting
  • 🌍 Geographic separation keeps families from sharing physical documents
  • πŸ” Cursive writing is increasingly difficult for younger generations to read
  • πŸ’” Lost context when the storyteller is no longer with us

πŸš€ How FamilyTales Works

For the Family Archivist (The Scanner)

  1. πŸ“Έ Capture - Photograph documents using your phone's camera
  2. πŸ” Review - See the original document synchronized with extracted text
  3. ✏️ Perfect - Make corrections with help from family members
  4. πŸŽ™οΈ Create - Generate natural-sounding audio in multiple languages
  5. πŸ“€ Share - Instantly distribute to family members worldwide

For the Family (The Listeners)

  1. πŸ“± Receive - Get notified when new memories are shared
  2. 🎧 Listen - Stream instantly or download for offline enjoyment
  3. πŸ‘€ Follow Along - See the original document highlighted as audio plays
  4. πŸ’¬ Contribute - Help correct difficult passages or add context
  5. πŸ“ Organize - Create Memory Books to group related stories

✨ Core Features

🏠 Family-First Design

Easy Family Invitations

  • Direct Links: Click and join - familytales.app/join/abc123
  • Email Invites: Beautiful invitations via SendGrid
  • QR Codes: Perfect for family reunions
  • No Friction: Listen first, create account when ready

Family Management

  • Head of Family: Person who pays controls membership
  • Multiple Families: Users can belong to Mom's side AND Dad's side
  • Smart Context: App knows which family you're viewing
  • Transfer Ownership: Pass the torch when needed

Everyone Can Contribute

  • All family members can scan/upload - not just the account owner
  • Collaborative corrections - help fix Grandpa's tricky handwriting
  • Shared organization - build Memory Books together
  • Unified library - everything in one place

πŸ”’ Privacy & Preservation

  • Self-Hosted OCR: Your documents never leave our secure servers
  • Family-Trained AI: Improves recognition of your family's handwriting over time
  • Encrypted Storage: Military-grade protection for your memories
  • Offline Access: Download for areas with poor connectivity

🎯 Smart Organization with Memory Books

Memory Books are flexible collections that can be as simple or complex as you need:

Simple: One Thread

"Grandma's Letters" β†’ Single audio file with all letters

Complex: Multiple Threads

"Smith Family Heritage"
β”œβ”€β”€ "War Years" (15 min audio)
β”œβ”€β”€ "Love Letters" (20 min audio)
└── "Recipe Collection" (10 min audio)

Features

  • Auto-organization: AI suggests groupings
  • Mixed media: Combine photos, letters, recipes
  • Print-ready: Export as physical books
  • Timeline view: See content chronologically
  • Smart search: Find content across all books

🌍 Global Family Features

  • Instant Streaming: Mux handles all HLS complexity automatically
  • Adaptive Quality: Automatically adjusts to each family member's connection
  • Global CDN: 100+ edge locations for instant playback worldwide
  • Smart Downloads: Mux provides direct download links for offline listening
  • Live Sessions: Listen together with synchronized playback

πŸ“Έ Beyond Documents

  • Photo Narration: Add voice stories to photo collections
  • Mixed Media: Combine letters with related photos
  • Recipe Mode: Special formatting for family recipes
  • Children's Art: Preserve drawings with audio descriptions

🎁 Additional Features That Could Make Sense

Based on the family-centric nature of FamilyTales, here are additional features that could enhance the experience:

🌳 Family Tree Integration

  • Visual Family Trees: Link documents to specific family members
  • Relationship Mapping: Understand who wrote to whom
  • Generation Bridging: See how stories connect across generations

🎭 Voice Preservation

  • Voice Banking: Record family members reading sample text
  • Voice Cloning: Apply grandpa's voice to his old letters
  • Dialect Preservation: Capture regional accents and speaking patterns

πŸ“… Memory Calendar

  • Anniversary Reminders: "50 years ago today, Grandma wrote this letter"
  • Seasonal Collections: Christmas letters, birthday cards, etc.
  • This Day in History: Surface relevant family documents

🀝 Collaborative Features

  • Memory Prompts: Questions that spark storytelling
  • Interview Mode: Guided conversations to capture oral history
  • Annotation Layers: Family members add context without changing originals

🎨 Creative Outputs

  • Print Memory Books:
    • Professional hardcover books with original handwriting + transcribed text
    • Single QR code that opens the Memory Book in the app
    • Tap any page number in the app to jump to that audio moment
    • Perfect binding, archival paper, multiple size options
    • Ideal for gifts, memorials, milestone celebrations
  • Audio Postcards: Share snippets on social media with visual cards
  • Family Podcasts: Curated audio stories for family reunions
  • Memory Calendars: Annual calendars featuring family documents and photos

🧬 Legacy Planning

  • Digital Will: Specify who inherits which memories
  • Time Capsules: Lock memories to be opened on future dates
  • Memory Guardians: Designate family historians for continuity

πŸ“Š Market Opportunity

  • 76% of seniors now own smartphones
  • $15.8 billion genealogy market by 2033 (11.3% CAGR)
  • 26% annual growth in audio content consumption
  • $6-12 per page current cost for professional transcription services
  • No existing solution specifically targets family document audio preservation

🎯 Target Audience

Primary Market

  • Adults aged 65+ who want to preserve and access family memories
  • 54 million smartphone-owning seniors in the US alone

Secondary Market

  • Adult children (35-55) purchasing for elderly parents
  • Estate planners and family historians
  • Libraries, museums, and senior living facilities

πŸ’° Business Model - Family-First Pricing

Core Concept: One Subscription, Whole Family Benefits

When the head of family (usually Mom or Dad) subscribes, the ENTIRE family gets access. No counting seats, no individual billing - true family sharing that just works.

Pricing Tiers

Free Tier - "Family Memories Starter"

Perfect for trying out the service

  • 3 document scans per month (resets monthly)
  • Basic voices only (one male, one female)
  • Up to 5 family members
  • 7-day trial of premium features on sign-up
  • Watermark on shared content ("Created with FamilyTales")
  • Standard processing speed (up to 24 hours)
  • View-only access to premium family content

Family Plan - $14.99/month or $119/year

The sweet spot for most families

  • Unlimited family members - seriously, invite everyone!
  • Unlimited document scans
  • Premium voices (10+ natural voices with accents)
  • Instant processing (under 5 minutes)
  • No watermarks
  • Public sharing for social media
  • Offline downloads
  • Priority support
  • Memory Book templates

Family Legacy - $29.99/month or $299/year

For serious family historians

Everything in Family Plan plus:

  • Two family groups (both sides of the family)
  • Voice cloning (preserve actual voices)
  • Bulk upload mode (entire boxes at once)
  • API access for tech-savvy family members
  • White-label sharing (memories.yourfamily.com)
  • Phone support for elderly members
  • Print-on-demand credits ($10/month)
  • Early access to new features

Smart Freemium Conversion

  • Emotional triggers: "You've preserved 3 memories! Upgrade to preserve them all."
  • Voice previews: 30-second premium voice samples
  • Family viral loop: Free users in premium families see the benefits
  • Seasonal campaigns: Mother's Day, Christmas gift subscriptions

Why This Works

  • One buyer, many users: Grandma doesn't need to figure out payments
  • Natural viral growth: Each family member brings their in-laws
  • High retention: Can't cancel when the whole family uses it
  • Clear value: $14.99/month preserves priceless memories forever

🎯 Why Our Tech Choices

Why Rust + Axum (Not Firebase)

  • Performance: 10x faster than Node.js, perfect for audio processing
  • Type Safety: Catch bugs at compile time, not in production
  • Cost Effective: Single small VPS can handle thousands of users
  • Full Control: Own your auth, data, and user experience

Why Mux (Not S3 + Manual HLS)

  • Zero Complexity: Upload audio, get instant global HLS streaming
  • Built-in CDN: No need for CloudFront or separate CDN setup
  • Audio Normalization: Consistent volume across all family documents
  • Direct Playback URLs: Works immediately with just_audio in Flutter
  • Cost: Pay only for what you use, no infrastructure overhead

Why PostgreSQL + Redis (Not Firestore)

  • Relational Integrity: Family relationships need proper foreign keys
  • Complex Queries: "Find all letters from Grandma mentioning Uncle John"
  • Cost Predictable: Fixed monthly cost vs per-operation billing
  • Redis Speed: Instant session management and caching

πŸ›  Technology Stack

Frontend

  • Mobile/Web/Desktop: Flutter 3.x (single codebase for all platforms)
  • Audio Playback: just_audio with native HLS support
  • State Management: Riverpod 2.0 (compile-safe, testable)
  • Navigation: go_router with Riverpod integration
  • Authentication: Clerk (seamless across platforms)

Backend (MVP from Day 1)

  • API Server: Rust with Axum framework
  • Database: PostgreSQL (primary) + Redis (cache/sessions)
  • Media Storage: Mux (handles all video/audio/image storage and HLS streaming)
  • Job Queue: RabbitMQ (for future local PC processing)
  • Authentication: Clerk integration with JWT
  • Email: SendGrid for beautiful family invitations
  • Payments: Stripe for family subscriptions

Processing & Voice Options

MVP Text-to-Speech Choices:

  1. Google Cloud TTS (Recommended)

    • WaveNet voices: Most natural sounding
    • 380+ voice options across languages/accents
    • Cost: ~$0.016 per document
  2. Amazon Polly

    • Good quality, slightly robotic
    • Neural voices available
    • Cost: ~$0.008-0.016 per document
  3. ElevenLabs (Premium tier)

    • State-of-the-art quality
    • Voice cloning capability
    • Cost: Higher but worth it for Legacy tier

Voice Selection

  • Free tier: 2 basic voices (male/female)
  • Paid tiers: 10+ premium voices
  • Legacy tier: Voice cloning to preserve actual family voices
  • Smart selection: Choose voice per Memory Book thread

πŸ— Project Structure

FamilyTales/
β”œβ”€β”€ original_research/
β”‚   └── [Market research and competitive analysis]
β”œβ”€β”€ product_brainstorm/
β”‚   β”œβ”€β”€ architecture.md      # Technical architecture and system design
β”‚   β”œβ”€β”€ business_case.md     # Detailed business model and financials
β”‚   β”œβ”€β”€ marketing.md         # Marketing strategy and go-to-market plan
β”‚   └── ocr_technology.md    # OCR technology research and recommendations
└── .hidden_items/
    └── [Internal project documentation]

🚦 MVP Feature Priorities

Phase 1: Core Magic (Months 1-2)

Must have for launch:

  1. πŸ“Έ Document Scanning - Photo capture with auto-enhancement
  2. πŸ”€ OCR Processing - Google Vision API for text extraction
  3. πŸŽ™οΈ Audio Generation - Basic TTS voices (2 options)
  4. πŸ‘¨β€πŸ‘©β€πŸ‘§ Family Sharing - Simple invite system with JWT links
  5. πŸ“± Mobile App - Flutter iOS/Android with basic features
  6. πŸ’³ Payments - Stripe integration for family subscriptions
  7. πŸ” Authentication - Clerk for easy signup/login

Phase 2: Family Features (Month 3)

Core family experience: 8. πŸ“š Memory Books - Basic collections (single thread only) 9. πŸ‘₯ Family Roles - Head of family + members 10. 🎡 Audio Playback - HLS streaming via Mux 11. ✏️ OCR Corrections - Simple text editing 12. πŸ“€ Invite System - Email invites via SendGrid 13. πŸ’Ύ Basic Storage - 10GB per family

Phase 3: Growth Features (Month 4)

Viral and retention: 14. 🎁 Gift Subscriptions - For Mother's Day launch 15. πŸ“Š Family Dashboard - See who's listening 16. πŸ”„ Multiple Families - Support both sides 17. 🌐 Public Sharing - Social media cards 18. πŸ“± Progressive Web App - No app store needed

Phase 4: Premium Value (Month 5-6)

Conversion drivers: 19. 🎀 Premium Voices - 10+ natural options 20. πŸ“¦ Bulk Upload - Process multiple documents 21. 🏷️ Smart Tagging - Auto-detect people/dates 22. πŸ’¬ Voice Selection - Per Memory Book choice 23. πŸ“₯ Offline Mode - Download for trips

Post-MVP (Months 7+)

Nice to have later:

  • 🌳 Family Tree View
  • πŸ–¨οΈ Print-on-Demand Books
  • πŸŽ™οΈ Voice Cloning
  • πŸ€– AI Organization
  • πŸ“· Photo Narration
  • πŸ” Advanced Search
  • πŸ“ˆ Analytics Dashboard
  • 🌍 Multi-language Support
  • πŸ”— API Access
  • 🏒 White-label Options

🚦 Current Status

  • βœ… Market research completed
  • βœ… Business model validated
  • βœ… Technical architecture designed
  • βœ… Marketing strategy developed
  • βœ… User stories defined
  • πŸ”„ Seeking seed funding
  • ⏳ MVP development (Q1 2025)

🎯 Implementation Roadmap

Phase 1: MVP (Months 1-3) - "Launch Fast"

Infrastructure: Rust backend from day 1 (no Firebase)

  • βœ… Rust Axum API server
  • βœ… PostgreSQL + Redis
  • βœ… Mux for all media (automatic HLS streaming)
  • βœ… Third-party OCR/TTS APIs
  • βœ… Freemium model (3 free docs/month)
  • βœ… Basic family sharing
  • 🎯 Target: 1,000 beta users

Phase 2: Hybrid Processing (Months 4-6) - "Premium Experience"

  • πŸ”„ Add local PC worker for premium users
  • πŸ”„ RabbitMQ job queue implementation
  • πŸ”„ Tiered processing (free = cloud, premium = local)
  • πŸ”„ Voice selection and customization
  • πŸ”„ Advanced folder organization
  • πŸ’° 60% cost reduction on processing
  • 🎯 Target: 10,000 users

Phase 3: Self-Hosted Scale (Months 7-9) - "Own Your Stack"

  • πŸš€ Complete migration to olmOCR
  • πŸš€ Multiple local PC workers
  • πŸš€ Custom TTS models
  • πŸš€ Voice cloning beta
  • πŸš€ Family tree integration
  • 🎯 Target: 50,000 users

Phase 4: Innovation (Months 10-12) - "Market Leader"

  • 🌟 Distributed processing network
  • 🌟 B2B API marketplace
  • 🌟 International expansion
  • 🌟 AI-powered memory prompts
  • 🌟 Legacy planning features
  • 🎯 Target: 100,000+ users

Phase 5: Physical + Digital (Months 13-18) - "Complete Memory Ecosystem"

  • πŸ“š Print-on-Demand Memory Books
    • Beautiful hardcover books from digital Memory Books
    • One QR code opens entire Memory Book in app
    • In-app page navigation syncs with physical book pages
    • Professional layout with original handwriting + typed text
    • Perfect for gifts, reunions, memorials
  • 🎁 Memory Box Subscriptions
    • Quarterly printed collections
    • USB drive with offline app + all audio
    • Archival storage box
  • πŸ’° New Revenue Stream: $39-79 per printed book
  • 🎯 Target: 20% of families order physical products

πŸ“ˆ Success Metrics

  • User Acquisition: 150K users by Year 1
  • Conversion Rate: 5% free to paid
  • Monthly Active Users: 60% of registered users
  • Customer Lifetime Value: $240 (premium tier)
  • Net Promoter Score: Target 70+

🀝 Partnership Opportunities

  • Genealogy Platforms: Ancestry.com, MyHeritage
  • Senior Organizations: AARP, senior living facilities
  • Memory Services: StoryWorth, Remento
  • Healthcare: Hospitals, hospices for legacy programs

πŸ’‘ Competitive Advantages

  1. First-mover in family document audio preservation
  2. Emotional value proposition vs. purely functional competitors
  3. Multi-generational appeal bridging tech-savvy children and their parents
  4. Network effects through family sharing features
  5. B2B2C opportunities with institutional partners

πŸ›‘ Privacy & Security

  • Self-hosted OCR processing
  • End-to-end encryption for cloud features
  • HIPAA, COPPA, and GDPR compliant
  • User data ownership guarantee
  • No selling of personal data

πŸ“š Documentation

πŸ“– View Complete Technical Documentation

Our comprehensive documentation includes:

  • 🎨 Design System: Brand guide, UI components, and audio UX
  • πŸ”§ Development: Setup, testing, debugging, and architecture
  • πŸ“‹ Specifications: API docs, database schema, and user flows
  • πŸš€ Operations: Deployment, monitoring, scaling, and security
  • πŸ“… Sprint Plan: 6-month development roadmap

πŸ“ž Contact

For investment inquiries, partnership opportunities, or more information:


FamilyTales - Where every word tells a story, and every story finds a voice.

About

Mobile app that transforms handwritten family documents into accessible audio recordings

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •