Files

Forgotten fade29fc3e Reorganize docs and add implementation spec

Move GOAL.md, PRODUCT.md, SPEC.md from repo root into doc/. Add
AGENTS.md (contributor guidance), doc/DEVELOPING.md (dev setup),
doc/SPEC-implementation.md (V1 implementation contract), and
doc/specs/ui.md (UI design spec). Update ClipHub doc.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-17 09:07:15 -06:00

976 B

Raw Blame History

Developing

This project can run fully in local dev without setting up PostgreSQL manually.

Prerequisites

Node.js 20+
pnpm 9+

Start Dev

From repo root:

pnpm install
pnpm dev

This starts:

API server: http://localhost:3100
UI: http://localhost:5173

Database in Dev (Auto-Handled)

For local development, leave DATABASE_URL unset. The server will automatically use embedded PGlite and persist data at:

./data/pglite

No Docker or external database is required for this mode.

Quick Health Checks

In another terminal:

curl http://localhost:3100/api/health
curl http://localhost:3100/api/companies

Expected:

/api/health returns {"status":"ok"}
/api/companies returns a JSON array

Reset Local Dev Database

To wipe local dev data and start fresh:

rm -rf data/pglite
pnpm dev

Optional: Use External Postgres

If you set DATABASE_URL, the server will use that instead of embedded PGlite.

976 B Raw Blame History