=== OxyLeaf - Working and Relaxing App (SaaS ready) ===
Contributors: sakurapixel
Tags: productivity, focus, relaxation, spa, saas
Requires at least: 6.4
Tested up to: 6.9
Stable tag: 1.0.2
Requires PHP: 8.2
License: GPL-3.0-only
License URI: https://www.gnu.org/licenses/gpl-3.0.txt

OxyLeaf helps users improve focus and boost productivity with customizable ambient soundscapes and beautiful backgrounds.

== Description ==

OxyLeaf is a wellness and productivity tool that creates personalised ambient environments for focus, relaxation, and sleep. Built as a modern Single Page Application (SPA), OxyLeaf lets users mix calming sounds like rain, ocean waves, and forest ambience while displaying beautiful backgrounds to create their perfect work or relaxation space.

Think of it as a personal ambient sound studio - create custom playlists that blend multiple sounds together, each with individual volume control, and pair them with stunning visual backgrounds.

[Home](https://sakuraleaf.com/products/oxygen-working-and-relaxing-app-saas-ready/) | [Showcase](https://sakuraleaf.com/showcase/oxygen/) | [Docs](https://sakuraleaf.com/showcase/oxygen/documentation/)

= Key Features =

* **Custom Sound Playlists** - Create and save personalized playlists mixing multiple ambient sounds
* **Individual Volume Control** - Fine-tune each sound's volume in your playlists
* **Beautiful Backgrounds** - Choose from curated images or videos to display while sounds play
* **Playlist Backgrounds** - Set unique backgrounds for each playlist that auto-switch when playing
* **Sleep Mode** - Schedule daily automatic sound fade-out at your bedtime
* **Time & Date Display** - Optional full-screen clock mode
* **User Accounts** - Save your playlists and settings across devices
* **Google Sign-In** - Quick login with your Google account
* **Multi-language Support** - Interface available in multiple languages
* **Clean, Distraction-Free Interface** - Minimalist design that gets out of your way

#### In Pro version
Complete SaaS business in a box. With built-in user management, payment processing via Paddle, multi-language support, and a beautiful single-page application interface, you can launch your own productivity SaaS platform immediately after installation.

* [**Front-end demo**](https://sakuraleaf.com/products/oxygen-working-and-relaxing-app-saas-ready/)
* **Subscription and Payment Processing** (Complete Paddle integration for hassle-free billing)
* **Paddle Billing API** (Full integration with Paddle.com)
* **Free and Pro plans** (Proven freemium business model)
* **Monthly and yearly billing** (Maximise revenue with both options)
* **Trial period support** (Offer free trials to boost conversions)
* **Automatic renewals** (Recurring revenue on autopilot)
* **Cancellation management** (Graceful handling with scheduled downgrades)
* **Global coverage** (Sell in 200+ countries with automatic tax compliance)
* **Admin Pro access grants** (Give complimentary Pro to specific users)
* **Subscription dashboard** (Users can manage their subscription from the app)
* **Premium backgrounds** (Add exclusive content for Pro subscribers)
* **Premium sounds** (Add exclusive sounds for Pro subscribers)

== Installation ==

= Automatic Installation =

1. Log in to your WordPress admin panel
2. Navigate to Plugins > Add New
3. Search for "OxyLeaf - Working and Relaxing App"
4. Click "Install Now" and then "Activate"
5. Go to Settings > OxyLeaf App to configure your frontend page

= Manual Installation =

1. Download the plugin zip file
2. Log in to your WordPress admin panel
3. Navigate to Plugins > Add New > Upload Plugin
4. Choose the downloaded zip file and click "Install Now"
5. Activate the plugin
6. Go to Settings > OxyLeaf App to configure

= Initial Setup =

1. After activation, go to Settings > OxyLeaf App in WordPress admin
2. Select or create a page for the OxyLeaf frontend (you can use homepage)
3. Add some ambient sounds via Sounds > Add New
4. Add backgrounds via Backgrounds > Add New
5. Configure optional settings like Google Sign-In and Cloudflare Turnstile
6. Visit your configured frontend page to access the app

== Frequently Asked Questions ==

= How do I access the OxyLeaf app? =

After activating the plugin, configure the frontend page in Settings > OxyLeaf App. You can set it as your homepage or any page. Visit that page to access the full-screen ambient sound application.

= Do users need to create an account? =

Yes, to create and save playlists users need to sign up. They can register with email or use Google Sign-In for quick access.

= How many playlists users can I create? =

These limits can be adjusted by the site administrator in plugin settings.

= Can users use their own sounds or backgrounds? =

Currently, sounds and backgrounds are managed by the site administrator through the WordPress admin. Users select from the available curated library.

= What is Sleep Mode? =

Sleep Mode allows users to set a daily time (like 10:00 PM) when the sounds will automatically fade out over 30 seconds, helping establish healthy sleep routines.

= Does this work on mobile devices? =

Yes, OxyLeaf is fully responsive and works beautifully on all devices including tablets and smartphones.

= Can I use this offline? =

No, OxyLeaf requires an internet connection to stream sounds and backgrounds.


== Use Cases ==

* **Focus & Deep Work** - Create distraction-free ambient environments perfect for coding, writing, or studying
* **Meditation & Relaxation** - Mix calming sounds with serene backgrounds for meditation sessions
* **Sleep Aid** - Use Sleep Mode to automatically fade sounds at bedtime for better sleep routines
* **Background Ambience** - Display beautiful backgrounds with calming sounds during breaks or downtime
* **White Noise** - Mask distracting office or home noises with customizable ambient soundscapes
* **Creative Work** - Set the perfect mood for design, art, or creative writing sessions

== Admin Features ==

Site administrators have full control over:
* Adding and managing ambient sounds (upload audio files, set icons, organize in categories)
* Curating background library (images and videos with attribution support)
* Setting user limits (max playlists, sounds per playlist)
* Configuring Google Sign-In and Cloudflare Turnstile
* Managing multiple languages and translations
* Choosing default backgrounds
* Customizing frontend page placement

#### Resources
Here are some resources from which you can get sounds and backgrounds:

* [freesound.org (Sounds)](https://freesound.org/)
* [zapsplat.com (Sounds)](https://zapsplat.com/)
* [uppbeat.io (Sounds)](https://uppbeat.io/)
* [elements.envato.com/audio (Sounds)](https://elements.envato.com/audio)
* [unsplash.com (Image backgrounds)](https://unsplash.com/)
* [pexels.com (Video backgrounds)](https://pexels.com/)
* [coverr.co (Video backgrounds)](https://coverr.co/)
* [shutterstock.com (Video and image backgrounds)](https://shutterstock.com/)

> **Tip!** Make sure the sounds and video backgrounds have a perfect loop.

> **Tip!** To obtain the best performance and speed, use AWS S3 storage.  
> There are free solutions out there as plugins. Example:  
> [amazon-s3-and-cloudfront](https://wordpress.org/plugins/amazon-s3-and-cloudfront/)

== External Services ==

This plugin connects to the following external third-party services:

= Google Fonts =

**What it is:** Google Fonts CDN (Content Delivery Network)

= Google Sign-In (Optional) =

**What it is:** Google OAuth 2.0 Authentication Service


= Cloudflare Turnstile (Optional) =

**What it is:** Cloudflare Turnstile CAPTCHA service

**Important:** Google Sign-In and Cloudflare Turnstile are optional features that must be explicitly enabled by the site administrator in Settings > OxyLeaf App. They are disabled by default and will not connect to external services unless configured with API credentials.


== Credits (third-party libraries) ==
* [Bootstrap](https://getbootstrap.com/)
* [Google Fonts](https://fonts.google.com)
* [Flag-icons](https://github.com/lipis/flag-icons)
* [Toastr](https://github.com/CodeSeven/toastr)
* [Select2](https://github.com/select2/select2)

== Screenshots ==

1. Frontend look and feel
2. Frontend - logged in user
3. App Settings 
4. App media (backgrounds)
5. App sounds

== Changelog ==

= 1.0.1 =
* Update readme and plugin name.

= 1.0.0 =
* Initial release of OxyLeaf - Create personalized ambient sound environments for focus, relaxation, and sleep.
