Frontend Dev Server

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

Read this page when the default DependencyAtlas.serve(static=true) flow is not enough and you want the frontend hot-reload loop during development.

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

Related Pages

• For the normal installation path, see Get Started / Installation.
• For the current frontend/backend runtime split, see Architecture / Frontend and Store.