MindSync - AI Powered Journaling for Deeper Insights

MindSync is a modern journaling web app powered by AI. It helps users reflect write and grow through structured prompts mood tracking and intelligent summaries — all in a clean distraction-free interface. Designed with mental clarity and user experience in mind MindSync offers personalized insights through natural language processing.

Project Screenshots:

Here are some screenshots of the project:

Landing Page

Landing Page Section 2

Landing Page Section 3

Login

Signup

Verify OTP

Registration Successfull

Dashboard

Create Journal

Journals

View each journal

Calendar

Chatbot

🧐 Features

Here are some of the project's best features:

Journaling

• AI-Powered Prompting – Smart suggestions and reflective questions to help you write meaningfully
• Rich Text Editor – Markdown + plain text support with smooth formatting experience
• Autosave – Entries are saved in real-time to prevent data loss
• Journal History – Access and browse past entries by date or search

Insights & Summarization

• AI Summaries – Get concise summaries of your entries using NLP
• Mood Detection – Automatically detects mood or tone from your writing
• Streak Tracker – Encourages consistent writing with streak and habit visualizations

Authentication & User Management

• Email + OTP Authentication – Simple sign-up and login with email verification
• Google OAuth – Sign in using your Google account
• Session Persistence – Cookie-based secure login with token refresh mechanism

UI & UX

• Step-based Onboarding – Smooth registration experience using multi-step forms
• Responsive Design – Works seamlessly on mobile, tablet, and desktop

Tools and Technologies

• FastAPI Backend – Python-based backend with clean REST APIs
• PostgreSQL & Redis – Robust data storage and caching
• Zustand for State Management – Lightweight and scalable global state in frontend
• TanStack Router – Type-safe, file-based routing
• React Query Auth Integration – Secure token-based data fetching

⚙️ Project Setup

📦 Prerequisites

Make sure you have the following installed before setting up the project:

• pnpm – For frontend package management
• poetry – For backend Python dependency management
• Python 3.10+
• Node.js 18+
• Create a virtual environment for the backend (recommended)

---

🖥️ Frontend Setup

1. Create a .env file in the frontend directory:

   VITE_API_URL=http://localhost:8000/

2. Navigate to the frontend directory:

   cd frontend

3. Install dependencies:

   pnpm install

4. Start the development server:

   pnpm dev

---

Backend Setup

1. Create a .env file in the backend directory with the following format:

   SUPABASE_URL=""
   SUPABASE_KEY=""
   JWT_SECRET=""
   JWT_ALGORITHM=""
   ACCESS_TOKEN_EXPIRE_MINS=""
   REFRESH_TOKEN_EXPIRE_DAYS=""
   RESEND_API_KEY=""
   ENCRYPTION_KEY=""
   UPSTASH_REDIS_URL=""  #https://upstash.com/
   UPSTASH_REDIS_PASSWORD=""
   OTP_EXPIRY_MINS=""
   GOOGLE_CLIENT_ID=""
   GOOGLE_CLIENT_SECRET=""
   GOOGLE_REDIRECT_URI="http://localhost:8000/auth/v1/google/callback"
   VECTOR_MODEL=" "  #Huggingface link https://huggingface.co/sentence-transformers/all-MiniLM-L6-v2"
   GEMINI_KEY=""

2. Navigate to the backend directory:

   cd backend

3. Create and activate a virtual environment (if not already):

   python -m venv .venv
   source .venv/bin/activate  # or .venv\Scripts\activate on Windows

4. Install dependencies using Poetry:

   poetry install

5. Run the backend server:

   poetry run uvicorn app.main:app --reload

💖Like my work?

For any queries related to the project you can mail me at vedant.webb@gmail.com or my friend Mohammed at mohammedrupawala8@gmail.com