wishlist/SETUP.md

Setup Guide

Docker (Recommended)

docker-compose up -d
docker-compose exec app bun run db:push

Visit http://localhost:3000

Local Development

1. Install PostgreSQL

Choose one:

Local PostgreSQL:

sudo apt install postgresql
sudo -u postgres createdb wishlist
sudo -u postgres psql
CREATE USER wishlistuser WITH PASSWORD 'password';
GRANT ALL PRIVILEGES ON DATABASE wishlist TO wishlistuser;
\q

Docker PostgreSQL:

docker run --name wishlist-postgres \
  -e POSTGRES_DB=wishlist \
  -e POSTGRES_USER=wishlistuser \
  -e POSTGRES_PASSWORD=password \
  -p 5432:5432 \
  -d postgres:16

Hosted: Supabase, Neon, or Railway

2. Configure

cp .env.example .env
# Edit .env with your DATABASE_URL

3. Run

bun install
bun run db:push
bun run dev

Visit http://localhost:5173

Troubleshooting

Connection errors:

• Check PostgreSQL is running: sudo systemctl status postgresql
• Test connection: psql "postgresql://user:pass@localhost:5432/wishlist"

Port in use:

bun run dev -- --port 3000

Schema changes:

bun run db:push