Quiet Thanks

A calm, private gratitude and mood log. No streaks, no gamification—just a simple way to reflect on what you're grateful for.

Features

• Quick check-in: One prompt, optional mood, optional tags. Entry capture takes 10-20 seconds.
• Autosave: No save button needed. Your entry saves automatically as you type.
• Timeline: View all entries in reverse chronological order with filters.
• Weekly reflection: See your entry count and top tags from the past 7 days.
• Export: Download all entries as Markdown or JSON.
• Dark mode: Calm, minimal interface with soft colors.
• Self-hosted: Your data stays on your server.

Quick Start

Docker (Recommended)

docker compose up -d

The app will be available at http://localhost:6124.

Manual Setup

1. Install dependencies:

   npm install
   

2. Generate and run database migrations:

   npm run db:generate
   npm run db:migrate
   

3. Start the development server:

   npm run dev
   

4. Open http://localhost:3000 in your browser.

Development

# Install dependencies
npm install

# Generate database migrations after schema changes
npm run db:generate

# Run migrations
npm run db:migrate

# Start dev server
npm run dev

# Build for production
npm run build

# Start production server
npm start

# View database with Drizzle Studio
npm run db:studio

Database

• Location: ./data/quietthanks.db (SQLite)
• Environment variable: DATABASE_PATH to customize location
• Migrations: Stored in ./drizzle/

The database is created automatically when you run migrations. In Docker, the ./data directory is mounted as a volume to persist data.

Schema

• entries: Main gratitude entries with date, text, optional mood (1-5), rough day flag, and timestamps
• tags: Normalized tag names
• entry_tags: Junction table linking entries to tags

Export

Navigate to /export or use the Export tab to download your data:

• Markdown: Human-readable format, grouped by date, includes mood and tags
• JSON: Full data export with all fields and timestamps

Exports include all entries regardless of filters.

Configuration

App Name

Change the app name by editing src/lib/constants.ts:

export const APP_NAME = "My Gratitude Log";

Port

In docker-compose.yml, change the port mapping:

ports:
  - "8080:3000"  # Change 8080 to your desired port

Tech Stack

• Framework: Next.js 16 with App Router
• Language: TypeScript
• Styling: Tailwind CSS 4
• Database: SQLite with Drizzle ORM
• Icons: Lucide React

Future Extension Points

These features are not implemented but the architecture supports them:

• Cloud sync: Add authentication and a sync service to enable cross-device access
• LLM summaries: Integrate with an LLM API to generate monthly reflections
• Notifications: Add push notifications for daily reminders
• Import: Add an import endpoint to restore from JSON exports

License

MIT