FlipFocus - Product Documentation

Product Overview

FlipFocus is a minimalist flip clock application with an integrated Pomodoro timer, designed to help users stay focused and productive. The app features a beautiful flip clock display, customizable themes, and seamless integration with iOS system features like Live Activity and Dynamic Island.

Target Users

Core Features

1. Flip Clock Display

A classic flip clock with smooth page-turning animations.

Specifications:

• Real-time clock display with hours and minutes
• Smooth flip animation for digit transitions (1.5s duration)
• Breathing colon animation (optional)
• Auto-hide UI controls after 5 seconds of inactivity
• Tap to reveal controls

Technical Details:

• Animation: Custom SwiftUI flip animation using 3D rotation
• Update frequency: 1 second interval
• Font: System font with customizable weight and size

2. Pomodoro Timer

A productivity timer based on the Pomodoro Technique.

Timer Configuration:

Cycle Structure:

Round 1: Focus (25m) → Short Break (5m)
Round 2: Focus (25m) → Short Break (5m)
Round 3: Focus (25m) → Short Break (5m)
Round 4: Focus (25m) → Long Break (15m)
→ Cycle repeats

Controls:

• Play/Pause: Start or pause the current session
• Reset: Return to initial state (Focus, 25:00)
• Skip: Jump to the next session

Visual Indicators:

• Circular progress ring showing remaining time
• Round indicator dots (4 dots showing completed rounds)
• State icon (flame for focus, leaf for break, pause for paused)

3. Live Activity & Dynamic Island

Real-time timer display on Lock Screen and Dynamic Island.

Supported Devices:

• Live Activity: iPhone with iOS 16.1+
• Dynamic Island: iPhone 14 Pro, iPhone 14 Pro Max, iPhone 15 series

Display Modes:

Data Sync:

• Updates every second during active timer
• Displays paused time when timer is paused
• Ends automatically when timer is reset

4. Home Screen Widgets

Quick glance widgets for the Home Screen.

Widget Sizes:

Features:

• Light and dark mode support
• Rounded font design
• Monospaced digits for consistent layout
• Updates every minute

5. Customization Options

Background Colors (16 options):

Adjustable Settings:

• Clock font size (0.8x - 1.2x)
• Clock digit opacity (50% - 100%)
• Colon opacity (30% - 80%)
• Colon breathing animation (on/off)
• Pomodoro font size (0.8x - 1.2x)
• Pomodoro opacity (50% - 100%)

6. Localization

Supported Languages (30):

Localized Content:

• All UI text
• Settings labels
• Background color names
• App name on Home Screen (via InfoPlist.strings)

User Flows

Flow 1: Basic Clock Usage

1. Open App → Flip Clock displayed
2. Wait 5s → Controls auto-hide
3. Tap screen → Controls appear
4. Tap Settings → Customize appearance
5. Swipe left → Switch to Pomodoro

Flow 2: Pomodoro Session

1. Swipe to Pomodoro view
2. Tap Play → Timer starts (25:00)
3. Live Activity appears on Lock Screen
4. Timer counts down
5. At 0:00 → Haptic feedback → Auto-switch to Break
6. Complete 4 rounds → Long Break
7. Tap Reset → Return to initial state

Flow 3: Widget Setup

1. Long press Home Screen → Edit mode
2. Tap + → Search "FlipFocus"
3. Select widget size (Small/Medium)
4. Place widget → Done

Technical Architecture

Project Structure

FashionClock/
├── FashionClock/
│   ├── FashionClockApp.swift      # App entry point
│   ├── ContentView.swift           # Main container view
│   ├── Views/
│   │   ├── FlipClockView.swift     # Flip clock display
│   │   ├── FlipDigitView.swift     # Single digit with animation
│   │   └── PomodoroView.swift      # Pomodoro timer
│   ├── Models/
│   │   ├── Settings.swift          # App settings (ObservableObject)
│   │   ├── PomodoroTimer.swift     # Timer logic
│   │   └── LiveActivityManager.swift # Live Activity control
│   ├── Ads/
│   │   └── AdManager.swift         # Google AdMob integration
│   └── Resources/
│       └── [30 language].lproj/    # Localization files
│
└── FlipFocusWidget/
    ├── FlipFocusWidget.swift       # Home Screen widget
    ├── FlipFocusWidgetLiveActivity.swift # Live Activity UI
    └── FlipFocusWidgetBundle.swift # Widget bundle

Key Technologies

Minimum Requirements

Monetization

Ad Strategy

First Day Policy:

• Banner ads: Always shown
• Interstitial ads: Hidden for first 24 hours after install
• Improves user experience and retention

Ad Networks

• Google AdMob (primary)
• SKAdNetwork integration for attribution

Privacy & Compliance

Data Collection

Compliance

• GDPR: UMP SDK for consent management
• CCPA: Supported via UMP SDK
• ATT: App Tracking Transparency implemented
• COPPA: Not targeted at children (4+ rating)

Version History

Version 1.0.0 (Initial Release)

Features:

• Flip clock with smooth animations
• Pomodoro timer (25/5/15 min)
• Live Activity & Dynamic Island support
• Home Screen widgets (Small, Medium)
• 16 background color options
• 30 language support
• Google AdMob integration
• Accessibility support (VoiceOver)

Future Roadmap

Support Information

Document Info