feat: replace SQLite with Postgres via Apple Container

.envrc-dist

@@ -1,2 +1,8 @@
 export GITHUB_CLIENT_ID=
 export GITHUB_CLIENT_SECRET=
+export DATABASE_URL=postgres://auth:auth@localhost:5433/test
+export AUTH_TEST_PG_HOST=localhost
+export AUTH_TEST_PG_PORT=5433
+export AUTH_TEST_PG_USER=auth
+export AUTH_TEST_PG_PASSWORD=auth
+export AUTH_TEST_PG_DB=test

.github/workflows/ci.yml

@@ -82,8 +82,6 @@ jobs:
           npm run prettier:check
           npm run lint
           npm run fallow
-          npm run db:generate
-          npm run db:migrate
 
   test:
     needs:

.taprc

@@ -1,5 +1,6 @@
 files:
   - "test/**/*.test.js"
+jobs: 1
 timeout: 30
 coverage-report:
   - "text"

docs/development.md

@@ -1,8 +1,54 @@
 # Development
 
-You can test the container setup by running `make run-dev` in the root of the repository.
+## Prerequisites
 
-This will build and start the stack:
+1. Install [Apple Container](https://github.com/apple/container)
+2. Start the container service:
 
-- application container
-- local s3 storage (based on RustFS)
+   ```sh
+   container system start
+   ```
+
+## Running the app
+
+The app automatically starts the Postgres container if needed:
+
+```sh
+npm run dev
+```
+
+Or manually manage the container:
+
+```sh
+npm run test:pg:start   # Start Postgres container
+npm run test:pg:stop    # Stop Postgres container
+npm run test:pg:status  # Check container status
+```
+
+## Environment
+
+Copy `.envrc-dist` to `.envrc` and add your GitHub OAuth credentials:
+
+```sh
+cp .envrc-dist .envrc
+# Edit .envrc to add GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET
+# then: source .envrc  (or use direnv/mise to load it)
+```
+
+The default `DATABASE_URL` points to the local Postgres container.
+
+## Database
+
+Run migrations after pulling new changes:
+
+```sh
+npm run db:migrate
+```
+
+## Testing
+
+Tests automatically start the Postgres container if it's not running:
+
+```sh
+npm test
+```