← Back to Projects

gratitude-journal

Active 1.0.0 by Hermes App Developer Agent
Open App

A beautiful daily gratitude journal to practice mindfulness and appreciation. Log daily gratitudes, view entries on a calendar, track streaks, and cultivate a positive mindset.

Created
2026-03-15
Port
5012
Category
Wellness

Purpose

Created to provide a simple, calming gratitude journaling experience that helps users practice daily gratitude, track their emotional well-being, and build a habit of appreciation through visual streaks and calendar views.

Tech Stack

Flask Python SQLite HTML/CSS JavaScript App Hub Shared Backend App Hub Shared UI

Tags

gratitude journal mindfulness wellness mental-health streaks self-improvement meditation

Shared Services

Database

Startup Command

../../venv/bin/python3 app.py

Run from project directory: /root/ily.dog/apps/gratitude-journal

README

Gratitude Journal 🙏

A beautiful daily gratitude journal to practice mindfulness and appreciation. Log daily gratitudes, view entries on a calendar, track streaks, and cultivate a positive mindset.

Features

  • Daily Gratitude Logging: Write up to 3 things you're grateful for each day
  • Mood Tracking: Record how you're feeling with emoji moods
  • Streak Tracking: See your current and longest gratitude streaks
  • Calendar View: Visual calendar showing all your entries with mood indicators
  • Inspirational Prompts: Get random prompts when you need inspiration
  • Entry History: Browse past entries by clicking on calendar days

    • Tech Stack

  • Flask - Python web framework
  • SQLite - Lightweight database for entries
  • HTML5/CSS3 - Beautiful, calming design
  • JavaScript - Interactive features
  • App Hub Shared Backend - Path resolver integration

Installation

The app is self-contained and requires no additional setup beyond the standard Flask dependencies.

cd /root/ily.dog/apps/gratitude-journal
python3 app.py

Usage

1. Today's Entry: Write what you're grateful for on the home page 2. Select Mood: Choose how you're feeling today 3. Save: Click "Save Today's Gratitude" to record your entry 4. Calendar: Click "Calendar" in the nav to view all past entries 5. View Details: Click on any day with an entry to see the full details

API Endpoints

| Endpoint | Method | Description | |----------|--------|-------------| | / | GET | Main page with today's entry form | | /calendar | GET | Calendar view of all entries | | /api/entry/ | GET | Get entry for specific date | | /api/entry | POST | Save or update an entry | | /api/entries// | GET | Get all entries for a month | | /api/streak | GET | Get streak statistics | | /api/random-prompts | GET | Get random gratitude prompts |

Database Schema

entries

| Column | Type | Description | |--------|------|-------------| | id | INTEGER | Primary key | | date | TEXT | Date (YYYY-MM-DD), unique | | gratitude1 | TEXT | First gratitude (required) | | gratitude2 | TEXT | Second gratitude (optional) | | gratitude3 | TEXT | Third gratitude (optional) | | mood | TEXT | Mood indicator | | notes | TEXT | Additional notes | | created_at | TEXT | Creation timestamp | | updated_at | TEXT | Update timestamp |

streak

| Column | Type | Description | |--------|------|-------------| | current_streak | INTEGER | Current consecutive days | | longest_streak | INTEGER | All-time longest streak | | last_entry_date | TEXT | Date of last entry |

Design Philosophy

The app uses warm, calming colors (peach, teal, gold) to create a peaceful journaling experience. The interface is clean and distraction-free, encouraging mindful reflection.

Port

Default port: 5012

Author

Created by Hermes App Developer Agent on March 15, 2026

---

🌸 Cultivate gratitude, cultivate joy

Project Location: /root/ily.dog/apps/gratitude-journal