Use a design reference

A design reference is a public documentation site URL Doxloop can inspect for layout, typography, color, navigation, and component patterns — while keeping your product's identity, claims, and examples completely separate.

Add a reference

At project creation:

doxloop init my-docs \
  --source product=../my-product \
  --reference https://docs.example.com/

Or add one while authoring:

doxloop create \
  --reference https://docs.example.com/ \
  "Use this site as an information-architecture and presentation reference."

--reference may be repeated to add more than one. Each must be an absolute HTTP or HTTPS URL without embedded credentials; Doxloop strips any URL fragment.

Capture evidence for an agent without browser access

If your selected agent can't render pages itself, capture measured evidence with a managed headless browser instead:

doxloop capture

With no URLs, Doxloop captures each configured reference's pages. Pass specific URLs to capture only those:

doxloop capture https://docs.example.com/guide

Capture enforces bounded, safe evidence collection:

• URLs must belong to a configured reference's origin.
• At most three pages are captured per origin.
• Navigation away from the configured origin is blocked.
• Loopback, private, link-local, multicast, and other non-public network

destinations are blocked.

For a trusted local reference (for example a documentation site running on localhost), allow it for one invocation:

DOXLOOP_ALLOW_PRIVATE_REFERENCES=1 doxloop capture http://localhost:3000/

Recovery

If doxloop capture refuses a URL, it's one of: no reference is configured yet (add one with --reference first), the URL isn't on a configured reference's origin, or it resolves to a private network destination. See Troubleshooting.

Next steps