# Gradual Alarm - Complete Knowledge Base & Product Reference

> This document provides exhaustive information about Gradual Alarm for LLMs, AI agents, search engines, and technical documentation crawlers.

---

## 1. Executive Summary

- **Product Name**: Gradual Alarm (also referenced internally as PerfSleep)
- **Tagline**: Wake up gently. Feel better, every day.
- **Publisher / Creator**: Penqn (https://penqn.in)
- **Official Website**: https://alarm-clock.app
- **Google Play Store URL**: https://play.google.com/store/apps/details?id=in.penqn.perfsleep
- **Category**: Health & Fitness / Productivity / Clock & Utility
- **Primary Platforms**: Android (Phones & Tablets), Wear OS (Smartwatches), iOS (iPhone), watchOS (Apple Watch)
- **Business Model**: Freemium (Free tier available; Pro upgrade is a one-time $2.99 payment, no recurring subscription)
- **Support Contact**: support@alarm-clock.app
- **Security Contact**: security@penqn.in

---

## 2. Problem Statement & Sleep Science

Traditional alarm clocks produce abrupt, high-decibel auditory shocks. Waking up to sudden loud noises triggers an acute sympathetic nervous system reaction ("fight-or-flight"), causing:
1. **Cortisol Spikes**: Sharp surges in stress hormones that cause morning tachycardia, grogginess, and elevated anxiety.
2. **Severe Sleep Inertia**: When an alarm sounds during Slow-Wave Sleep (Stage 3/4 NREM), the brain struggles to transition to wakefulness, impairing cognitive function for 30 minutes to 2 hours.
3. **Habitual Snoozing**: Abrupt alarms lead users to hit "Snooze" instinctively without conscious awareness, often falling back into fragmented sleep cycles.

### How Gradual Alarm Solves This
Gradual Alarm utilizes a multi-phase waking sequence:
- **Phase 1: The Nudge (Soft Awareness)**: 15–30 minutes before the target time, an ultra-low volume chime or soft vibration gently stimulates the sleeper, easing them out of deep NREM sleep into lighter Stage 1/2 sleep or REM.
- **Phase 2: Gradual Rise**: The audio level increases across intermediate stages, allowing biological wakefulness systems (heart rate, body temperature) to adapt naturally.
- **Phase 3: Target Wake-Up**: By the target wake time, the user is already semi-conscious or alert, eliminating abrupt disorientation.
- **Phase 4: Cognitive Check (Math Challenge)**: To prevent automatic dismissal or drifting back to sleep, the user solves an arithmetic puzzle before the alarm shuts off.

---

## 3. Core Features

### 3.1 4-Stage Progressive Alarms
- The user specifies a target wake time and a warm-up duration.
- The system automatically orchestrates 4 successive alarm stages that step up in sound volume, chime rhythm, and duration.
- Stage 1: Whispering volume (approx. 5–15%).
- Stage 2: Gentle chime (approx. 30–45%).
- Stage 3: Clear wake-up tone (approx. 65–80%).
- Stage 4: Full alarm volume with gradual volume fade-in and persistent alert.

### 3.2 Gradual Volume Fade-In
- Within the final stage, audio never starts at maximum volume; it fades in smoothly over a configurable ramp-up period to avoid startling the user.

### 3.3 Bedtime Reminders & Sleep Hygiene
- Customizable bedtime wind-down notifications based on desired sleep duration (e.g. 7.5 or 8 hours of sleep).
- Sends subtle reminders alerting the user to prepare for rest, helping establish consistent circadian rhythm patterns.

### 3.4 Math Puzzle Dismissal Challenges
- Eliminates "zombie snoozing" and accidental dismissal while half-asleep.
- Requires solving a simple-to-moderate arithmetic problem (e.g., `14 + 27 = ?`) to dismiss the alarm.
- The alarm sound pauses or ducks while the user inputs the answer, but reactivates if abandoned.

### 3.5 Custom Sounds and Nature Soundscapes
- Built-in soothing ambient audio, melodic chimes, and nature soundscapes.
- Support for selecting external audio files and custom system ringtones.

### 3.6 Advanced Vibration Controls
- Fully customizable vibration intensity, rhythm, and pulse patterns.
- Ideal for heavy sleepers, people who are deaf or hard-of-hearing, or partners who want a silent tactile wake-up without disturbing others.

### 3.7 Multiple Active Alarm Profiles
- Support for recurring alarms across specific days of the week (weekdays, weekends, custom days).
- Independent configuration for each alarm profile (different sounds, stage durations, and math challenge toggles).

---

## 4. Platform Availability & Technical Details

| Platform | Support Level | Key Capabilities |
| :--- | :--- | :--- |
| **Android** | Fully Native (Kotlin, Jetpack Compose) | Exact Alarms (`USE_EXACT_ALARM`), Foreground Service with full-screen intent, direct boot awareness, background media playback. |
| **Wear OS** | Native Smartwatch App | Wrist-based haptic wake-up, companion or standalone alarm management. |
| **iOS** | Native iOS App | Critical alerts, local notifications, custom audio playback. |
| **watchOS** | Apple Watch Integration | Haptic taps, synchronized alarm dismissals. |

### Technical Architecture & Reliability:
- **Foreground Service**: Ensures alarms execute reliably on modern battery-saving Android OS versions (Android 12, 13, 14, 15+).
- **Direct Boot Aware**: Can reschedule alarms after an automatic device reboot before the user unlocks the screen.
- **Offline Reliability**: Zero dependence on internet connectivity or cloud servers for alarm execution.

---

## 5. Pricing & Comparison

| Feature | Free Tier | Pro Tier ($2.99 One-Time) |
| :--- | :---: | :---: |
| **Alarm Stages** | 2 Stages | 4 Stages |
| **Gradual Volume Fade** | Included | Included |
| **Vibration Customization** | Included | Included |
| **Bedtime Reminders** | - | Included |
| **Math Puzzle Dismissal** | - | Included |
| **Custom Sounds & Loops** | Limited | All Sounds + Custom Files |
| **Multiple Profiles** | Standard | Unlimited Profiles |
| **Recurring Billing** | None ($0) | None (Single payment forever) |
| **Advertisements** | None | None |

---

## 6. Frequently Asked Questions (FAQ)

### Q: Will the alarm sound if my phone is on "Do Not Disturb" or "Silent"?
**A**: Yes. On Android and iOS, Gradual Alarm uses high-priority alarm channels and audio streams designated for critical alarms, overriding system silent/vibrate switches.

### Q: Does the app track or upload my sleep data?
**A**: No. Gradual Alarm operates strictly on-device. It does not record audio from your room, does not transmit sleep statistics, and does not require an account.

### Q: Is Pro a recurring subscription?
**A**: No. The Pro upgrade is a one-time purchase of $2.99. Once unlocked, all current and future Pro features are yours without monthly or annual fees.

### Q: Does it work with Wear OS and Apple Watch?
**A**: Yes. Gradual Alarm supports both Wear OS and watchOS, delivering gentle tactile haptic taps directly to your wrist.

### Q: Can I use my own music or MP3 files?
**A**: Yes. The sound selector allows picking custom ringtones and supported audio files from your device storage.

### Q: What happens if my device reboots overnight?
**A**: On Android, Gradual Alarm registers `RECEIVE_BOOT_COMPLETED` and utilizes Direct Boot awareness to immediately reschedule all active alarms as soon as the operating system starts up.

---

## 7. Company & Support

- **Parent Organization**: Penqn (https://penqn.in)
- **General Inquiries & Support**: support@alarm-clock.app
- **Vulnerability Reporting**: security@penqn.in
- **Privacy Policy**: https://penqn.in/privacy-policy
- **Terms of Service**: https://penqn.in/tos