Skip to content

About

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

12 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌿 Calm Corner - Your Personal Mindfulness Companion

Calm Corner Banner Version License

🧘‍♀️ Find your inner peace, one breath at a time 🌸

Welcome to Calm Corner - a beautifully crafted web application designed to bring tranquility, mindfulness, and balance to your daily life. Whether you're looking to practice breathing exercises, journal your thoughts, track your mood, or simply enjoy some inspirational wisdom, Calm Corner is here to guide you on your journey to inner peace. ✨


📑 Table of Contents


✨ Features

Calm Corner is packed with powerful features to support your mental wellness journey:

🏠 Home Dashboard

  • 🌸 Welcoming interface with calming visuals
  • 🖼️ Beautiful nature imagery to set a peaceful tone
  • 🎯 Quick access to all mindfulness tools

🌬️ Breathing Exercises

  • 🫁 Interactive guided breathing animations
  • ⏱️ Customizable breathing patterns (Inhale → Hold → Exhale)
  • 🎨 Visual breathing circle that expands and contracts
  • 🧘 Perfect for stress relief and relaxation

💭 Inspirational Quotes

  • ✨ Curated collection of wisdom from mindfulness masters
  • 🔄 Random quote generator for daily inspiration
  • 💫 Beautiful quote display with elegant styling
  • 🌟 Quotes from Buddha, Dalai Lama, Thich Nhat Hanh, and more

📖 Personal Journal

  • ✍️ Private space to write your thoughts and reflections
  • 💾 Local storage saves all your entries
  • 📅 Timestamped entries for tracking your journey
  • ✏️ Edit and delete entries as needed
  • 🎯 Motivational quotes to inspire your writing
  • 🌸 "Your journal is your sanctuary" - write freely!

😊 Mood Tracker

  • 📊 Track your emotional well-being daily
  • 😊😌😢 Three mood options: Happy, Calm, and Sad
  • 📈 Visual mood analytics with beautiful charts
    • 🥧 Pie Chart: See mood distribution at a glance
    • 📉 Line Chart: Track mood trends over time
  • 🔥 Mood Streak Counter: Track consecutive days of mood logging
  • ⭐ Top Mood Insights: See your most common mood
  • 📊 Statistics Dashboard: Total entries, streaks, and patterns
  • 🎨 Color-coded mood logging (Yellow, Green, Blue)
  • 💡 Personalized suggestions based on your mood
  • 🗓️ Complete mood history with timestamps
  • 🌈 Understand your emotional patterns better

🌲 Calm Nature

  • 🌿 Placeholder for nature-inspired content
  • 🎵 Future: Calming sounds and nature videos
  • 🏞️ Future: Immersive nature experiences

🤖 Chatbot Companion

  • 💬 Simple AI chatbot for emotional support
  • 🌿 Empathetic responses to your messages
  • 💙 Understanding reactions to different emotions
  • 🗨️ A friendly ear when you need someone to listen

📧 Contact Form

  • 📮 Easy way to reach out with feedback
  • ✅ Form validation for all inputs
  • 💌 Beautiful submission confirmation
  • 🎯 Connect with the Calm Corner team

📱 Responsive Design

  • 📱 Works beautifully on mobile, tablet, and desktop
  • 🎨 Elegant and calming color scheme
  • ✨ Smooth animations and transitions
  • 🌈 Accessible and user-friendly interface

🎯 Why Calm Corner?

In today's fast-paced world, mental wellness often takes a backseat. Calm Corner provides:

  • ✅ Privacy First: All your data stays on your device (localStorage)
  • ✅ No Sign-up Required: Start your mindfulness journey immediately
  • ✅ Completely Free: 100% free to use, no hidden costs
  • ✅ Simple & Intuitive: Clean interface, easy to navigate
  • ✅ Science-Backed: Features based on proven mindfulness techniques
  • ✅ Always Available: Access your calm space anytime, anywhere

🚀 Getting Started

Getting started with Calm Corner is super easy! No complex setup, no installations - just open and start your mindfulness journey! 🎉

Prerequisites

All you need is:

  • 🌐 A modern web browser (Chrome, Firefox, Safari, Edge)
  • 💻 Any device (Desktop, Laptop, Tablet, or Smartphone)
  • ❤️ A willingness to prioritize your mental wellness

That's it! No Node.js, no npm, no build tools required! 🎊


💻 Installation

Option 1: Clone the Repository 📥

# Clone this repository
git clone https://github.com/lewiii254/calm-conner.git

# Navigate to the project directory
cd calm-conner

# Open index.html in your browser
# On macOS:
open index.html

# On Linux:
xdg-open index.html

# On Windows:
start index.html

Option 2: Download ZIP 📦

  1. Click the green "Code" button on GitHub
  2. Select "Download ZIP"
  3. Extract the ZIP file
  4. Open index.html in your favorite browser

Option 3: Use a Local Server 🖥️

# If you have Python installed:
python -m http.server 8000

# Or if you have Node.js:
npx http-server

# Then open: http://localhost:8000

🎨 Usage Guide

🏠 Home Section

Start here to get an overview of Calm Corner and its mission to bring peace to your life.

🌬️ Breathing Exercises

  1. Click the "Breathing" tab in the navigation
  2. Press the "Start" button
  3. Follow the visual cues:
    • 🌬️ Inhale - Watch the circle expand
    • ✋ Hold - Pause with the circle
    • 😌 Exhale - Watch the circle contract
  4. Press "Stop" when you're done

💭 Getting Quotes

  1. Navigate to the "Quotes" section
  2. Click "✨ New Quote" for fresh inspiration
  3. Reflect on the wisdom shared

📖 Journaling

  1. Go to the "Journal" tab
  2. Write your thoughts in the text area
  3. Click "Save Entry" to save
  4. View past entries by clicking "📖 View Past Entries"
  5. Edit or delete entries as needed

😊 Tracking Your Mood

  1. Visit the "Mood" section
  2. Select how you're feeling:
    • 😊 Happy - Feeling great!
    • 😌 Calm - Feeling peaceful
    • 😢 Sad - Feeling down
  3. Read the personalized suggestion
  4. View your mood history and analytics
  5. Check out the beautiful charts showing your patterns
  6. Track your mood streak and statistics

🤖 Chatbot

  1. Click the "Chatbot" tab
  2. Type a message about how you're feeling
  3. The bot will respond with empathy and support
  4. Continue the conversation as long as you need

📧 Contact

  1. Navigate to "Contact" section
  2. Fill in your name, email, and message
  3. Click "Send Message"
  4. We'll get back to you soon! 💌

🛠️ Tech Stack

Calm Corner is built with simplicity and elegance using:

Frontend Technologies

  • 🎨 HTML5 - Semantic markup for structure
  • 💅 CSS3 - Custom styles with beautiful animations
  • ⚡ Vanilla JavaScript - Pure JS, no frameworks needed
  • 📊 Chart.js - Beautiful, responsive charts for mood analytics

Storage

  • 💾 LocalStorage API - Client-side data persistence
    • Journal entries
    • Mood history
    • User preferences

Design Principles

  • 🎨 Minimalist UI/UX
  • 🌈 Calming Color Palette
  • ✨ Smooth Animations
  • 📱 Mobile-First Responsive Design

External Libraries

  • 📊 Chart.js (via CDN) - For mood visualization charts

📸 Screenshots

Note: Experience Calm Corner live by opening the application! Screenshots showcase the beautiful interface and features.

🏠 Home Page

Welcome to your personal mindfulness sanctuary

🌬️ Breathing Exercise

Interactive breathing guide with visual animations

📖 Journal Section

Your private space for thoughts and reflections

😊 Mood Tracker

Beautiful analytics and insights into your emotional patterns

💭 Quotes

Daily inspiration from mindfulness masters


🌟 Key Highlights

🔒 Privacy & Security

  • 🏠 All data stored locally on your device
  • 🔐 No server uploads, no tracking
  • 👤 Complete anonymity

🎯 User Experience

  • ⚡ Lightning-fast performance
  • 🎨 Beautiful, calming design
  • 📱 Works offline (once loaded)
  • 🌐 Cross-browser compatible

💡 Smart Features

  • 🔄 Auto-rotating motivational quotes
  • 📊 Advanced mood analytics with charts
  • 🔥 Streak tracking for consistency
  • 💾 Automatic save functionality
  • ✨ Smooth transitions and animations

🌱 Growing Platform

  • 🚀 Regular updates planned
  • 🎵 Future: Nature sounds integration
  • 🎥 Future: Guided meditation videos
  • 🌍 Future: Multi-language support

🤝 Contributing

We welcome contributions from the community! 🎉 Here's how you can help make Calm Corner even better:

Ways to Contribute

  1. 🐛 Report Bugs: Found a bug? Open an issue!
  2. 💡 Suggest Features: Have an idea? We'd love to hear it!
  3. 📝 Improve Documentation: Help make our docs clearer
  4. 🎨 Design Improvements: Enhance the UI/UX
  5. 💻 Code Contributions: Submit pull requests

Contribution Steps

# 1. Fork the repository
# 2. Create your feature branch
git checkout -b feature/AmazingFeature

# 3. Commit your changes
git commit -m 'Add some AmazingFeature'

# 4. Push to the branch
git push origin feature/AmazingFeature

# 5. Open a Pull Request

Contribution Guidelines

  • ✅ Write clear, concise commit messages
  • ✅ Follow the existing code style
  • ✅ Test your changes thoroughly
  • ✅ Update documentation as needed
  • ✅ Be respectful and constructive

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

What this means:

  • ✅ Free to use for personal and commercial projects
  • ✅ Modify and distribute as you wish
  • ✅ No warranty provided
  • ✅ Must include original license and copyright

📧 Contact

Have questions, feedback, or just want to say hi? 👋

Get in Touch

Report Issues

Found a bug or have a feature request?


🙏 Acknowledgments

Special thanks to:

  • 🙏 Buddha, Dalai Lama, Thich Nhat Hanh - For timeless wisdom
  • 💚 Open Source Community - For amazing tools and inspiration
  • 📊 Chart.js Team - For the beautiful charting library
  • 🌟 All Contributors - For making Calm Corner better
  • ❤️ You - For choosing to prioritize your mental wellness

🌟 Star This Repo!

If Calm Corner helped bring peace to your day, please consider:

  • ⭐ Giving this repo a star
  • 🔀 Forking it to customize for yourself
  • 📢 Sharing it with friends who need some calm

🧘 Final Words

"Peace comes from within. Do not seek it without." - Buddha

Remember, taking care of your mental health is not a luxury—it's a necessity. Whether you spend 2 minutes or 20 minutes in Calm Corner, every moment of mindfulness counts.

Take a deep breath, be present, and embrace the calm. 🌿✨

Made with 💚 and mindfulness


📊 Project Stats

GitHub stars GitHub forks GitHub issues GitHub pull requests


⬆ Back to Top

About

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages