Pocket Newspaper

A calm, reading-first pocket library. Save a link, read the clean article, and highlight passages.

Requirements

• Node.js 18+
• Docker (for local Postgres)

Getting started

1. Copy env variables:

cp .env.example .env

2. Start Postgres:

docker compose up -d

3. Install dependencies:

npm install

4. Run Prisma migrations and seed:

npm run prisma:migrate
npm run seed

5. Start dev server:

npm run dev

Visit http://localhost:3000 and unlock with APP_ACCESS_TOKEN.

Scripts

• npm run dev - Start Next.js dev server
• npm run build - Build for production
• npm run start - Start production server
• npm run lint - Lint
• npm run prisma:migrate - Run Prisma migrations
• npm run prisma:studio - Open Prisma Studio
• npm run seed - Seed local user

Notes

• The access gate is cookie-based. Update APP_ACCESS_TOKEN to change the unlock secret.
• Ingestion is synchronous for now. The job queue is structured for future QStash support.