Version: 2.0.0 Platform: iOS & Android Framework: React Native (Expo)
🧸 Smart Plushie Companion App for Parents 🧸
Control, monitor, and manage your child's Luno smart toy experiences
Luno Toys is a parental control and monitoring application designed for parents to manage their children's interactions with Luno smart plushie toys. The app provides:
- 🎮 Toy Management - Pair and configure Luno smart toys via Bluetooth and WiFi
- 👨👩👧 Child Profiles - Create and manage profiles for multiple children
- 💬 Conversation Monitoring - Review AI-powered conversations between children and toys
- 🛡️ Parental Controls - Set content filters, time limits, and safety alerts
- 📊 Activity Timeline - Track engagement patterns and flagged content
- ⚙️ Safety Features - Automated content filtering and parental alerts
- Node.js (v18+)
- npm or yarn
- Expo CLI (
npm install -g expo-cli) - iOS Simulator (Xcode on macOS) or Android Emulator (Android Studio)
- Firebase project with Firestore enabled
-
Clone the repository
git clone <repository-url> cd luno-toys-mobile
-
Install dependencies
npm install
-
Set up Firebase
- Create a Firebase project at firebase.google.com
- Enable Email/Password authentication
- Create Firestore database
- Download
google-services.json(Android) andGoogleService-Info.plist(iOS) - Update
src/lib/firebase.tswith your Firebase config
-
Run the app
# iOS Simulator npm run ios # Android Emulator npm run android # Expo Go (Development) npm start
All project documentation is located in the docs/ directory:
| Document | Description |
|---|---|
| Quick Start Guide | Step-by-step setup and configuration |
| Implementation Summary | Architecture and technical overview |
| Firestore Structure | Database schema and data models |
| Firestore Data Flow | Data flow and CRUD operations |
| Cloud Functions Setup | Firebase Cloud Functions configuration |
| Privacy Policy | App privacy policy (user-facing) |
| Terms & Conditions | Legal terms of service (user-facing) |
👉 New to the project? Start with docs/README.md for a documentation overview.
- React Native 0.81.5 - Mobile framework
- Expo ~54.0 - Development platform
- TypeScript ~5.9 - Type safety
- React Navigation ^7.1 - Navigation system
- Firebase Authentication - User authentication
- Firebase Firestore - Cloud database
- Firebase Cloud Functions - Backend logic
- React Native BLE PLX ^3.2 - Bluetooth Low Energy
- Expo Linear Gradient - Gradient backgrounds
- Custom Responsive System - Adaptive layouts
- Ionicons - Icon library
luno-toys-mobile/
├── src/
│ ├── components/ # Reusable UI components
│ ├── contexts/ # React Context providers (Auth, etc.)
│ ├── screens/ # App screens/pages
│ ├── navigation/ # Navigation configuration
│ ├── lib/ # Firebase and external services
│ ├── services/ # BLE, toy pairing services
│ ├── constants/ # Theme, colors, spacing
│ ├── types/ # TypeScript type definitions
│ └── utils/ # Helper functions
├── assets/ # Images, icons, fonts
├── functions/ # Firebase Cloud Functions
├── docs/ # 📚 All project documentation
├── app.json # Expo configuration
├── package.json # Dependencies
└── tsconfig.json # TypeScript configuration
- Create profiles for multiple children
- Assign toys to specific children
- Individual parental control settings per child
- Scan and pair Luno toys via Bluetooth
- Configure WiFi credentials on toys
- Real-time connection status monitoring
- View full conversation transcripts
- AI-powered safety flagging system
- Parental review of flagged content
- Configurable alert sensitivity levels
- Content Filters: Block topics (violence, mature content, politics, religion)
- Time Limits: Set daily usage limits
- Quiet Hours: Schedule automatic toy downtime
- Creative Mode: Toggle free-form vs. structured conversations
- Personal info sharing detection
- Inappropriate content detection
- Emotional distress indicators
- Unusual conversation patterns
- ✅ COPPA Compliant - Children's Online Privacy Protection Act
- ✅ Data Encryption - All data encrypted in transit (HTTPS/TLS)
- ✅ Parental Consent - Required for all child data collection
- ✅ User Control - In-app data deletion capabilities
- ✅ No Advertising - No behavioral advertising or data selling
- ✅ Secure Authentication - Firebase Auth with email/password
See docs/privacy_policy.md for full details.
- Dark Theme: Black background (#000) with golden accents (#FDBD4B)
- Starry Background: Animated star field for immersive experience
- Gradient Cards: Linear gradients with golden borders
- Responsive Typography: Scales across device sizes
- Accessible UI: High contrast, clear hierarchy
| Platform | Minimum Version | Status |
|---|---|---|
| iOS | 12.0+ | ✅ Supported |
| Android | API 21+ (5.0 Lollipop) | ✅ Supported |
npm start # Start Expo development server
npm run ios # Run on iOS simulator
npm run android # Run on Android emulator
npm run web # Run in web browser (limited functionality)Create a .env file (not tracked in git) for sensitive configuration:
FIREBASE_API_KEY=your_api_key_here
FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com
FIREBASE_PROJECT_ID=your_project_id1. Bluetooth not working on iOS
- Ensure
Info.plisthas Bluetooth permissions (NSBluetoothAlwaysUsageDescription) - Location permission required for BLE scanning on iOS
2. Firestore permissions error
- Check Firestore security rules
- Ensure user is authenticated before accessing data
3. WiFi setup fails
- Verify SSID and password are correct
- Check that toy is in pairing mode (LED indicator)
See docs/QUICK_START.md for more troubleshooting tips.
This project is proprietary and confidential. All rights reserved by LUNO.
For questions, issues, or support:
Email: auracampusapp@gmail.com
- Firebase - Backend infrastructure
- Expo - Mobile development platform
- React Native Community - Open source contributions
- Push notifications for safety alerts
- Multi-language support (Spanish, French)
- Voice message playback in timeline
- Export conversation history (PDF/CSV)
- Analytics dashboard for child development insights
- Toy firmware OTA updates
Built with ❤️ for safer, smarter play
Last updated: December 24, 2025