🧠 Personal Gemini Journal: A Secure AI Reflection App with Gemini, Firebase & Cloud Run
Write → Reflect → Understand → Act
I built Personal Gemini Journal as part of the Google Cloud Run AI Challenge.
Traditional journaling helps us record our thoughts, but it doesn't always help us understand them. I wanted to build a private AI-powered journaling experience where users can reflect, have meaningful conversations with AI, and turn their thoughts into actionable insights.
🎯 Problem Statement
Users often struggle with:
- Understanding recurring thoughts
- Identifying patterns in their reflections
- Organizing complicated thoughts
- Turning reflections into practical actions
- Reviewing their personal growth
- Keeping personal journal data private
Most AI chat applications also aren't designed around persistent, user-isolated reflection sessions.
💡 Solution
Personal Gemini Journal combines private journaling with Google Gemini.
Users can create a reflection session and have a multi-turn conversation with Gemini. After reflecting, the application can generate structured insights from the complete session.
The core experience is:
Write → Reflect → Understand → Act
✨ Key Features
💬 Multi-Turn Gemini Conversations
Users can continue a contextual conversation with Gemini instead of receiving only a single AI response.
🧠 Reflection Insights
Gemini analyzes a completed reflection session and generates:
- Key Insight — the central realization
- Emotional Pattern — a strictly non-clinical observation
- Recurring Theme — an important theme from the reflection
- Action for Tomorrow — a practical next step
- Growth Signal — a potential positive development or learning signal
✨ Session Synthesis
The Synthesis feature creates a higher-level understanding of the complete session, including:
- Focus Title
- Key Themes
- Core Insight
- Perspective
- Actionable Takeaways
💾 Persistent Journal Sessions
Journal sessions and interactions are stored in Cloud Firestore, allowing users to:
- Create multiple sessions
- Reopen previous sessions
- Continue conversations
- Refresh the application
- Sign out and sign back in
- Access previous reflections
🔎 Search & Mood Filtering
Users can search previous reflections and organize them using mood categories.
📋 One-Click Action Copy
The generated Action for Tomorrow can be copied instantly.
📤 Journal Export
Users can export their personal journal data as a JSON archive.
🔐 Security
Privacy is a core part of the application because journal entries can contain personal information.
🔑 Firebase Authentication
Users authenticate through Firebase Authentication with Google Sign-In.
🗄️ User-Isolated Firestore
Journal data is organized using Firebase UID-based paths:
/users/{uid}/sessions
/users/{uid}/interactions
/users/{uid}/insights
Firestore Security Rules enforce that authenticated users can only access their own data.
🔒 Server-Side Gemini API
Gemini requests are handled through the trusted Express backend.
The Gemini API key is kept server-side and is not hardcoded into frontend code.
🔐 Secret Management
The deployment uses secure server-side secret handling with Google Cloud Secret Manager.
🛡️ Input Protection
The backend includes:
- Request validation
- JSON payload validation
- Input length limits
- Server-side sanitization
🏗️ Architecture
┌──────────────────┐
│ USER │
│ BROWSER │
└────────┬─────────┘
│
▼
┌─────────────────────┐
│ React Frontend │
│ React + TypeScript │
└─────────┬───────────┘
│
┌────────────┴────────────┐
│ │
▼ ▼
┌────────────────┐ ┌─────────────────┐
│ Firebase Auth │ │ Express Backend │
│ Google Sign-In │ │ API │
└────────────────┘ └────────┬────────┘
│
▼
┌─────────────────┐
│ Google Gemini │
│ │
│ Chat │
│ Insights │
│ Synthesis │
└─────────────────┘
┌─────────────────────────────┐
│ Cloud Firestore │
│ │
│ UID-based private storage │
└─────────────────────────────┘
│
▼
Google Cloud Run
🔄 Application Flow
User
│
▼
Google Sign-In
│
▼
Private Dashboard
│
▼
Create Reflection
│
▼
Multi-Turn Gemini Conversation
│
▼
Save Session to Firestore
│
├──────────────────┐
▼ ▼
Reflection Session
Insights Synthesis
│ │
└────────┬─────────┘
▼
Actionable Takeaways
│
▼
Persistent Journal
🛠️ Technology Stack
| Technology | Purpose |
|---|---|
| React 19 | Frontend |
| TypeScript | Application development |
| Tailwind CSS | UI styling |
| Lucide React | Icons |
| React Markdown | AI response rendering |
| Express | Backend API |
| Google Gemini | AI reflection and analysis |
@google/genai |
Gemini SDK |
| Firebase Authentication | Google Sign-In |
| Cloud Firestore | Persistent user data |
| Google Cloud Secret Manager | Secret management |
| Google Cloud Run | Deployment |
| Vite | Frontend build |
| esbuild | Backend bundling |
☁️ Google Cloud Run
The application was deployed from Google AI Studio to Google Cloud Run.
Cloud Run Service
personal-gemini-journal
Region
asia-southeast1
Challenge Label
dev-tutorial=cloud-run-ai-challenge
The Cloud Run deployment provides the production environment for the application, while the Express backend handles server-side Gemini requests.
🧪 Testing & Verification
The application was tested for:
- Google Sign-In
- Multi-turn Gemini conversations
- Firestore persistence
- User data isolation
- Reflection Insights
- Session Synthesis
- Search and filtering
- Journal export
- Reload persistence
- Sign-out/sign-in persistence
- Cloud Run deployment
🌐 Live Application
🚀 Live App:
https://personal-journal-491827.ai.studio
💻 Source Code:
https://github.com/Jidnya-0926/personal-gemini-journal
🚀 Future Improvements
- 📊 Personal growth analytics
- 📈 Reflection trend visualization
- 🧠 Long-term reflection pattern detection
- 🔍 Semantic journal search
- 📱 Enhanced mobile experience
- 📅 Daily reflection reminders
- 🗺️ Location-aware journal entries
- 🔔 External notifications
🏆 Google Cloud Run AI Challenge
This project was built for the Google Cloud Run AI Challenge.
The application demonstrates how:
Google Gemini + Firebase Authentication + Cloud Firestore + Express + Google Cloud Run
can be combined to create a secure, authenticated and persistent AI application.
The focus was not just on connecting an AI model to a UI, but on building the surrounding architecture:
Authentication → Authorization → Data Isolation → Secure API Access → AI → Persistent Experience
🙌 Final Thoughts
Personal Gemini Journal is designed to make journaling more than simply storing thoughts.
It helps users pause, explore what they're thinking, recognize meaningful patterns, and identify what they can do next.
Write. Reflect. Understand. Grow.
Top comments (0)