🌟 SoulLift - Mental Health & Wellness Platform

Your Mental Wellness Journey Starts Here

Providing compassionate mental health support and counseling services to help you live a more fulfilling life.

---

📖 About SoulLift

SoulLift is a comprehensive mental health and wellness platform designed to connect individuals with certified mental health professionals. Our mission is to create a safe space where people can find hope, share their journey, and grow together with courage and positivity.

We believe that mental health is just as important as physical health. By lifting each other up, we rise higher together. SoulLift serves as your reminder that you are never alone, and every small step counts toward healing and happiness.

---

🛠️ Technologies Used

Frontend

• HTML5 - Semantic markup and structure
• CSS3 - Custom styling and animations
• JavaScript - Interactive functionality and dynamic content
• Tailwind CSS - Utility-first CSS framework for responsive design
• Font Awesome - Icon library for enhanced UI
• Google Fonts (Inter, Poppins) - Modern typography

Backend

• PHP - Server-side scripting and logic
• MySQL - Relational database management
• MySQLi - PHP database connection and queries

Libraries & Tools

• jsPDF - Client-side PDF generation for appointment reports
• html2canvas - Advanced rendering capabilities
• AOS (Animate On Scroll) - Smooth scroll animations

Development Environment

• XAMPP - Local development server (Apache + MySQL + PHP)
• phpMyAdmin - Database administration interface

---

✨ Features

🔐 User Authentication & Profile Management

• Secure registration/login for patients and experts
• Profile management with image upload
• Role-based access control

📅 Appointment Booking System

• Browse certified therapists and book appointments
• Real-time schedule availability
• Multiple session types and status tracking

👨‍⚕️ Expert Dashboard

• Professional profiles with credentials
• Schedule management and appointment handling
• Patient booking oversight

📊 Appointment Management

• Calendar view with detailed appointment info
• PDF report generation for records
• Session notes and history tracking

📝 Blog & Content System

• Mental health articles by experts
• User engagement (likes, comments)
• Content categorization and management

🎓 Educational Courses

• Wellness courses and enrollment
• Progress tracking and expert-led content
• User feedback system

🔔 Notifications

• Appointment alerts and system updates
• Personal notification management

🏥 Services Showcase

• Mental health services listing
• Service integration with booking system

📱 Responsive Design

• Mobile-first approach
• Cross-device compatibility

🔒 Security

• Session authentication for Role-based access control and SQL protection
• XSS prevention and secure data handling

---

🚀 Getting Started

Prerequisites

• XAMPP (or similar LAMP/WAMP stack)
• Web browser (Chrome, Firefox, Safari, Edge)
• Text editor (VS Code, Sublime Text, etc.)

Installation Steps

1. Download and Install XAMPP

   Download XAMPP from: https://www.apachefriends.org/
   Install and start Apache and MySQL services
   

2. Clone or Download the Project

   # Option 1: Clone the repository
   git clone https://github.com/yourusername/soullift.git
   
   # Option 2: Download ZIP and extract

3. Move Project to XAMPP Directory

   Copy the entire SoulLift folder to:
   C:\xampp\htdocs\SoulLift (Windows)
   /Applications/XAMPP/htdocs/SoulLift (macOS)
   /opt/lampp/htdocs/SoulLift (Linux)
   

4. Setup Database

   • Open phpMyAdmin in your browser: http://localhost/phpmyadmin
   • Create a new database named soullif_db
   • Import the SQL file: db/soullif_db.sql
   • Verify all tables are created successfully

5. Configure Database Connection

   • Open db/config.php
   • Update database credentials if necessary:

   $host = "localhost";   
   $user = "root";        
   $pass = "";            
   $db   = "soullif_db";

6. Launch the Application

   • Start Apache and MySQL in XAMPP Control Panel
   • Open your browser and navigate to:

   http://localhost/SoulLift/Homepage.php
   

7. Create Test Accounts

   • Register a new user account or use existing demo data
   • Explore the platform features and functionality

📁 Project Structure

SoulLift/
├── db/                          # Database configuration and SQL files
│   ├── config.php              # Database connection settings
│   ├── soullif_db.sql         # Database schema and sample data
│   └── blog_functions.php      # Blog-related database functions
├── resources/                   # Images, logos, and assets
├── uploads/                     # User-uploaded files
│   └── profiles/               # Profile pictures
├── homepage/                    # Additional homepage assets
├── Homepage.php                 # Main landing page
├── login_signup.php            # Authentication page
├── about.php                   # About us page
├── services.php                # Services showcase
├── experts.php                 # Expert profiles listing
├── appointment.php             # Appointment booking
├── user_appointments.php       # User appointment dashboard
├── expert_appointments.php     # Expert appointment management
├── schedule.php                # Schedule management
├── courses.php                 # Course listings
├── course_detail.php           # Individual course details
├── blog.php                    # Blog listing page
├── blog_details.php            # Individual blog post
├── create_blog.php             # Blog creation interface
├── user_profile.php            # User profile management
├── notifications.php           # Notification center
└── README.md                   # This file

---

🎯 Usage Guide

For Patients/Users:

1. Register/Login - Create an account or log in to existing account
2. Browse Experts - View certified therapists and their specializations
3. Book Appointments - Schedule sessions with preferred experts
4. Manage Profile - Update personal information and preferences
5. Access Resources - Read mental health blogs and enroll in courses
6. Track Progress - Monitor appointment history and download reports

For Mental Health Experts:

1. Professional Registration - Create expert profile with credentials
2. Manage Availability - Set schedules and available time slots
3. Handle Appointments - Review and manage patient bookings
4. Content Creation - Write educational blogs and create courses
5. Patient Communication - Interact through the platform's messaging system

---

🤝 Contributing

We welcome contributions to improve SoulLift! Here's how you can help:

1. Fork the repository
2. Create a 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

Areas for Contribution:

• UI/UX improvements
• Security enhancements
• Performance optimizations
• Additional features (video calls, chat system, etc.)
• Bug fixes and testing
• Documentation improvements

---

📄 License

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

---

🆘 Support & Contact

If you encounter any issues or have questions:

• GitHub Issues: Create an issue
• Email: support@soullift.com
• Documentation: Check the /docs folder for detailed guides

---

🙏 Acknowledgments

• Font Awesome for the comprehensive icon library
• Tailwind CSS for the utility-first CSS framework
• jsPDF for client-side PDF generation capabilities
• Google Fonts for beautiful typography options
• All contributors and testers who helped improve this platform

---

🌟 Transform Your Life with SoulLift 🌟

Join thousands who have discovered mental wellness and personal growth through our platform

Your journey to mental wellness starts here!

---

© 2025 SoulLift. All rights reserved. | Mental wellness for everyone