🌟 Tember

Your AI Mental Health Companion

📖 About Tember

Tember is an AI mental health companion mobile app designed to be an empathetic and supportive friend to talk to. This application helps users with:

• 🤖 Chat with an AI Companion - Talk with Tember, an empathetic and attentive AI.
• 📊 Mood Tracking - Track and analyze daily mood changes.
• 📝 Digital Journaling - Write and store daily notes securely.
• 🧠 Self-Assessment - Evaluate yourself to understand your mental state.
• 📈 Analytics & Insights - Visualize mood data and personal progress.
• 🎙️ Voice Integration - Features speech-to-text and text-to-speech capabilities.

✨ Key Features

🤖 AI Chat Companion

• Natural conversations with an emotion-aware AI.
• 24/7 emotional support.
• Responses tailored to the user's mood.
• Securely saved conversation history.

📊 Mood Tracking

• Daily mood input with emojis and descriptions.
• Analysis of factors influencing your mood.
• Mood graphs and statistics over time.
• Filter by date and time period.

📝 Digital Journal

• A user-friendly interface for writing.
• Local storage with cloud backup.
• Search and categorization of entries.
• Guaranteed data privacy and security.

🧠 Self-Assessment

• Validated psychological questionnaires.
• Assessment results with actionable insights.
• Track your progress over time.
• Recommendations based on your results.

🛠️ Tech Stack

Frontend

• Flutter 3.8.1+ - Cross-platform mobile framework
• Dart - Programming language
• Material Design 3 - Modern UI components
• BLoC Pattern - State management
• Go Router - Navigation management

Backend & Services

• Supabase - Backend-as-a-Service (Authentication, Database, Storage)
• DeepSeek AI - Large Language Model for the AI chat
• SQLite - Local database storage
• Shared Preferences - Local data persistence

Core Packages

dependencies:
  flutter_bloc: ^8.1.6        # State management
  go_router: ^14.2.7         # Navigation
  supabase_flutter: ^2.6.0   # Backend services
  sqflite: ^2.3.3+1          # Local database
  dio: ^5.7.0                # HTTP client
  speech_to_text: ^7.0.0     # Voice input
  flutter_tts: ^4.1.0        # Text-to-speech
  fl_chart: ^0.69.0          # Data visualization
  shimmer: ^3.0.0            # Loading animations

🚀 Installation and Setup

Prerequisites

• Flutter SDK 3.8.1 or newer
• Dart SDK 3.8.1 or newer
• Android Studio / VS Code
• Git

1. Clone the Repository

git clone [https://github.com/yourusername/tember-application.git](https://github.com/yourusername/tember-application.git)
cd tember-application

2. Install Dependencies

flutter pub get

3. Setup API Keys

DeepSeek AI Setup

1. Visit the DeepSeek Platform
2. Create an account and get your API key.
3. Edit lib/src/core/constants/app_constants.dart:

static const String deepSeekApiKey = 'your-deepseek-api-key-here';

Supabase Setup

1. Create a project on Supabase
2. Get your project URL and anon key.
3. Update the configuration in app_constants.dart:

static const String supabaseUrl = 'your-supabase-url';
static const String supabaseAnonKey = 'your-supabase-anon-key';

4. Run the Application

flutter run

📱 Platform Support

• ✅ Android (API 21+)
• ✅ iOS (iOS 12.0+)
• ✅ Web (Progressive Web App)
• ✅ Windows (Desktop)
• ✅ macOS (Desktop)
• ✅ Linux (Desktop)

🏗️ Application Architecture

lib/
├── main.dart                 # Entry point
└── src/
    ├── app.dart              # Main app configuration
    ├── core/                 # Core utilities
    │   ├── constants/        # App constants
    │   ├── router/           # Navigation setup
    │   └── providers/        # Global providers
    ├── features/             # Feature modules
    │   ├── auth/             # Authentication
    │   ├── chat/             # AI Chat functionality
    │   ├── mood/             # Mood tracking
    │   ├── journal/          # Digital journaling
    │   ├── self_assessment/  # Self assessment tools
    │   ├── home/             # Home dashboard
    │   ├── onboarding/       # User onboarding
    │   └── navigation/       # Bottom navigation
    └── shared/               # Shared components
        ├── services/         # Business logic services
        ├── widgets/          # Reusable UI components
        └── models/           # Data models
assets/                       # Static assets
├── images/
├── animations/
└── fonts/

🔒 Security & Privacy

• End-to-end encryption for sensitive data.
• Local-first storage for personal data.
• Secure API communication with HTTPS.
• No data sharing with third parties without user consent.
• GDPR compliant data handling.

🧪 Testing

# Run unit tests
flutter test

# Run integration tests
flutter test integration_test/

# Generate coverage report
flutter test --coverage

📦 Build for Production

Android (APK)

flutter build apk --release

Android (App Bundle)

flutter build appbundle --release

iOS

flutter build ios --release

Web

flutter build web --release

🤝 Contributing

1. Fork this repository.
2. Create your feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes (git commit -m 'Add amazing feature').
4. Push to the branch (git push origin feature/amazing-feature).
5. Open a Pull Request.

📄 License

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

---

<div align="center"> <p><strong>Made with ❤️ for better mental health</strong></p> <p>© 2025 Tember. All rights reserved.</p> </div>