tr-plugin-design

White-label Total Recall design plugin: synthesizes and renders custom, on-brand sites, UI components, and layouts using canonical DESIGN.md tokens and frontier generative LLMs.

Status: implementation in progress; token library exists and prompt-engine work is in the worktree, but the CLI currently reports scaffold-only and generation/validation/UI remain unfinished. See docs/projects/ for the audit, PRD, architecture, development plan and tracker.

Install into a Total Recall brain: total-recall plugin install <git url of this repo>. State lives in vault/ as SSSS documents (npm test replays the SSSS conformance fixtures and round-trips the vault).

Readiness reconciliation — 2026-09-30

Canonical correction plan. No fresh suite was run against this external repository HEAD during the documentation review. Run npm test and configured gates on the Mac mini in a bounded background job. The Total Recall central preview is unwired static UI and is not an operational demonstration of this plugin.

• PIC-048: cli.mjs:8 has empty IMPLEMENTED; generation is inaccessible. src/designer.mjs is an untracked worktree addition, defaults a hardcoded model at line 27 and resolves keys only from env at line 210.
• PIC-049: src/validator.mjs is absent; markup validation, brand/contrast enforcement and export are unfinished. Central DesignPreview.tsx:96 shows a static palette unrelated to project tokens.

Durable capability state must use validated SSSS operations. Delivery requires a real clean-install command/UI walkthrough, explicit unavailable/error states and actual result provenance. Tests may use synthetic fixtures; shipped capability behavior may not.

Use it two ways

This plugin is a reusable brick, so a new project does not start from zero.

Add it to a project (for apps you build and ship). From the project directory:

total-recall plugin vendor https://github.com/gregiteen/tr-plugin-design.git 

This copies the plugin's source, skills, tests and docs into bricks/design and records it in tr-bricks.json. Your project then owns that code: edit it, test it in your own gates, and ship it with no runtime dependency on this plugin or on Total Recall. Combine as many bricks as the project needs. List them with total-recall plugin bricks.

Use it directly with Total Recall (for your own machines and workflow). Install it with total-recall plugin install https://github.com/gregiteen/tr-plugin-design.git and run total-recall design. Manage its credentials with total-recall auth secret and its skills with total-recall skill.