{"id":20829401,"url":"https://github.com/aryprogrammer/mindful-app","last_synced_at":"2025-06-25T23:31:56.857Z","repository":{"id":263063809,"uuid":"864043332","full_name":"ARYPROGRAMMER/Mindful-App","owner":"ARYPROGRAMMER","description":"Mindful is a mental wellness app designed to support users in managing stress and anxiety. Powered by advanced AI, it offers personalized advice and a soothing music player for relaxation. Built with Node.js, PostgreSQL, and Firebase, Mindful follows clean architecture principles, ensuring a seamless and user-friendly experience.","archived":false,"fork":false,"pushed_at":"2025-04-11T07:38:03.000Z","size":75067,"stargazers_count":6,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-07T21:39:58.529Z","etag":null,"topics":["anthropic-claude","chatbot-ai","cleanui","dart","express-js","face-emotion-detection","firebase","flutter","gemini-api","google-cloud","groq","llama8b-8192","mistral-api","nodejs-server","oauth2","openai-api","postgresql","redis-database","render-deployment"],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ARYPROGRAMMER.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-09-27T11:41:54.000Z","updated_at":"2025-04-11T07:38:07.000Z","dependencies_parsed_at":"2025-04-11T08:26:20.625Z","dependency_job_id":null,"html_url":"https://github.com/ARYPROGRAMMER/Mindful-App","commit_stats":null,"previous_names":["aryprogrammer/mindful-app"],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/ARYPROGRAMMER/Mindful-App","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ARYPROGRAMMER%2FMindful-App","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ARYPROGRAMMER%2FMindful-App/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ARYPROGRAMMER%2FMindful-App/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ARYPROGRAMMER%2FMindful-App/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ARYPROGRAMMER","download_url":"https://codeload.github.com/ARYPROGRAMMER/Mindful-App/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ARYPROGRAMMER%2FMindful-App/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261972815,"owners_count":23238539,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anthropic-claude","chatbot-ai","cleanui","dart","express-js","face-emotion-detection","firebase","flutter","gemini-api","google-cloud","groq","llama8b-8192","mistral-api","nodejs-server","oauth2","openai-api","postgresql","redis-database","render-deployment"],"created_at":"2024-11-17T23:20:11.504Z","updated_at":"2025-06-25T23:31:56.826Z","avatar_url":"https://github.com/ARYPROGRAMMER.png","language":"Dart","readme":"**IMPORTANT : Backend Services Working**\n\n![Mindful-App](https://socialify.git.ci/ARYPROGRAMMER/Mindful-App/image?description=1\u0026descriptionEditable=Mindful%20is%20a%20mental%20wellness%20app%20designed%20to%20support%20users%20in%20managing%20stress%20and%20anxiety\u0026font=Source%20Code%20Pro\u0026language=1\u0026name=1\u0026owner=1\u0026pattern=Diagonal%20Stripes\u0026stargazers=1\u0026theme=Dark)\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/ARYPROGRAMMER/Mindful-App/actions\"\u003e\n        \u003cimg src=\"https://github.com/travisjeffery/timecop/workflows/CI/badge.svg\" alt=\"Build Status\"/\u003e\n    \u003c/a\u003e\n    \u003cimg src=\"https://img.shields.io/badge/version-2.1.2-green\" alt=\"Version\"/\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/firebase-ffca28?style=for-the-badge\u0026logo=firebase\u0026logoColor=black\" alt=\"Firebase\"/\u003e\n    \u003cimg src=\"https://img.shields.io/badge/LICENSE-MIT-green\" alt=\"License\"/\u003e\n\u003c/p\u003e\n\n\n**AI USED** : LLAMA-8B-8192, FACE EMOTION RECOGNITION MODEL, GEMINI/ANTHROPIC/MISTRAL SUPPORTED (API_KEY REQUIRED)\n\n**APP STATUS** : ALL CORE FUNCTIONALITIES WORKING (Deployed NodeJs \u0026 Postgresql on Render)\n\n## What's New in v2.1.2 (**Stable Release with Redis Phase 3 Integration**)\n\n            - **Improved AI Chat Functionality**\n            - **Redis DS Change - HashMaps**\n            - **Minor Bug fixes**\n            - **Crash Handlers are improved**\n            - **Improved Overall Performance - Implemented Impeller**\n            - **Settings Tab is now Better**\n            - **Redis connection fixes and data privacy improvised**\n            - **Redis Cloud Implementation and Fetching in Beta Phase**\n            - **Added Redis-base to support syncfusion**\n            - **New Feature**: Implemented Syncfusion and Redis for low latency**\n            \n            ### Issues are being Resolved - Redis Full-Integration Phase 3\n\n[DEMO LINK OF WORKING](https://vimeo.com/1016496824?share=copy)\n\n[PRE-PRODUCTION INSIDERS](https://vimeo.com/1013864504)\n\n[Blog Post on dev.to](https://dev.to/aryprogrammer/building-mindful-a-mental-wellness-app-with-nodejs-ai-and-clean-architecture-3n9d)\n\n# Mindful\n\n![Mindful Logo](screenshots/logo.png)  \n\n**Personal Mental Wellness Companion**\n\n## Table of Contents\n\n- [Overview](#overview)\n- [Features](#features)\n- [Technologies Used](#technologies-used)\n- [Architecture](#architecture)\n- [Getting Started](#getting-started)\n- [Usage](#usage)\n- [Contributing](#contributing)\n- [License](#license)\n- [Contact](#contact)\n\n## Overview\nIn a world where stress and anxiety are increasingly common, *Mindful* serves as a sanctuary for mental health. This innovative application empowers users to enhance their well-being through personalized advice and relaxation techniques. By integrating advanced AI technology, *Mindful* provides tools to help users cultivate mindfulness and manage their mental health effectively.\n\n## Features\n- **Personalized Advice**: Experience tailored guidance powered by *LLAMA-8B-8192* (previously : Gemini) (Since its free) an advanced AI fine tuned to understand your unique mental health needs. Use your API_KEY to integrate with Anthropic, OpenAI, and Mistral, enhancing the support provided. **Code is already provided for them**.\n  \n- **Relaxation Music Player**: Immerse yourself in a curated selection of soothing tracks. The built-in music player is designed to help users unwind, recharge, and foster a peaceful environment for relaxation.\n\n- **User-Friendly Interface**: Navigate effortlessly through an intuitive design that makes accessing mental health resources easy and enjoyable.\n\n- **Face Detection Model** : Analyze your mood with your facial expressions, this can be further linked to different services.\n\n  \n![App Screenshot 1](screenshots/onboard_new1.jpg)\n![App Screenshot 2](screenshots/onboard_new2.jpg)\n\u003cimg src=\"screenshots/onboard_new3.jpg\" width=403 height=864\u003e\n![Login / Register](screenshots/dash.jpg)\n\u003cimg src=\"screenshots/sign.jpg\" width=403 height=864\u003e\n\u003cimg src=\"screenshots/register.jpg\" width=403 height=864\u003e\n\u003cimg src=\"screenshots/chat.jpg\" width=403 height=864\u003e\n\u003cimg src=\"screenshots/chat2.jpg\" width=403 height=864\u003e\n\u003cimg src=\"screenshots/song_player_new.jpg\" width=403 height=864\u003e\n\n## Technologies Used\n- **Backend**: \n  - **Node.js**: A powerful JavaScript runtime for building scalable network applications.\n  - **PostgreSQL**: An advanced relational database for storing user data securely.\n  - **Firebase**: A comprehensive platform for building web and mobile applications with real-time data syncing.\n  - **Tensorflow**: To Create the FER Model using FER2013 Dataset.\n\n- **Architecture**: \n  - **Clean Architecture**: Ensures the application is modular and maintainable.\n  - **SOLID Principles**: Follows best practices for software development, promoting scalability and ease of testing.\n\n## Architecture\nThe *Mindful* app employs a clean architecture pattern, allowing for separation of concerns and enhancing maintainability. This design makes the app adaptable to future changes and ensures a robust user experience. By adhering to SOLID principles, *Mindful* promotes best practices that facilitate development and testing.\n\n#### Key Architectural Decisions:\n- **ModelView-ViewModel pattern** to handle user requests and business logic.\n- **Separation of concerns** for better code management and maintainability.\n- **Extensibility** built-in so new AI features and wellness tools can be integrated smoothly in future updates.\n\nTo run *Mindful* locally, follow these steps:\n\n1. **Clone the repository**:\n   ```bash\n   git clone https://github.com/ARYPROGRAMMER/mindful.git\n   cd server/mental-health-api/\n   ```\n\n2. **Install dependencies**:\n   ```bash\n   npm install\n   ```\n\n3. **Setup environment variables (OPTIONAL, USE MINE)**:\n  Changes in API_KEY (if needed) to be done in : \n\n   ```plaintext\n   mental-health-api/\n   ├──...          \n   ├──...         \n   ├──...          \n   ├──...        \n   ├── server.js          # Main server file\n   ├── infrastructure/               \n       ├── geminiai/   \n       ├   └── geminiService.js  # NEW API KEY ADDING SLOT\n       └──── db/    \n              └── index.js  # PostGres Setup\n   \n   ```\n\n4. **Run the Server**: (Not Needed after v1.0.6)\n   ```bash\n   npm start\n   ```\n   \n5. **Run the App**:\n   ```bash\n   cd ../../lib/\n   flutter clean\n   flutter pub get\n   flutter run\n   \n   ```\n   Alternatively you could use :\n   ```bash\n   flutter build apk\n   ```\n5. **Structure of DB**:\n\n    # Songs Table\n    \n        YOU NEED TO CREATE THIS YOURSELF IN POSTGRESQL (Not Needed after v1.0.6)\n    \n        This is the structure of the `songs` table in the `public` schema.\n        \n        | Column   | Type                   | Collation | Nullable | Default                                |\n        |----------|------------------------|-----------|----------|----------------------------------------|\n        | `title`  | `character varying(100)`|           | `false`  |                                        |\n        | `author` | `character varying(100)`|           | `false`  |                                        |\n        | `songlink`| `character varying(256)`|          | `false`  |                                        |\n        | `id`     | `bigint`                |           | `false`  | `nextval('songs_id_seq'::regclass)`    |\n        | `imageid`| `character varying(256)`|           | `true`   |                                        |\n        \n        ### Notes:\n        - The `id` column is auto-incremented using the `nextval('songs_id_seq'::regclass)` function.\n        - `imageid` is optional and can store a link or identifier for the image associated with the song.\n\n    Query:\n\n   `CREATE TABLE public.songs (\n    id BIGSERIAL PRIMARY KEY,\n    title VARCHAR(100) NOT NULL,\n    author VARCHAR(100) NOT NULL,\n    songlink VARCHAR(256) NOT NULL,\n    imageid VARCHAR(256)\n    );\n    `\n\n7.  **PROVIDE CONNECTION IN FLUTTER** : (NOT NEEDED AFTER v1.0.6)\n    \n    ```bash\n    cd lib/features/meditation/data/meditation_remote_source.dart\n    cd lib/features/music/data/song_database.dart\n    ```\n    Give your IPv4 in the Uri.Parse url. (\"mine starts with 192\").\n\n**MORE SCREENSHOTS**\n\n*Model*\n![NEW MODEL](screenshots/new_fer.jpeg)\n\n*Home*\n![App Screenshot 5](screenshots/new_home_loaded.jpg)\n![App Screenshot 5](screenshots/button.jpg)\n\n*Song Playlist*\n![App Screenshot 7](screenshots/playlist.jpg)\n\n*Settings*\n![App Screenshot 8](screenshots/settings.jpg)\n\n*Backend*\n![App Screenshot 9](screenshots/auth.jpg)\n![App Screenshot 9](screenshots/auth2.jpg)\n![App Screenshot 10](screenshots/backend.jpg)\n![App Screenshot 10](screenshots/backend2.jpg)\n\n## Usage\n- Explore all the sections to receive personalized mental health tips based on your needs.\n- Use the music player to listen to relaxing tracks and enhance your mindfulness practice.\n- Explore the FER MODEL Section (NOT Fully Developed).\n\n![Song Player in Action](screenshots/song_playing.mp4)\n\n## References\n- **Machine Learning Model**: [Colab Notebook](https://colab.research.google.com/drive/177N-KOyAHfuTYAC0UyukEh7iiiQLL1jq?usp=sharing)  \n  This notebook contains the ML model used in the app. Feel Free to Clone and Modify.\n\n- **UI Inspiration**: [Figma File](https://www.figma.com/design/WoPdJjhluqyJHHm8FaysPt/Mental-Health-App-Design-(Community)?node-id=0-1\u0026t=BJUL3kdEOYtKaZlw-0)  \n  Explore the Figma file for design inspiration and UI components.\n\n## Contributing\nWe welcome contributions to improve *Mindful*! Please follow these steps:\n1. Fork the repository.\n2. Create a new branch (`git checkout -b feature/YourFeature`) (DONT USE MAIN).\n3. Make your changes and commit them (`git commit -m 'Add some feature'`).\n4. Push to the branch (`git push origin feature/YourFeature`).\n5. Open a Pull Request.\n\n## License\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE.txt) file for details.\n\n## Contact\nFor questions or feedback, please reach out to me at:\n- **Email id**: [arya.2023ug1104@iiitranchi.ac.in](mailto:arya.2023ug1104@iiitranchi.ac.in)\n- **GitHub**: [ARYPROGRAMMER](https://github.com/ARYPROGRAMMER)\n\n---\n*Mindful* - I invite you to join a community focused on mental health and well-being. Together, we can create a positive impact, one mindful moment at a time. PRs ARE APPRECIATED\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faryprogrammer%2Fmindful-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faryprogrammer%2Fmindful-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faryprogrammer%2Fmindful-app/lists"}