Files
coms3011a-lab1/docs/RUNNING_IT.md

1.3 KiB

Running It

This project was verified with:

  • Node.js v24.14.0
  • npm 11.9.0

Use Node.js v24.14.0, which is the version verified for this project. The application uses Node's built-in node:sqlite module for SQLite persistence.

Clean Clone Setup

git clone https://sdp.ms.wits.ac.za/Mpho10111/coms3011a-lab1
cd coms3011a-lab1
npm install

Run the Development Server

npm run dev

Open the application at:

http://localhost:3000

The SQLite database is created automatically on first run at data/planner.sqlite. Local SQLite files under data/ are ignored by Git.

Run Tests

npm test

npm test currently runs 5 deterministic behavioural tests. The tests use a temporary throwaway SQLite database through TASKS_DB_PATH; they do not use or modify data/planner.sqlite.

Run Linting

npm run lint

Build the Application

npm run build

Commands from package.json

Command Purpose
npm run dev Starts the Next.js development server.
npm run build Builds the production application.
npm start Starts the production build.
npm run lint Runs ESLint.
npm test Compiles the test target and runs the automated behavioural tests.