Examples and Deployment
Alpha
DSAR is currently in alpha. APIs, package surfaces, configuration, and documentation may change as the project evolves.
DSAR includes runnable examples for local development, integration experiments, and product embedding patterns.
Example Catalog
| Example | Purpose | When to use it |
|---|---|---|
examples/kitchen-sink | Full local runtime with SQLite, filesystem artifacts, and walkthrough scripts | Start here when you want broad lifecycle coverage fast |
examples/dashboard | Operator-facing Next.js app | Explore admin and operator flows |
examples/subject-portal | Subject-facing Next.js app | Explore request submission, verification, and appeals |
examples/local-storage | Runtime wired to filesystem storage | Validate local artifact persistence |
examples/vercel-storage | Runtime wired to Vercel Blob plus an upload demo | Validate Blob-backed artifact storage and demo uploads |
Recommended Local Stack
For the broadest local setup, run:
Then use:
http://kitchen-sink.localhost:1355/api/v1/statushttp://kitchen-sink.localhost:1355/api/v1/spec.jsonhttp://kitchen-sink.localhost:1355/api/v1/docshttp://dashboard.localhost:1355http://subject-portal.localhost:1355
Deployment Patterns
Self-Hosted Runtime
Embed @dsar/backend into your own service, choose a persistence layer, then
register storage, inbound, outbound, and auth integrations as needed.
Start with:
Server-Side Product Integration
Use @dsar/node-sdk or @dsar/core from trusted backend code in your product.
This is the preferred shape for dashboards, automation, and subject portals.
Browser-Facing Portals
Do not expose DSAR machine credentials in the browser. Authenticate the user in the host app first, then call DSAR from a server action, route handler, or backend service.
See Auth Model.
Infrastructure Scope
This workspace does not currently provide one canonical container or production infrastructure recipe. The examples are intended as composition references for runtime wiring, auth boundaries, and storage choices rather than turnkey production deployment manifests.