📔 Mood - AI-Powered Journal Application

A modern, intelligent journaling application with real-time auto-saving and AI-powered mood analysis

Features • Tech Stack • Getting Started • Architecture • Documentation

🌐 Live Application

Experience Mood in action:

https://mood-five-sigma.vercel.app/

Click the link above to start journaling with AI-powered mood analysis!

✨ Features

🔄 Real-Time Auto-Saving

Write without worry! Your journal entries are automatically saved every 200ms after you stop typing.

Intelligent Debouncing - Prevents excessive saves while typing
Optimistic Updates - Instant UI feedback with save status indicators
Content Preservation - Your text never gets lost, even during navigation
Visual Feedback - Clear saving/saved status with timestamps

🤖 AI-Powered Mood Analysis

Powered by Google's Gemini AI, each entry is automatically analyzed to detect:

Mood Detection - Identifies emotional state (Happy, Anxious, Calm, etc.)
Sentiment Scoring - Quantifies positivity/negativity (-10 to +10 scale)
Subject Extraction - Identifies the main topic of your entry
Smart Summaries - Generates concise one-line summaries
Color Coding - Each mood gets a unique color for visual tracking
Negativity Detection - Flags entries with concerning emotional content

📝 Seamless Entry Management

Intuitive interface for creating and managing your journal entries:

Instant Creation - Start writing immediately, entry saves on first keystroke
Grid View - Beautiful card-based layout of all your entries
Quick Navigation - Click any entry to open and edit
Entry Counter - Track your journaling consistency
Mood Indicators - Visual mood colors on each entry card

🔐 Secure Authentication

Built with Clerk for enterprise-grade security:

User Authentication - Secure sign-up and sign-in
Protected Routes - Middleware ensures only authenticated users access journals
User Isolation - Each user's data is completely private and separated

🎨 Modern UI/UX

Clean, distraction-free writing experience:

Dark Theme - Easy on the eyes for any time of day
Responsive Design - Works beautifully on desktop, tablet, and mobile
Minimalist Editor - Focus on writing without clutter
Live Analysis Panel - Real-time mood insights displayed alongside your entry
Smooth Animations - Polished micro-interactions throughout

🛠️ Tech Stack

Frontend

Next.js 16 - React framework with App Router and Server Components
React 19.2 - Latest React with concurrent features
TypeScript - Type-safe development
Tailwind CSS 4 - Utility-first styling
Lucide React - Beautiful icon library

Backend & Database

Drizzle ORM - TypeScript-first ORM
Neon PostgreSQL - Serverless Postgres database
Zod - Schema validation for AI responses

AI & Analysis

Google Gemini AI - Advanced language model for mood analysis
Custom Prompt Engineering - Optimized prompts for accurate sentiment detection

Authentication

Clerk - Complete user management and authentication

Development Tools

Drizzle Kit - Database migrations
ESLint - Code quality
PostCSS - CSS processing

🚀 Getting Started

Prerequisites

Node.js 20+ installed
PostgreSQL database (we recommend Neon)
Clerk account for authentication
Google Gemini API key

Installation

Clone the repository

git clone https://github.com/Tareq-Bilal/Mood.git
cd mood

Install dependencies
```
npm install
```

Set up environment variables

Create a .env.local file in the root directory:

# Database
DATABASE_URL=your_neon_postgres_connection_string

# Clerk Authentication
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key
CLERK_SECRET_KEY=your_clerk_secret_key
NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up

# Google Gemini AI
GEMINI_API_KEY=your_gemini_api_key

Set up the database
```
npm run db:push
```
Run the development server
```
npm run dev
```
Open your browser

Navigate to http://localhost:3000

Landing Page

Journal Listing

Realtime Journal Analyzing

Auto Saving Feature

Ask About Your Journals

Journals Chart Aanalysis

Bookmarks Listing

---

🏗️ Architecture

Application Flow

┌─────────────────────────────────────────────────────────────┐
│                         User Interface                       │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐      │
│  │ Journal List │  │ Editor Page  │  │ Analysis View│      │
│  └──────────────┘  └──────────────┘  └──────────────┘      │
└───────────────────────────┬─────────────────────────────────┘
                            │
┌───────────────────────────▼─────────────────────────────────┐
│                     API Routes (Next.js)                     │
│  ┌──────────────────────┐  ┌──────────────────────┐         │
│  │ POST /api/journal    │  │ PATCH /api/journal/  │         │
│  │ (Create Entry)       │  │ [id] (Update Entry)  │         │
│  └──────────────────────┘  └──────────────────────┘         │
└───────────────────────────┬─────────────────────────────────┘
                            │
            ┌───────────────┴──────────────┐
            │                              │
┌───────────▼───────────┐     ┌───────────▼────────────┐
│   Database (Neon)     │     │   Google Gemini AI     │
│  ┌─────────────────┐  │     │  ┌──────────────────┐  │
│  │ JournalEntries  │  │     │  │ Mood Analysis    │  │
│  │ JournalAnalysis │  │     │  │ Sentiment Score  │  │
│  │ Users           │  │     │  │ Subject Extract  │  │
│  └─────────────────┘  │     │  └──────────────────┘  │
└───────────────────────┘     └────────────────────────┘

Database Schema

-- Users (managed by Clerk)
Users {
  id: UUID PRIMARY KEY
  clerkUserId: VARCHAR(255) UNIQUE
  email: VARCHAR(255)
  createdAt: TIMESTAMP
  updatedAt: TIMESTAMP
}

-- Journal Entries
JournalEntries {
  id: UUID PRIMARY KEY
  userId: UUID FOREIGN KEY -> Users.id
  content: TEXT
  createdAt: TIMESTAMP
  updatedAt: TIMESTAMP
}

-- AI Analysis Results
JournalAnalysis {
  id: UUID PRIMARY KEY
  entryId: UUID UNIQUE FOREIGN KEY -> JournalEntries.id ON DELETE CASCADE
  mood: VARCHAR(100)
  subject: VARCHAR(255)
  summary: TEXT
  color: VARCHAR(7)  -- Hex color code
  negative: BOOLEAN
  sentimentScore: INTEGER  -- Range: -10 to +10
  createdAt: TIMESTAMP
  updatedAt: TIMESTAMP
}

Key Components

Editor Component (`components/Editor.tsx`)

The heart of the application, featuring:

Real-time auto-save with 200ms debounce
State management for new vs. existing entries
Optimistic UI updates
Smart content preservation during navigation

AI Analysis (`utils/ai.ts`)

Handles mood detection:

Sends entry content to Gemini AI
Validates response with Zod schema
Returns structured analysis data
Error handling for API failures

API Routes

POST /api/journal - Creates new entries
PATCH /api/journal/[id] - Updates entries and triggers AI analysis
Automatic analysis on content changes
Efficient database queries with Drizzle ORM

📖 Documentation

Auto-Save Behavior

The auto-save feature intelligently decides when to save:

Should Save When:
✓ New entry with content (first save creates the entry)
✓ Existing entry with changed content
✓ Not already saving

Skip Save When:
✗ New entry with empty content (no point creating empty entries)
✗ Existing entry with unchanged content
✗ Save operation already in progress

AI Analysis Trigger

Analysis runs automatically but efficiently:

Analysis Triggers:
✓ Entry content changes
✓ Content is not empty

Analysis Skips:
✗ Content unchanged since last analysis
✗ Empty content
✗ API key missing or invalid

State Management Strategy

Component State:
- entryContent: Current textarea value
- entryId: Database ID (null for new entries)
- hasCreated: Boolean flag to prevent re-creation
- isSaving: Visual feedback for save operation
- lastSaved: Timestamp for "Saved at..." message

Refs:
- timeoutRef: Manages debounce timeout
- isCreatingRef: Prevents duplicate creation calls

🎯 Use Cases

Personal Journaling

Daily reflections and thoughts
Mood tracking over time
Identifying emotional patterns

Mental Health Tracking

Monitor sentiment trends
Flag negative emotional states
Track progress in therapy

Creative Writing

Brainstorming and ideation
Capturing fleeting thoughts
Organizing narrative ideas

Professional Logging

Work reflections
Project retrospectives
Learning journal

🔮 Future Enhancements

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📝 License

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

🙏 Acknowledgments

Built with Next.js by Vercel
AI powered by Google Gemini
Authentication by Clerk
Database by Neon
Icons by Lucide

📧 Contact

Tareq Bilal - @Tareq-Bilal

Project Link: https://github.com/Tareq-Bilal/Mood

Made with ❤️ and ☕ by Tareq Bilal

⭐ Star this repository if you find it helpful!

Name		Name	Last commit message	Last commit date
Latest commit History 44 Commits
app		app
components		components
db		db
drizzle		drizzle
lib		lib
public		public
scripts		scripts
utils		utils
.gitignore		.gitignore
BOOKMARKS_IMPLEMENTATION.md		BOOKMARKS_IMPLEMENTATION.md
BOOKMARK_REFACTORING.md		BOOKMARK_REFACTORING.md
FEATURES_DOCUMENTATION.md		FEATURES_DOCUMENTATION.md
README.md		README.md
TOAST_FIX.md		TOAST_FIX.md
components.json		components.json
drizzle.config.ts		drizzle.config.ts
eslint.config.mjs		eslint.config.mjs
index.ts		index.ts
middleware.ts		middleware.ts
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation

📔 Mood - AI-Powered Journal Application

🌐 Live Application

✨ Features

🔄 Real-Time Auto-Saving

🤖 AI-Powered Mood Analysis

📝 Seamless Entry Management

🔐 Secure Authentication

🎨 Modern UI/UX

🛠️ Tech Stack

Frontend

Backend & Database

AI & Analysis

Authentication

Development Tools

🚀 Getting Started

Prerequisites

Installation

Landing Page

Journal Listing

Realtime Journal Analyzing

Auto Saving Feature

Ask About Your Journals

Journals Chart Aanalysis

Bookmarks Listing

🏗️ Architecture

Application Flow

Database Schema

Key Components

Editor Component (components/Editor.tsx)

AI Analysis (utils/ai.ts)

API Routes

📖 Documentation

Auto-Save Behavior

AI Analysis Trigger

State Management Strategy

🎯 Use Cases

Personal Journaling

Mental Health Tracking

Creative Writing

Professional Logging

🔮 Future Enhancements

🤝 Contributing

📝 License

🙏 Acknowledgments

📧 Contact

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Editor Component (`components/Editor.tsx`)

AI Analysis (`utils/ai.ts`)

Packages