Brand Kit
Run the exact command npx @replynodes/brand-kit <bare-domain> to generate a local brand
kit from one public domain. The sole endpoint boundary is
GET https://brand.replynodes.com/{bare-domain}.
The command produces exactly six local outputs: brand.json, colors.json,
fonts.json, logos.json, tokens.css, and DESIGN.md. These files are a
local transformation of the aggregate response; they are not additional API
routes. See the Brand intelligence aggregate contract
for the response and validation rules.
Current source path
The published package is available at v0.1.1. If npm is unavailable in a restricted environment, use this distinct source/clone fallback from the canonical ReplyNodes Brand Kit repository:
git clone https://github.com/replynodes/brand-kit.git
cd brand-kit
npm ci
node bin/brand-kit.mjs <bare-domain>
The input is one bare domain, not a URL, path,
port, query, fragment, IP literal, localhost name, or credential-bearing
value.
WHEN TO USE
Use Brand Kit when a person or agent needs a small, reviewable brand context before making design decisions. It is useful when the consumer can work from the six generated files and wants missing or partial source signals to remain visible rather than guessed.
Intent map
1. Build a landing page with an agent
Command/input: Run npx @replynodes/brand-kit linear.app with the landing page’s
bare-domain input. Artifacts: Review all six outputs—brand.json,
colors.json, fonts.json, logos.json, tokens.css, and DESIGN.md.
Consumer workflow: Give the agent the files as inspectable context, then
have it propose page structure and styling while a person reviews the source
signals. Limitations: This supplies references and available signals only;
it does not guarantee a design result, download logo binaries, add credentials,
or download logo binaries. Missing or partial data remains explicit, and no
credentials are requested.
2. Generate a brand kit
Command/input: Run npx @replynodes/brand-kit vercel.com for the one bare domain
that should be documented. Artifacts: Consume exactly brand.json,
colors.json, fonts.json, logos.json, tokens.css, and DESIGN.md.
Consumer workflow: Keep the six files together as a local, inspectable
reference package and read the provenance and caveats before using any value.
Limitations: No API key or signup is required, but the command has no
anonymous /v1 routes, no credentials, and no promise that every source field
is present; unavailable data stays explicit.
3. CSS/design-token handoff
Command/input: Run npx @replynodes/brand-kit stripe.com with the source bare
domain. Artifacts: Review all six files and consume generated tokens.css
alongside brand.json, colors.json, fonts.json, logos.json, and
DESIGN.md. Consumer workflow: Inspect the generated tokens, then adapt
them in the existing stylesheet and component system. Limitations: Tokens
reflect available source signals only, logos are references rather than
downloaded assets, missing or partial data remains explicit, and no
credentials are requested.
4. Reusable brand reference package for slides, reports, and email
Command/input: Run npx @replynodes/brand-kit github.com for the brand being
referenced. Artifacts: Carry exactly brand.json, colors.json,
fonts.json, logos.json, tokens.css, and DESIGN.md with the working
materials. Consumer workflow: Use the files as a shared reference for
names, colors, typography, logo references, and documented caveats across
slides, reports, or email templates. Limitations: This is not a publishing
or asset-delivery service: there are no credentials, no anonymous /v1 routes,
no binary logo downloads, and missing or partial data remains explicit.
5. Design handoff or audit
Command/input: Run npx @replynodes/brand-kit notion.so using the audited
implementation’s bare-domain input. Artifacts: Share exactly the six
outputs—brand.json, colors.json, fonts.json, logos.json, tokens.css,
and DESIGN.md. Consumer workflow: Compare the implementation with the
available extracted signals, record decisions against DESIGN.md, and pass
the package to the next reviewer. Limitations: The package does not make
customer or design-quality claims, does not infer unavailable values, and does
requests no credentials; logo values remain references only and missing or
partial data remains explicit.
Limitations and boundaries
- The request needs no API key or signup and makes one aggregate read only; it
does not expose or imply anonymous
/v1routes. - The command accepts or emits no credentials, cookies, sessions, or private tokens.
logos.jsoncontains logo references and metadata only; logo binaries are not downloaded.- Missing, partial, or unavailable source data remains explicit in the six outputs. Values are not invented, and a generated file does not imply that a source signal was found.
- The CSS handoff consumes generated
tokens.css; logo values remain references only, and missing or partial data remains explicit.
The canonical Brand Kit repository owns the CLI source. The Brand intelligence guide owns the aggregate service contract, while the ReplyNodes API Reference owns authenticated OpenAPI routes.