---
name: Local Frontend Dev Workflow
description: How to start the local frontend dev environment — use start-dev.sh from neode-ui/, NOT npm start from root
type: feedback
---

Run local frontend dev from `neode-ui/` directory: `./start-dev.sh` (NOT `npm start` from project root — there's no root package.json).

**Why:** The project root has no package.json. Running `npm start` there fails with ENOENT. The frontend dev script lives in `neode-ui/start-dev.sh`.

**How to apply:**
- `cd neode-ui && ./start-dev.sh` — clears ports, starts Docker apps, runs `npm run dev:mock` (mock backend on :5959, Vite on :8100)
- Stop with `./stop-dev.sh` or Ctrl+C
- Login password in dev mode: `password123`
- When telling the user how to test locally, always reference `cd neode-ui && ./start-dev.sh`