Pulse — AI-Powered Local Events Platform

Pulse is a local events platform where the differentiator is AI-powered discovery: a ranked feed based on embeddings over event descriptions and user interaction signals, not just a filtered list. See docs/prd-trd.md for the full concept, PRD, and TRD, and docs/future-scope.md for what's intentionally deferred past v1.

Project Setup

Backend

cd backend
npm install

Copy backend/ENV_TEMPLATE.md into a .env file and fill in real values, then:

npx prisma migrate dev --name setup   # set up Prisma ORM
npx prisma generate                   # generate Prisma client
npm run dev                           # start dev server (http://localhost:4000)
npm run docs                          # swagger API docs
npx prisma studio                     # DB browser on http://localhost:5555

Frontend

cd frontend
npm install

Set up .env.local per frontend/ENV_SETUP.md, then:

npm run dev

Access the frontend at http://localhost:3000.

Tech Stack

• Frontend: Next.js, Tailwind, Axios, shadcn/ui, Zustand, React Query, Framer Motion
• Backend: Node, Express, TypeScript, Prisma ORM, Supabase (PostgreSQL provider)

Docs

• docs/prd-trd.md — concept, product requirements, technical requirements, v1 scope
• docs/future-scope.md — schema features deferred past v1, and why
• docs/superpowers/specs/ — approved design specs awaiting or in implementation

Video Link

Loom