Tranquil Mind - Meditation App

A beautiful and modern meditation app built with Flutter, featuring a clean UI design inspired by popular meditation applications.

Features

• Multi-step Onboarding: Personalized setup experience with progress tracking
• Meditation Library: Browse and filter meditation sessions by category
• Music Library: Ambient sounds and music for relaxation
• Home Screen: Personalized content recommendations with water animation
• Favorites & History: Track your meditation journey
• Settings: Comprehensive customization options
• Multiple Themes: Deep Twilight, Ocean Breeze, and Zen Forest themes

Screenshots

The app features a modern, minimalist design with:

• iPhone-style navigation
• Beautiful category filters with smooth animations
• Network images for enhanced visual appeal
• Responsive layouts for different screen sizes

Getting Started

Prerequisites

• Flutter SDK (latest stable version)
• Dart SDK
• Android Studio / VS Code
• iOS Simulator / Android Emulator

Installation

1. Clone the repository:

git clone https://github.com/yourusername/tranquil-mind.git
cd tranquil-mind

2. Install dependencies:

flutter pub get

3. Run the app:

flutter run

Project Structure

lib/
├── blocs/                 # State management (BLoC pattern)
├── events/               # Event definitions
├── models/               # Data models and state classes
├── repositories/         # Data persistence layer
├── screens/             # UI screens
├── themes/              # App themes and styling
├── widgets/             # Reusable UI components
└── main.dart           # App entry point

Architecture

This app follows the BLoC (Business Logic Component) pattern for state management:

• Events: User interactions and system events
• Blocs: Business logic and state management
• States: UI state representations
• Repository: Data access layer

Dependencies

• flutter_bloc: State management
• equatable: Value equality
• shared_preferences: Local storage
• audioplayers: Audio playback
• flutter_tts: Text-to-speech
• lottie: Animations
• stop_watch_timer: Timer functionality

Contributing

We welcome contributions! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

How to Contribute

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

Development Guidelines

• Follow Flutter/Dart style guidelines
• Write clean, readable code
• Add comments for complex logic
• Test your changes thoroughly
• Update documentation as needed

Roadmap

• Audio playback implementation
• Meditation timer functionality
• User authentication
• Cloud sync
• Social features
• Advanced analytics
• Custom meditation creation

License

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

Acknowledgments

• Flutter team for the amazing framework
• The meditation and wellness community
• Contributors and supporters

Support

If you have any questions or need help, please:

• Open an issue on GitHub
• Check existing issues and discussions
• Join our community discussions

---

Made with ❤️ for the meditation community# Updated Git Configuration