Developer DocumentationLocal Setup

Local Setup

[!NOTE] This setup guide is based on scripts and dependencies in the current repository.

Prerequisites

ToolMinimumWhy
Node.js20 LTS recommendedMatches CI and Next.js runtime expectations
npmCurrent with NodeRuns project scripts
GitAny modern versionClone and branch workflow
PostgreSQL clientOptional but recommendedDirect DB inspection and debugging
DockerOptionalLocal DB workflows if you choose Dockerized Postgres

Clone and install

git clone https://github.com/Officialkid/event-slot.git
cd event-slot
npm install

Local development

npm run dev

Open http://localhost:3000.

Connect to Neon dev branch

Use your Neon branch credentials in .env.local:

  • DATABASE_URL: pooled URL
  • DIRECT_URL: direct URL

This mirrors the app/runtime + migration split used by Prisma in this repo.

Prisma migrations locally

npm run db:generate
npm run db:push

If you are applying migration files specifically:

npm run db:migrate

Seed data

If seed is configured in your local environment:

npx prisma db seed

If not, create a lightweight seed script and register it under prisma.seed.