Troubleshooting

The server cannot find the database

Check that DB_PATH points to an existing SQLite file:

DB_PATH=/absolute/path/to/deepphe.sqlite3 npm start

For packaged binaries, pass --db explicitly:

dphe-data-api --db /absolute/path/to/deepphe.sqlite3

Swagger UI is stale

Regenerate the OpenAPI spec:

npm run build:spec

The live server serves /openapi.json from the same Swagger definition used by /docs.

GitHub Pages docs do not update

The Pages workflow only runs when docs, route annotations, OpenAPI support files, or the workflow itself changes. You can also run Deploy docs to Pages manually from GitHub Actions.

The docs build fails locally

Install root and docs dependencies first:

npm install
npm run docs:install

Then build the site:

npm run docs:build