DuckBuck is a feature-rich mobile application built with Flutter that provides a secure and intuitive platform for social connections, real-time voice communication, and comprehensive relationship management.
Explore the complete technical documentation for DuckBuck's advanced features and architecture:
Multi-provider authentication with enhanced UserModel and premium features
- Authentication Architecture - Complete technical architecture with enhanced UserModel structure
- Authentication User Flows - Detailed sequence diagrams for multi-provider auth flows
- Authentication Code Organization - Code structure and implementation details
Key Features:
- Multi-Provider Support (Google, Apple, Phone)
- Premium Features with Agent Time Management
- Soft Delete Support with 90-day Recovery
- Smart Field Management based on Auth Method
- FCM Token Management and Device Integration
Unified relationship management with smart caching and real-time updates
- Friends Architecture - Enhanced v2.0 unified SharedFriendsProvider architecture
- Friends User Flows - Comprehensive relationship management flows
- Friends Code Organization - Repository-level caching and state management
- Friends Overview - Quick start guide and component overview
Key Features:
- Unified SharedFriendsProvider (Single Source of Truth)
- Repository-Level Smart Caching (5-minute validity)
- Real-time Firebase Streams with Auto-reconnection
- Comprehensive Relationship States (pending, accepted, blocked, declined)
- Enhanced RelationshipModel and UserModel Integration
- Memory Optimization and Performance Features
Production-ready real-time voice communication with background service architecture
- Walkie-Talkie Architecture - Complete Kotlin service layer and Agora RTC integration
- Walkie-Talkie User Flows - Comprehensive call lifecycle and FCM processing
- Call State Optimization Summary - Simplified state machine details
- FCM Receiver Flow - Firebase Cloud Messaging integration
- Walkie-Talkie Overview - Feature overview and technical specifications
Key Features:
- Foreground Service Architecture for Background Persistence
- Simplified Call State Management (JOINING → ACTIVE → ENDING → ENDED)
- Advanced FCM Processing with Auto-Connect
- Agora RTC Integration with Professional Audio Quality
- Cross-Platform Bridge (Flutter ↔ Kotlin)
- Smart Notification System with Speaker Detection
- Audio Management with Hardware Integration
Intelligent voice conversations with time-based usage management and real-time audio
- AI Agent Architecture - Complete system design with Agora RTC and backend integration
- AI Agent User Flows - Comprehensive conversation flows and platform-specific behaviors
- AI Agent Code Organization - Layered architecture and component relationships
- AI Agent Backend Integration - API endpoints, authentication, and data synchronization
- AI Agent Time Management - Real-time time tracking and Firebase synchronization
- AI Agent Error Handling - Comprehensive error recovery and user experience patterns
- AI Agent Overview - Feature overview and quick start guide
Key Features:
- Real-Time Voice Conversations with AI Assistant
- Time-Based Usage System (1 hour default allocation)
- Agora RTC Integration with Professional Audio Quality
- Firebase Real-Time Time Synchronization
- Two-Phase Session Start (Immediate UI Update + Background Connection)
- Proximity Sensor Integration for Earpiece Mode
- Cross-Platform UI (iOS Cupertino + Android Material)
- Comprehensive Error Handling with Graceful Degradation
- Circuit Breaker Pattern for Backend Resilience
- Memory-Efficient Resource Management
DuckBuck implements a comprehensive layered architecture across all features:
🎨 UI Layer (Flutter)
├── Platform-specific interfaces (iOS/Android)
├── Real-time state management with Providers
├── Cross-platform bridge communication
└── Responsive and accessible design
🔄 Provider Layer
├── SharedFriendsProvider (Unified friends management)
├── AuthStateProvider (Multi-provider authentication)
├── Settings and user preference management
└── Real-time stream coordination
📂 Repository Layer
├── RelationshipRepository (Smart caching & analytics)
├── UserRepository (Profile and auth coordination)
├── Repository-level caching strategies
└── Business logic coordination
⚙️ Service Layer
├── Firebase integrations (Auth, Firestore, FCM)
├── Agora RTC service (Voice communication)
├── Local database service (Offline support)
└── Analytics and monitoring services
🌐 External Services
├── Firebase ecosystem (Auth, Firestore, Storage, FCM)
├── Agora RTC platform (Real-time communication)
├── Android system services (Audio, notifications)
└── Cross-platform native integrations
- Multi-Provider Auth: Google, Apple, and Phone authentication
- Premium Features: Agent time management with time-based access
- Account Management: Soft delete with recovery, profile management
- Security: Enhanced token management and session handling
- Unified Management: Single provider for all relationship operations
- Real-time Updates: Live synchronization across devices
- Smart Caching: Offline support with background refresh
- Privacy Controls: Comprehensive blocking and privacy management
- Instant Voice: Auto-connect calls via FCM notifications
- Background Operation: Persistent service architecture
- Professional Audio: Agora RTC with optimized quality
- Smart Notifications: Speaker detection with self-filtering
- Voice AI Assistant: Real-time conversations with intelligent responses
- Time-Based Usage: 1-hour default allocation with real-time tracking
- Professional Audio: Agora RTC integration with proximity sensor support
- Seamless Experience: Two-phase connection with immediate UI feedback
- Cross-Platform: Native iOS and Android interfaces with platform-specific optimizations
- Explore the Documentation: Start with the feature you're interested in
- Architecture Deep Dive: Review the enhanced v2.0 architecture documents
- Implementation Details: Check the code organization guides
- User Flows: Understand the complete user journey sequences
- Flutter Framework: Cross-platform mobile development
- Firebase Integration: Authentication, database, and messaging
- Agora RTC: Professional real-time communication
- Kotlin Service Layer: Background processing and native integration
- Smart Caching: Repository-level optimization strategies
- Real-time Streams: Live data synchronization
- Memory Optimization: Efficient resource management
- Performance: Optimized for production deployment
For detailed setup instructions, development workflows, and deployment guides, please refer to the comprehensive documentation in the respective feature folders.