Add Cursor Cloud specific instructions to AGENTS.md

- PostgreSQL and Next.js dev server startup guidance
- Node.js 24.x requirement and nvm usage
- Environment variable notes (DIRECT_URL gotcha)
- Database migration and seed instructions
- Authentication provider configuration notes
- Testing commands and pre-existing warning count

Co-authored-by: Fatih Kadir Akın <fka@fka.dev>

AGENTS.md

@@ -266,3 +266,35 @@ Currently no automated tests. When implementing:
 1. Update `prisma/schema.prisma`
 2. Run `npm run db:migrate` to create migration
 3. Update related TypeScript types if needed
+
+## Cursor Cloud specific instructions
+
+### Services
+
+| Service | How to start | Notes |
+|---------|-------------|-------|
+| PostgreSQL | `sudo pg_ctlcluster 16 main start` | Must be started before the app. Database `prompts_chat` is pre-created. |
+| Next.js dev server | `npm run dev` | Runs on port 3000 with Turbopack. |
+
+### Environment
+
+- **Node.js 24.x** is required (`engines` in `package.json`). Use `nvm use 24` if not already active.
+- `.env` must contain `DATABASE_URL`, `DIRECT_URL`, `AUTH_SECRET` (or `NEXTAUTH_SECRET`), and `AUTH_TRUST_HOST=true`. See `.env.example` for the full template.
+- `DIRECT_URL` must be set even for local development — Prisma schema references it for `directUrl`. Set it to the same value as `DATABASE_URL` for local PostgreSQL.
+
+### Database
+
+- Run `npx prisma migrate deploy` (not `db:migrate`) to apply existing migrations non-interactively.
+- `npm run db:seed` fetches live data from prompts.chat and creates an admin user (`admin@prompts.chat` / `password123`).
+- After schema changes, use `npm run db:migrate` which runs `prisma migrate dev` interactively.
+
+### Authentication
+
+- The default config (`prompts.config.ts`) uses GitHub, Google, and Apple OAuth providers — **not** credentials auth. To test registration/login without OAuth secrets, temporarily add `"credentials"` to the `auth.providers` array and set `allowRegistration: true`.
+- Admin login: `admin@prompts.chat` / `password123` (created by seed, requires credentials provider).
+
+### Testing
+
+- `npm test` runs Vitest (709+ tests). All tests use mocks and don't require a running database.
+- `npm run lint` runs ESLint. The codebase has ~200 pre-existing warnings (no errors).
+- No pre-commit hooks or CI-gating lint-staged configuration exists.

DOCKER.md

@@ -2,32 +2,27 @@
 
 Run your own prompts.chat instance using Docker Compose.
 
+[`compose.yml`](/compose.yml) supports both the pre-built container image being fetched from ghcr.io, or being built locally.
+
 ## Quick Start
 
+### To build locally
+
 ```bash
 git clone https://github.com/f/prompts.chat.git
 cd prompts.chat
-docker compose up -d
+docker compose up -d --build
 ```
 
 Open http://localhost:4444 in your browser.
 
-## Using a Pre-built Image
+### Using a Pre-built Image
 
-Edit `compose.yml` and replace the `build` block with the published image:
-
-```yaml
-services:
-  app:
-    # build:
-    #   context: .
-    #   dockerfile: docker/Dockerfile
-    image: ghcr.io/f/prompts.chat:latest
-```
-
-Then run:
+Simply remove the `--build` flag from the command:
 
 ```bash
+git clone https://github.com/f/prompts.chat.git
+cd prompts.chat
 docker compose up -d
 ```
 
@@ -45,6 +40,17 @@ docker run -d \
   prompts.chat
 ```
 
+Or if you simply want to use the pre-built image:
+
+```bash
+docker run -d \
+  --name prompts \
+  -p 4444:3000 \
+  -e DATABASE_URL="postgresql://user:pass@your-db-host:5432/prompts?schema=public" \
+  -e AUTH_SECRET="$(openssl rand -base64 32)" \
+  ghcr.io/f/prompts.chat:latest
+```
+
 ## Custom Branding
 
 All branding is configured via `PCHAT_*` environment variables at runtime -- no rebuild needed.

compose.yml

@@ -18,11 +18,11 @@ services:
 
   app:
     image: ghcr.io/f/prompts.chat:latest
-    # To build locally instead of using the pre-built image, comment out
-    # the 'image' line above and uncomment the build block below:
-    # build:
-    #   context: .
-    #   dockerfile: docker/Dockerfile
+    # By default, uses the pre-built image above. To build locally instead,
+    # run: docker compose up -d --build
+    build:
+       context: .
+       dockerfile: docker/Dockerfile
     restart: unless-stopped
     ports:
       - "${PORT:-4444}:3000"

public/favicon/favicon.svg

@@ -5,7 +5,7 @@
         </g>
     </g>
     <style>
-    @media (prefers-color-scheme: light) { :root { filter: none; } }
-    @media (prefers-color-scheme: dark) { :root { filter: invert(100%); } }
+    path { fill: #000000; }
+    @media (prefers-color-scheme: dark) { path { fill: #ffffff; } }
     </style>
-</svg>
+</svg>

src/app/layout.tsx

@@ -62,12 +62,12 @@ export const metadata: Metadata = {
   publisher: "prompts.chat",
   icons: {
     icon: [
-      { url: "/favicon/favicon.ico", sizes: "48x48" },
-      { url: "/favicon/favicon-96x96.png", sizes: "96x96", type: "image/png" },
       { url: "/favicon/favicon.svg", type: "image/svg+xml" },
+      { url: "/favicon/favicon-96x96.png", sizes: "96x96", type: "image/png" },
+      { url: "/favicon/favicon.ico", sizes: "48x48" },
     ],
     apple: "/favicon/apple-touch-icon.png",
-    shortcut: "/favicon/favicon.ico",
+    shortcut: "/favicon/favicon.svg",
   },
   manifest: "/favicon/site.webmanifest",
   other: {

tsconfig.json

@@ -30,5 +30,5 @@
     ".next/dev/types/**/*.ts",
     "**/*.mts"
   ],
-  "exclude": ["node_modules"]
+  "exclude": ["node_modules", "packages"]
 }