🧠 MindCaps – AI-Powered Psychological Support App

MindCaps is a React Native and Expo mobile application designed as an educational AI-powered psychological reflection and emotional support prototype.

The app allows users to chat with an AI support system, reflect on past and present emotions, visualize emotion analysis, and generate motivational future-self messages through a Flask backend API.

This project is an educational software prototype. It is not a medical device, does not provide diagnosis, and is not a replacement for professional mental health care.

🚀 Project Overview

MindCaps focuses on mobile-first emotional reflection. The frontend connects to the MindCaps Flask backend, which handles AI-generated responses, emotion analysis, crisis keyword detection, guided reflection questions, and future-self message generation.

The application supports both Turkish and English and uses a modular React Native structure with reusable screens, components, services, and language context management.

⚙️ Tech Stack

• React Native
• Expo
• JavaScript
• React Navigation
• Context API
• Firebase Authentication
• Firebase Firestore
• AsyncStorage
• React Native Chart Kit
• Flask REST API integration
• Multilingual support: Turkish and English

💡 Features

• AI-powered supportive chat interface
• Turkish and English language support
• Guided reflection screens
• Past-self and present-self question flow
• Emotion analysis visualization
• Future-self motivational message generation
• User history tracking
• Firebase-based authentication and data storage
• Clean mobile UI with modular navigation

🧩 System Architecture

The project consists of two main layers:

1. Mobile Frontend Built with React Native and Expo. Handles navigation, user interface, authentication, language state, emotional reflection screens, and API communication.

2. Backend API Connected through the MindCaps Flask backend, which provides AI response generation, emotion analysis, guided questions, and future-message endpoints.

🔗 Related Repository

• Backend API: https://github.com/Busrwa/Mindcaps_Backend

🔐 Environment Setup

This repository does not include production secrets or private API keys.

Create a .env file locally using the example below:

API_BASE_URL=http://localhost:5000

FIREBASE_API_KEY=YOUR_FIREBASE_API_KEY
FIREBASE_AUTH_DOMAIN=YOUR_PROJECT.firebaseapp.com
FIREBASE_PROJECT_ID=YOUR_PROJECT_ID
FIREBASE_STORAGE_BUCKET=YOUR_PROJECT.appspot.com
FIREBASE_MESSAGING_SENDER_ID=YOUR_SENDER_ID
FIREBASE_APP_ID=YOUR_APP_ID

🛠️ Getting Started

git clone https://github.com/Busrwa/MindCaps.git
cd MindCaps

npm install
npx expo start

⚠️ Safety Disclaimer

MindCaps is an educational AI-support prototype. It is not intended to diagnose, treat, or replace professional mental health care. In crisis situations, users should contact emergency services or a qualified mental health professional.

📌 Project Type

React Native / AI-Powered Mobile App / Emotional Reflection / Mental Health Support Prototype

📄 License

This project is for academic and portfolio purposes.