doclink_web/README.md

DocLink Web

Server-rendered rebuild of the DocLink web app, following the structure in project-specs/.

Stack

• 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

Click To Run

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

./start.sh

Stop the background server with:

./stop.sh

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

Notes

• 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.

Main Files

• server.js
• styles.css
• package.json
• start.sh
• stop.sh