Node.js HTTP server
HTMX for partial updates
Custom responsive CSS
Upstream API adapter for auth, order, result, FPP, password change, and special message flows

Run

npm start

Open:

http://localhost:5173

To serve under a subfolder like https://domain.com/folder, set:

DOCLINK_BASE_PATH=/folder npm start

That makes internal links, HTMX requests, and redirects stay under the same folder.

Click To Run

If you want a one-click launcher on macOS/Linux:

./start.sh

Stop the background server with:

./stop.sh

To stop a specific running port:

./stop.sh 5201

or:

PORT=5201 ./stop.sh

If you run the server in the foreground, stop it with Ctrl+C.

Login calls the upstream API from project-specs/API_ENDPOINTS.md.
If the upstream login rejects the credentials or is unavailable, demo mode creates a local session so the UI can still be exercised.
Order search, order detail helpers, FPP loading, password change, and special message save are wired through the API adapter with mock fallback for local preview.
start.sh writes a pid file named .doclink-web.pid and a log file named doclink-web.log.
Deployment templates are in deploy/.