72 lines
1.1 KiB
Markdown
72 lines
1.1 KiB
Markdown
# Setup Guide
|
|
|
|
## Docker (Recommended)
|
|
|
|
```bash
|
|
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:**
|
|
```bash
|
|
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:**
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
cp .env.example .env
|
|
# Edit .env with your DATABASE_URL
|
|
```
|
|
|
|
### 3. Run
|
|
|
|
```bash
|
|
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:**
|
|
```bash
|
|
bun run dev -- --port 3000
|
|
```
|
|
|
|
**Schema changes:**
|
|
```bash
|
|
bun run db:push
|
|
```
|