student-timekeeper-ios

DreamLauncherLite iOS

A focused, streamlined iOS app for cross-platform screen time tracking

🎯 What Is This?

DreamLauncherLite is a simple, privacy-focused iOS app that tracks your screen time and syncs it with your macOS devices. No bloat, no unnecessary features—just clean, cross-platform screen time tracking.

What It Does

• ✅ Tracks iOS screen time using Apple’s Family Controls framework
• ✅ Syncs to cloud via the existing dreamlauncher-api
• ✅ Shows combined data from all your Apple devices
• ✅ Displays weekly trends with simple, beautiful charts
• ✅ Platform breakdown showing time on iOS vs macOS

What It Doesn’t Do

• ❌ No health tracking
• ❌ No location tracking
• ❌ No social features
• ❌ No per-app tracking (privacy-preserving)
• ❌ No bloat

📊 The Numbers

This is a lean, focused app:

• ~2,300 lines of clean Swift code
• 3 screens (Auth, Dashboard, Settings)
• 2 permissions (Apple Sign-In, Screen Time)
• 6 weeks to ship to App Store
• 90% less code than the old bloated app

🚀 Current Status

Project Status: 📝 Documentation Complete → 🏗️ Ready to Build

• ✅ Complete architecture designed
• ✅ Technical specifications written
• ✅ API integration planned
• ✅ Day-by-day implementation checklist
• ⏸️ Xcode project not yet created

📚 Documentation

All documentation is in the docs/ folder:

Start Here

• docs/IOS_APP_README.md - Complete overview and index

Core Documents

• docs/STREAMLINED_IOS_APP_PLAN.md - Master plan and architecture
• docs/IOS_APP_TECHNICAL_SPEC.md - Code implementations
• docs/IOS_APP_IMPLEMENTATION_CHECKLIST.md - Day-by-day guide
• docs/OLD_VS_NEW_IOS_COMPARISON.md - Why this approach

🏗️ Architecture

┌──────────────────┐
│   iOS App        │  ← This project
│   (SwiftUI)      │
└────────┬─────────┘
         │
         │ HTTPS/REST
         │
┌────────▼─────────┐
│ dreamlauncher-api│  ← Existing backend
│   (Node.js)      │
└────────┬─────────┘
         │
         │ PostgreSQL
         │
┌────────▼─────────┐
│   macOS App      │  ← student-time-tracker
│   (Swift)        │
└──────────────────┘

🛠️ Prerequisites

Development

• macOS 13.0+ with Xcode 15.0+
• Apple Developer Account ($99/year)
• Family Controls entitlement (request from Apple)
• Swift 5.9+ knowledge

Existing Infrastructure

• ✅ dreamlauncher-api - Backend already built
• ✅ Database schema - user_screen_time table exists
• ✅ Authentication - Apple Sign-In endpoints ready
• ✅ API endpoints - All screen time APIs ready

🚦 Next Steps

Immediate Actions

1. Request Family Controls Entitlement

   Visit: https://developer.apple.com/contact/request/family-controls-distribution
   Explain: Cross-platform screen time tracking use case
   Wait: 1-2 weeks for approval
   

2. Create Xcode Project ```
   • Open Xcode
   • File > New > Project
   • iOS > App
   • Name: DreamLauncherLite
   • Bundle ID: com.dreamlauncher.lite.ios
   • Interface: SwiftUI
   • Language: Swift ```
3. Follow the Checklist
   • See docs/IOS_APP_IMPLEMENTATION_CHECKLIST.md
   • 30-day plan from setup to App Store

📅 Timeline

Week	Focus	Deliverable
1	Core Foundation	Auth flow working
2	Screen Time	iOS data collection
3	API Sync	Data in backend
4	Cross-Platform	macOS data visible
5	Testing & Polish	Bug-free app
6	Submission	In App Review

Total: 6-7 weeks to App Store

🔒 Privacy

This app is privacy-focused by design:

• Only collects screen time duration (total minutes)
• No per-app tracking
• No personal data beyond screen time
• User controls all data
• GDPR/CCPA/COPPA compliant

📱 Features

MVP (v1.0)

• Apple Sign-In authentication
• iOS screen time tracking (Family Controls)
• Sync to cloud backend
• Dashboard showing today’s total
• Week-at-a-glance chart
• Platform breakdown (iOS vs macOS)
• Background sync
• Offline support

Future (v2.0+)

• Home screen widget
• Daily/weekly notifications
• Screen time goals
• More detailed breakdowns
• Shortcuts integration

🤝 Related Projects

This app is part of the DreamLauncher ecosystem:

• dreamlauncher-api - Backend API (Node.js/Express)
• student-time-tracker - macOS monitoring app
• dreamlauncher-ios - Old iOS app (deprecated due to legal issues)

📖 Why This Exists

The previous iOS app (dreamlauncher-ios) became bloated with unnecessary features:

• 10,000+ lines of code
• Health tracking, location, motion, beacons
• Social features, leaderboards, friends
• Screenshots, audio recording
• Result: Legal issues, deprecated, never shipped

This app does one thing well:

• 2,300 lines of focused code
• Screen time tracking only
• Clean architecture
• Result: Simple, legal, ready to ship

See docs/OLD_VS_NEW_IOS_COMPARISON.md for full comparison.

📄 License

Part of the DreamLauncher project. See parent repository for license details.

🚀 Let’s Build!

Everything is ready:

• ✅ Architecture designed
• ✅ Technical specs written
• ✅ Implementation plan created
• ✅ Git repository initialized

Next: Create the Xcode project and start Day 1 of the checklist!

---

This is a fresh start. Let’s build something simple, focused, and actually useful.