Self-hosted home management — totes, todos, and grocery lists.

---

Features

Module	Description
Totes	Label physical storage totes with QR codes. Scan to see contents. Print 4×6 shipping labels.
Todos	Task list with priority levels, due dates, and categories.
Grocery	Plan shopping trips by store and aisle. Check off items as you shop. Searchable item history.

All modules share a single login. First-time setup creates your admin account through a built-in wizard — no seeding scripts required.

---

Quick Start

Requirements

• Docker + Docker Compose v2
• PostgreSQL database (external — not bundled)
• A reverse proxy with a domain/SSL cert (Traefik, Nginx, Caddy, etc.)

# 1. Get the files
git clone https://github.com/JdCpuWiz/home-stack.git
cd home-stack

# 2. Configure
cp .env.example .env
# Edit .env — set DATABASE_URL, NEXTAUTH_SECRET, and NEXTAUTH_URL

# 3. Start
docker compose pull
docker compose up -d

Open your app URL. You'll be redirected to /setup to create your admin account.

See DEPLOY.md for full setup details — environment variables, reverse proxy config, PUID/PGID, and troubleshooting.

---

Updating

docker compose pull
docker compose up -d

Database schema changes are applied automatically on startup. Photos and data are preserved — they live outside the container.

---

Tech Stack

• Next.js 16 (App Router) + TypeScript
• PostgreSQL + Prisma
• NextAuth.js (credentials provider)
• Tailwind CSS + shadcn/ui
• Docker + Docker Compose

---

License

MIT