Mood

Mood is a self-hostable and fully anonymous polling platform for teams.

Overview

This platform allows an administrator to create polling campaigns to gauge team morale. The main features are:

• Administrator Dashboard: A central interface to create, manage, and view campaigns.
• Anonymous Participation: Voting is 100% anonymous to ensure honest feedback.
• Segmented Links: Generate unique links for each manager or team to distribute.
• Results Visualization: Analyze feedback through a clean dashboard with filters and CSV export.

Documentation

For a full guide on usage, development, and architecture, please visit the Official Documentation Website.

Tech Stack

• Framework: Next.js 16 (App Router)
• Runtime / Package Manager: Bun
• API: tRPC
• Database: PostgreSQL with Prisma ORM
• Cache / Queue-ready: DragonflyDB (Redis-compatible)
• Authentication: Better Auth
• UI: Tailwind CSS with shadcn/ui

Production Deployment

This section describes how to deploy the application in a production environment using Docker.

System Requirements

• Git
• Docker
• Docker Compose

Quick Start: One-line install and deploy

Works from a clean machine: it clones the repo, prepares .env from .env.example when missing, applies optional overrides, then runs the production deploy script.

bash <(curl -fsSL https://raw.githubusercontent.com/Priveetee/Mood/main/scripts/install-stack.sh)

When passing options to the one-liner, keep the -- separator:

bash <(curl -fsSL https://raw.githubusercontent.com/Priveetee/Mood/main/scripts/install-stack.sh) -- --dir ~/mood-prod --project-name mood-prod --web-port 3010 --db-port 5460

Download or update sources without deploying:

bash <(curl -fsSL https://raw.githubusercontent.com/Priveetee/Mood/main/scripts/install-stack.sh) -- --dir ~/mood-prod --download-only

1. Clone the Repository

git clone https://github.com/Priveetee/Mood.git
cd Mood

2. Configure the Application

Create your environment configuration file by copying the example:

cp .env.example .env

Next, open the .env file and set the variables. It is critical to replace the default example values with your own secure secrets for production.

Variable	Description	Example
COMPOSE_PROJECT_NAME	Compose project name for isolated stacks.	mood
WEB_PORT	Host port exposing the web app container.	3001
POSTGRES_USER	The username for your database.	mood_user
POSTGRES_PASSWORD	A strong, unique password for the database user.	your_strong_password_here
POSTGRES_DB	The name of the database.	mood_db
EXPECTED_DATABASE_NAME	Optional startup safety check: app refuses boot if connected DB name differs.	mood_db
POSTGRES_PORT	The external port on your host machine to map to the database container.	5450
DATABASE_URL	Database connection string used by Prisma and app runtime.	postgresql://mood_user:...@postgres:5432/mood_db
JWT_SECRET	A long, random secret for signing session tokens.	generate_a_long_random_string
INVITATION_KEY	A secret key required for the initial administrator registration to secure the setup.	another_secret_string
BETTER_AUTH_SECRET	Better Auth secret for session security.	generate_a_long_random_string
BETTER_AUTH_URL	Public auth callback base URL used by Better Auth. Must match the exposed web URL/port.	http://localhost:3001
DRAGONFLY_URL	Redis-compatible connection URL for Dragonfly.	redis://dragonfly:6379
NEXT_PUBLIC_APP_URL	The public URL where your application will be accessible. Must match the exposed web URL/port.	http://localhost:3001

Generating Secrets: For all secret values, we recommend generating a long, random string. You can use a password manager or a command like openssl rand -base64 32.

3. Run the Application

This command will build the Docker images and start all services in the background. The web app is exposed on host port 3001 by default. Keep WEB_PORT, BETTER_AUTH_URL, and NEXT_PUBLIC_APP_URL aligned to avoid auth origin errors. The entrypoint.sh script performs a DB readiness check, validates the expected database name when configured, then applies Prisma migrations automatically.

docker compose up --build -d

Automated production deploy script

Recommended for server updates. The script can pull latest code, create a backup (backups/*.dump), rebuild/restart the web service, and run a final HTTP smoke check.

bash scripts/deploy-prod.sh

With local uncommitted changes on server:

bash scripts/deploy-prod.sh --stash-dirty

Useful flags:

bash scripts/deploy-prod.sh --skip-backup
bash scripts/deploy-prod.sh --skip-pull
bash scripts/deploy-prod.sh --ref main --remote origin

Services started by default:

• PostgreSQL
• DragonflyDB
• Mood web app

Your application will be available at the URL you configured in NEXT_PUBLIC_APP_URL.

---

Development Setup

If you wish to contribute to the code, follow these steps to set up a local development environment.

Prerequisites include Bun and Docker. For a detailed walkthrough, please see the Project Setup guide in our documentation.

1. Install dependencies: bun install
2. Start infrastructure: docker compose up -d postgres dragonfly
3. Apply migrations: bunx prisma migrate dev
4. Run the dev server: bun run dev

---

Managing the Application

• Stopping: To stop the application, run: docker compose down
• Updating: To update to the latest version, pull the latest code and rebuild the images:

  git pull origin main
  docker compose up --build -d

Acknowledgements

This application was built using fantastic open-source tools and resources. Special thanks to:

• shadcn/ui
• ReactBitsDev