migrate to supabase with unified setup

Author: onmax

CLAUDE.md

@@ -14,11 +14,10 @@ pnpm run dev              # Start dev server on localhost:3000
 pnpm run build            # Build for production
 pnpm run preview          # Preview production build
 
-# Database (requires .env file in project root)
-pnpm run db:start         # Start PostgreSQL + PostGIS with Docker
-pnpm run db:stop          # Stop database
-pnpm run db:restart       # Restart database (useful for reseeding)
+# Database (uses Supabase remote)
+pnpm run db:setup         # Run migrations and seeds on remote Supabase
 pnpm run db:generate      # Generate Drizzle migrations from schema changes
+pnpm run db:push          # Push migrations to remote Supabase via CLI
 
 # Code Quality
 pnpm run lint             # Run ESLint with cache
@@ -55,20 +54,29 @@ The app uses **PostgreSQL with PostGIS** and a normalized relational schema with
 2. Insert corresponding rows into `location_categories` junction table
 3. PostGIS automatically handles the geometry conversion
 
-### Database Seeding
+### Database Setup and Seeding
 
-- **Automatic seeding** via Docker Compose when starting the PostgreSQL database
+The project uses **Supabase** for remote database management:
+
+- **Remote**: Connected to Supabase project (wwiwmsgedqeepcdtnhon) via connection pooler
 - Migrations are stored in `database/migrations/` (generated by Drizzle)
 - Seed files are stored in `database/seeds/`:
+  - `rls-policies.sql` - Row Level Security policies
   - `categories.sql` - All Google Maps category types with icon mappings
-  - `sources/dummy.sql` - Dummy location data for testing
-- The seeding process (executed by Docker):
-  1. `init.sh` - Creates PostGIS extensions, roles, and permissions
-  2. `run-migrations.sh` - Applies Drizzle migrations to create tables
-  3. `rls-policies.sql` - Applies Row Level Security policies
-  4. Seeds categories and dummy location data
-- To start/restart database: `pnpm run db:start`
-- To regenerate migrations after schema changes: `pnpm run db:generate`
+  - `sources/*.sql` - Location data from various sources
+
+**Database workflow**:
+
+1. Generate migrations from schema changes: `pnpm run db:generate`
+2. Apply migrations and seeds to remote: `pnpm run db:setup`
+3. (Optional) Push via Supabase CLI: `pnpm run db:push`
+
+The `db:setup` script (`scripts/db-setup.ts`):
+
+- Enables PostGIS extension automatically
+- Runs all migrations in order, tracking applied migrations to avoid duplicates
+- Applies RLS policies and seeds data from SQL files
+- Uses connection pooler with `prepare: false` for transaction pooling mode
 
 ### API Endpoints
 
@@ -118,7 +126,8 @@ The app uses **UnoCSS with Nimiq presets**:
 - Import schema as `tables` from `server/utils/drizzle.ts`
 - Schema is defined in `database/schema.ts`
 - Type exports: `Location`, `Category`, `LocationCategory`
-- Connection uses individual env vars (POSTGRES_HOST, POSTGRES_PORT, POSTGRES_USER, POSTGRES_PASSWORD, POSTGRES_DB)
+- Connection uses `DATABASE_URL` environment variable
+- Must use `prepare: false` option for Supabase transaction pooler
 - PostgreSQL-specific: Use `sql` tagged templates for PostGIS queries
 - PostGIS functions: `ST_X()`, `ST_Y()`, `ST_Distance()`, `ST_Within()`, etc.
 
@@ -130,7 +139,7 @@ The app uses **UnoCSS with Nimiq presets**:
 2. Categories must be valid Google Maps types (snake_case strings) from `database/seeds/categories.sql`
 3. Use PostGIS `ST_SetSRID(ST_MakePoint(longitude, latitude), 4326)` for location geometry
 4. Insert corresponding rows into `location_categories` junction table
-5. Restart Docker Compose to apply changes: `pnpm run db:restart`
+5. Apply changes: `pnpm run db:setup` (runs migrations and seeds)
 
 ### Category Filtering
 
@@ -151,27 +160,28 @@ The app uses **UnoCSS with Nimiq presets**:
 - **`drizzle.config.ts`** - PostgreSQL dialect, schema at `database/schema.ts`, migrations output to `database/migrations/`
 - **`uno.config.ts`** - UnoCSS with Nimiq presets
 - **`eslint.config.mjs`** - Antfu's ESLint config with Nuxt integration
-- **`database/docker-compose.yml`** - Docker Compose setup for local PostgreSQL development
-- **`database/init.sh`** - Initializes PostGIS extensions and permissions
-- **`database/run-migrations.sh`** - Runs Drizzle migrations on container start
-- **`database/rls-policies.sql`** - Row Level Security policies
+- **`supabase/config.toml`** - Supabase local development configuration
+- **`scripts/db-setup.ts`** - Unified migration and seeding script
+- **`database/migrations/`** - Drizzle-generated SQL migrations
+- **`database/seeds/rls-policies.sql`** - Row Level Security policies
 - **`database/seeds/categories.sql`** - All Google Maps categories with icons
-- **`database/seeds/sources/dummy.sql`** - Dummy location data
+- **`database/seeds/sources/*.sql`** - Location data from various sources
 
 ## Environment Variables
 
 Required in `.env` (project root):
 
 ```env
-# PostgreSQL Configuration
-POSTGRES_HOST=localhost
-POSTGRES_PORT=5432
-POSTGRES_USER=postgres
-POSTGRES_PASSWORD=your_password
-POSTGRES_DB=postgres
+# PostgreSQL Configuration (Supabase Remote)
+DATABASE_URL=postgresql://postgres.wwiwmsgedqeepcdtnhon:[YOUR-PASSWORD]@aws-1-eu-central-1.pooler.supabase.com:6543/postgres
 
 # API Keys
 NUXT_GOOGLE_API_KEY=your_api_key
 ```
 
-All variables are validated via `safeRuntimeConfig` using Valibot schema.
+**Important**:
+
+- Uses Supabase connection pooler (port 6543) for remote database access
+- The pooler provides IPv4 connectivity (required for some WSL/network setups)
+- Connection uses transaction pooling mode (requires `prepare: false` in postgres client)
+- All variables are validated via `safeRuntimeConfig` using Valibot schema

README.md

@@ -32,13 +32,51 @@ pnpm install
 
 # Set up environment variables
 cp .env.example .env
-# Edit .env with your PostgreSQL credentials
+# Edit .env with your database connection string
+```
+
+## Database Setup
+
+This project supports both **remote Supabase** and **local development** with Supabase CLI.
+
+### Option 1: Remote Supabase (Recommended for Production)
+
+The project is configured to use a remote Supabase database by default.
+
+```bash
+# 1. Add your Supabase connection string to .env
+# DATABASE_URL=postgresql://postgres.PROJECT_REF:PASSWORD@aws-1-eu-central-1.pooler.supabase.com:6543/postgres
 
-# Start PostgreSQL + PostGIS with Docker
-pnpm run db:start
-# Database is automatically seeded on first start
+# 2. Run migrations and seeds
+pnpm run db:setup
 ```
 
+**Note:** The connection string uses the Supabase pooler (port 6543) which provides transaction pooling and IPv4 connectivity.
+
+### Option 2: Local Development with Supabase CLI
+
+For local development, you can run a local Supabase instance:
+
+```bash
+# 1. Start local Supabase (includes PostgreSQL + PostGIS)
+pnpm run db:local
+
+# 2. Update .env to use local connection
+# DATABASE_URL=postgresql://postgres:postgres@localhost:54322/postgres
+
+# 3. Run migrations and seeds
+pnpm run db:setup
+
+# 4. Stop local Supabase when done
+pnpm run db:local:stop
+```
+
+**Local Supabase includes:**
+
+- PostgreSQL with PostGIS on `localhost:54322`
+- Supabase Studio on `localhost:54323`
+- REST API on `localhost:54321`
+
 ## Development
 
 ```bash
@@ -179,10 +217,11 @@ pnpm run build            # Build for production
 pnpm run preview          # Preview production build
 
 # Database
-pnpm run db:start         # Start PostgreSQL + PostGIS with Docker
-pnpm run db:stop          # Stop database
-pnpm run db:restart       # Restart database (useful for reseeding)
-pnpm run db:generate      # Generate migrations (stored in database/migrations/)
+pnpm run db:setup         # Run migrations and seeds (local or remote)
+pnpm run db:generate      # Generate migrations from schema changes
+pnpm run db:push          # Push migrations to remote Supabase via CLI
+pnpm run db:local         # Start local Supabase (PostgreSQL + PostGIS)
+pnpm run db:local:stop    # Stop local Supabase
 
 # Code Quality
 pnpm run lint             # Run ESLint
@@ -192,47 +231,47 @@ pnpm run typecheck        # Run TypeScript checks
 
 ## Environment Variables
 
-Create a `.env` file in the project root (see `.env.example`):
+Create a `.env` file in the project root:
 
 ```env
-# PostgreSQL Configuration
-POSTGRES_HOST=localhost
-POSTGRES_PORT=5432
-POSTGRES_USER=postgres
-POSTGRES_PASSWORD=your_password
-POSTGRES_DB=postgres
+# Database Connection String
+# Remote Supabase (default)
+DATABASE_URL=postgresql://postgres.PROJECT_REF:PASSWORD@aws-1-eu-central-1.pooler.supabase.com:6543/postgres
 
-# JWT Configuration (if using Supabase Studio)
-JWT_SECRET=your_jwt_secret
+# Or Local Supabase (when using pnpm run db:local)
+# DATABASE_URL=postgresql://postgres:postgres@localhost:54322/postgres
 
 # API Keys
-ANON_KEY=your_anon_key
-SERVICE_ROLE_KEY=your_service_role_key
 NUXT_GOOGLE_API_KEY=your_google_api_key
-
-# Kong & Studio (optional)
-KONG_HTTP_PORT=8100
-STUDIO_PORT=4000
-SUPABASE_PUBLIC_URL=http://localhost:8100
 ```
 
 ## Database Development
 
-This repository includes a PostgreSQL + PostGIS setup in the `database/` directory.
+The database uses **Supabase** for PostgreSQL + PostGIS hosting.
+
+### Remote Database
+
+The project is connected to a remote Supabase instance. All migrations and seeds are tracked in the `database/` folder and can be applied via:
+
+```bash
+pnpm run db:setup
+```
+
+### Local Database
 
-**Quick Start:**
+For local development, you can spin up a local Supabase instance:
 
 ```bash
-pnpm run db:start      # Start services
+pnpm run db:local
 ```
 
-**Access:**
+**Local Access:**
 
-- **Supabase Studio**: http://localhost:4000
-- **PostgreSQL**: `localhost:5432`
-- **REST API**: http://localhost:8100
+- **Supabase Studio**: http://localhost:54323
+- **PostgreSQL**: `localhost:54322`
+- **REST API**: http://localhost:54321
 
-See [`database/README.md`](database/README.md) for PostGIS examples and REST API usage.
+See [`database/README.md`](database/README.md) for PostGIS examples and database structure.
 
 ## Learn More
 

database/seeds/rls-policies.sql

@@ -84,3 +84,31 @@ CREATE POLICY "Only service_role can delete location_categories"
 ON location_categories FOR DELETE
 TO service_role
 USING (true);
+
+-- Enable RLS on __container_migrations table
+ALTER TABLE __container_migrations ENABLE ROW LEVEL SECURITY;
+
+-- __container_migrations: Read for all, write only for service_role
+DROP POLICY IF EXISTS "Allow read access for all users" ON __container_migrations;
+CREATE POLICY "Allow read access for all users"
+ON __container_migrations FOR SELECT
+TO anon, authenticated, service_role
+USING (true);
+
+DROP POLICY IF EXISTS "Only service_role can insert migrations" ON __container_migrations;
+CREATE POLICY "Only service_role can insert migrations"
+ON __container_migrations FOR INSERT
+TO service_role
+WITH CHECK (true);
+
+DROP POLICY IF EXISTS "Block updates on migrations" ON __container_migrations;
+CREATE POLICY "Block updates on migrations"
+ON __container_migrations FOR UPDATE
+TO anon, authenticated
+USING (false);
+
+DROP POLICY IF EXISTS "Block deletes on migrations" ON __container_migrations;
+CREATE POLICY "Block deletes on migrations"
+ON __container_migrations FOR DELETE
+TO anon, authenticated
+USING (false);

drizzle.config.ts

@@ -1,14 +1,11 @@
 import process from 'node:process'
 import { defineConfig } from 'drizzle-kit'
 
-const { POSTGRES_HOST, POSTGRES_PORT, POSTGRES_USER, POSTGRES_PASSWORD, POSTGRES_DB } = process.env
-const url = `postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@${POSTGRES_HOST}:${POSTGRES_PORT}/${POSTGRES_DB}`
-
 export default defineConfig({
   dialect: 'postgresql',
   schema: './database/schema.ts',
   out: './database/migrations',
   dbCredentials: {
-    url,
+    url: process.env.DATABASE_URL!,
   },
 })

nuxt.config.ts

@@ -27,24 +27,12 @@ export default defineNuxtConfig({
   },
   runtimeConfig: {
     googleApiKey: process.env.NUXT_GOOGLE_API_KEY || '',
-    postgres: {
-      host: process.env.POSTGRES_HOST || '',
-      port: process.env.POSTGRES_PORT || '',
-      user: process.env.POSTGRES_USER || '',
-      password: process.env.POSTGRES_PASSWORD || '',
-      db: process.env.POSTGRES_DB || '',
-    },
+    databaseUrl: process.env.DATABASE_URL || '',
   },
   safeRuntimeConfig: {
     $schema: v.object({
       googleApiKey: v.pipe(v.string(), v.minLength(1, 'Google API key is required')),
-      postgres: v.object({
-        host: v.pipe(v.string(), v.minLength(1, 'PostgreSQL host is required')),
-        port: v.pipe(v.string(), v.minLength(1, 'PostgreSQL port is required')),
-        user: v.pipe(v.string(), v.minLength(1, 'PostgreSQL user is required')),
-        password: v.pipe(v.string(), v.minLength(1, 'PostgreSQL password is required')),
-        db: v.pipe(v.string(), v.minLength(1, 'PostgreSQL database is required')),
-      }),
+      databaseUrl: v.pipe(v.string(), v.minLength(1, 'Database URL is required')),
     }),
   },
   icon: {

package.json

@@ -10,10 +10,11 @@
     "preview": "nuxt preview",
     "prepare": "nuxt prepare",
     "postinstall": "nuxt prepare",
-    "db:start": "cd database && docker compose --env-file ../.env up -d && cd ..",
-    "db:stop": "cd database && docker compose down && cd ..",
-    "db:restart": "cd database && docker compose --env-file ../.env down && docker compose --env-file ../.env up -d && cd ..",
+    "db:setup": "NODE_OPTIONS='--dns-result-order=ipv4first' tsx scripts/db-setup.ts",
     "db:generate": "drizzle-kit generate",
+    "db:push": "npx supabase db push",
+    "db:local": "npx supabase start",
+    "db:local:stop": "npx supabase stop",
     "lint": "eslint . --cache",
     "lint:fix": "eslint . --fix --cache",
     "test": "vitest run",
@@ -46,12 +47,14 @@
     "@unocss/nuxt": "catalog:ui",
     "@unocss/preset-attributify": "catalog:ui",
     "@vue/test-utils": "catalog:test",
+    "dotenv": "catalog:",
     "drizzle-kit": "catalog:database",
     "eslint": "catalog:dev",
     "eslint-plugin-format": "catalog:dev",
     "happy-dom": "catalog:test",
     "nimiq-css": "catalog:ui",
     "playwright-core": "catalog:test",
+    "tsx": "catalog:",
     "typescript": "catalog:dev",
     "unocss-preset-onmax": "catalog:ui",
     "vitest": "catalog:test",