Skip to content

Latest commit

 

History

History
111 lines (79 loc) · 4.88 KB

README.md

File metadata and controls

111 lines (79 loc) · 4.88 KB
Raw

Alpha Cycle Sleep Calculator

Description

The Alpha Cycle Sleep Calculator is a simple, web-based tool designed to help users plan their sleep schedule around natural sleep cycles. By aligning with 90-minute sleep cycles, this calculator assists users in choosing optimal times to go to bed or wake up, ensuring a more restful and rejuvenating sleep experience. This tool is ideal for anyone looking to improve their sleep quality by timing their sleep in sync with natural cycles, allowing them to wake up at the end of a sleep cycle and feel more refreshed.

Features

  • Optimal Wake-up Time Calculator: Enter your planned bedtime, and the calculator provides several ideal wake-up times to choose from.
  • Ideal Bedtime Calculator: If you know when you need to wake up, the calculator suggests optimal times to go to bed.
  • Adjustable Sleep Preparation Time: Customize how long it typically takes you to fall asleep (default is 15 minutes).
  • Responsive Design: The application is fully responsive and adapts to different screen sizes, making it user-friendly on both desktop and mobile devices.
  • Clean, Easy-to-use Interface: Designed for simplicity, the interface is intuitive and straightforward, suitable for users of all ages.

How It Works

Sleep cycles typically last around 90 minutes, during which the body moves through various stages of light and deep sleep. The Alpha Cycle Sleep Calculator helps users time their sleep by providing wake-up or bedtime suggestions in multiples of 90-minute cycles. This way, users can wake up at the end of a sleep cycle rather than in the middle of one, minimizing grogginess.

For example, if a user goes to bed at 10:00 PM, the calculator might suggest wake-up times of 11:30 PM, 1:00 AM, 2:30 AM, and so on, up to 7 cycles (approximately 10.5 hours of sleep).

Usage

To use the Alpha Cycle Sleep Calculator:

  1. Choose Your Goal:
    • If you know when you plan to sleep, select the Wake-Up Time Calculator.
    • If you know when you need to wake up, select the Bedtime Calculator.
  2. Enter Your Time:
    • For the Wake-Up Time Calculator, enter your planned bedtime.
    • For the Bedtime Calculator, enter your desired wake-up time.
  3. Adjust Fall Asleep Time (Optional):
    • Modify the "Time to Fall Asleep" setting based on how long it usually takes you to fall asleep.
  4. Calculate:
    • Click on Calculate to see a list of recommended times based on 1 to 7 sleep cycles.
  5. View Suggestions:
    • The results will display a series of optimal times, helping you to maximize your rest.

Technologies Used

This web application is built with:

  • HTML5: Provides the structure of the application.
  • CSS3: Styles the application for a clean and responsive user experience.
  • JavaScript: Implements the sleep cycle logic and interactive elements, calculating the optimal sleep and wake-up times.

Installation

No additional setup is needed to use the Alpha Cycle Sleep Calculator. To use the app locally, simply clone the repository and open index.html in your preferred web browser.

Steps

  1. Clone the repository to your local machine. 
    git clone https://github.com/yourusername/alpha-cycle-sleep-calculator.git
  2. Navigate to the project directory. 
    cd alpha-cycle-sleep-calculator
  3. Open index.html in your web browser. 
    open index.html

Folder Structure

  • index.html: Main HTML file containing the structure of the application.
  • style.css: Contains all the CSS styles for the application.
  • script.js: JavaScript file containing the sleep cycle calculation logic and interactivity.

Contributing

We welcome contributions to enhance the Alpha Cycle Sleep Calculator! If you'd like to contribute:

  1. Fork the Repository.
  2. Create a New Branch: 
    git checkout -b feature-branch
  3. Commit Your Changes: 
    git commit -m 'Add new feature'
  4. Push the Branch: 
    git push origin feature-branch
  5. Open a Pull Request on GitHub.

For more details on how to contribute, check out the Issues page for current feature requests and bug reports.

License

This project is licensed under the MIT License. For more information, please refer to the LICENSE file.

Acknowledgments

The Alpha Cycle Sleep Calculator is inspired by the science of sleep cycles and the benefits of waking up at the end of a sleep cycle. Special thanks to those who contributed to the design and development of the project.

Contact

For any questions, feedback, or suggestions, feel free to reach out:

Alpha Cycle Sleep Calculator - Helping you wake up refreshed by aligning with your natural sleep cycles.