Frontend Dev Server

You only need Node.js and npm if you want to run the frontend development server yourself.

Typical ways to install Node.js and npm:

• On Debian/Ubuntu Linux:

  sudo apt install npm

• On Windows: install them from the official Node.js distribution
• use a version manager such as nvm

After installation, verify that both commands are available:

node --version
npm --version

Then start the frontend development server from the repository root:

npm install
npm run dev

In that setup:

• the frontend development server runs on 127.0.0.1:5174
• the backend server runs on 127.0.0.1:8099
• the frontend talks to the backend through the configured API base