Synopsis
Description
dms web starts a lightweight HTTP server (Python’s built-in http.server) and opens the DMS Vault in your default browser. The Vault is a single-page web application that provides a graphical alternative to the terminal wizard for users who prefer a form-based interface.
DMS Vault features:
Form-based record creation
Dropdown menus for type, role, and access level are populated directly from the DMS schema. All required fields are clearly marked.
Live validation
Each record is validated against the schema as you fill in the form. Errors and warnings appear inline before you save.
JSON and JSON-LD copy
Copy the raw DMS JSON or a full JSON-LD representation to the clipboard with one click.
Record browser
Browse all records saved in the records directory without leaving the browser.
http://127.0.0.1. No data is sent to any external service. Press Ctrl+C in the terminal to stop the server.
Options
Port for the local HTTP server. Change this if port 8080 is already in use.
Directory where saved records are written. The directory is created automatically if it does not exist.
Suppress automatic browser launch. The server still starts; navigate to the URL printed in the terminal manually.
API endpoints
The server exposes a small JSON API used by the Vault frontend:| Method | Path | Description |
|---|---|---|
GET | / | Serves the Vault HTML page. |
GET | /api/schema | Returns schema metadata (types, roles, access levels, required fields). |
GET | /api/records | Lists all saved records from the records directory. |
GET | /api/new-id | Generates a new UUID v4. |
POST | /api/validate | Validates a record object and returns errors and warnings. |
POST | /api/save | Validates and saves a record as TYPE_XXXXXXXX.json in the records directory. |
POST | /api/export-jsonld | Converts a record object to JSON-LD and returns the result. |
Examples
Notes
The server binds to
127.0.0.1 only. It is not accessible from other machines on your network by design.