Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ jobs:
main_commit="$(git rev-parse refs/remotes/origin/main^{commit})"
git merge-base --is-ancestor "$tag_commit" "$main_commit"
test -z "$(git status --porcelain=v1)"
node --input-type=module -e 'import fs from "node:fs"; const p = JSON.parse(fs.readFileSync("package.json", "utf8")); if (p.version !== process.env.VERSION) process.exit(1)'
node --input-type=module -e 'import fs from "node:fs"; const p = JSON.parse(fs.readFileSync("package.json", "utf8")); const l = JSON.parse(fs.readFileSync("package-lock.json", "utf8")); if (p.name !== "@replynodes/brand-kit" || p.version !== process.env.VERSION || l.name !== p.name || l.version !== p.version || l.packages?.[""].name !== p.name || l.packages?.[""].version !== p.version || p.bin?.["brand-kit"] !== "bin/brand-kit.mjs") process.exit(1)'
grep -Fx -- "## $VERSION" CHANGELOG.md
test "$(git rev-parse "refs/tags/$expected_tag^{commit}")" = "$tag_commit"
- run: npm ci
Expand Down
5 changes: 5 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,10 @@
# Changelog

## 0.1.1

- Migration target: publish the package as the public npm package `@replynodes/brand-kit`.
- npm publication is the v0.1.1 release target and has not yet occurred.

## 0.1.0

- Initial public dependency-free CLI and deterministic six-file brand package.
18 changes: 10 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,26 +5,28 @@ Turn a public domain into a deterministic, agent-ready brand context package in
## 10-second demo

```sh
npx brand-kit linear.app
npx @replynodes/brand-kit linear.app
cat brand/brand.json
```

## Install and run

```sh
npm install -g brand-kit
npm install -g @replynodes/brand-kit
brand-kit example.com
```

The package is scoped as `@replynodes/brand-kit`, while the installed executable remains `brand-kit`.

Pass exactly one bare domain. The client supports Node.js `>=20.19.0` on Linux x64/arm64, macOS x64/arm64, and Windows x64. CI verifies Node 20.x and 22.x; that does not claim every OS combination is tested.

## Approved use cases

- Agent-ready brand context: `npx brand-kit linear.app`
- On-brand landing-page bootstrap: `npx brand-kit vercel.com`
- CSS/token handoff: `npx brand-kit stripe.com`
- Reusable reference package for slides/reports/email: `npx brand-kit github.com`
- Portable design handoff/audit: `npx brand-kit notion.so`
- Agent-ready brand context: `npx @replynodes/brand-kit linear.app`
- On-brand landing-page bootstrap: `npx @replynodes/brand-kit vercel.com`
- CSS/token handoff: `npx @replynodes/brand-kit stripe.com`
- Reusable reference package for slides/reports/email: `npx @replynodes/brand-kit github.com`
- Portable design handoff/audit: `npx @replynodes/brand-kit notion.so`

## Artifacts

Expand All @@ -44,4 +46,4 @@ The client in this repository is MIT-licensed. The hosted aggregate service at `

## Contribution and release notes

See `CONTRIBUTING.md` for checks and contribution boundaries. CI runs smoke/contract checks on Node 20.x and 22.x. A future release workflow is manually triggerable for SemVer npm trusted publishing with provenance; this initial issue does not publish a release.
See `CONTRIBUTING.md` for checks and contribution boundaries. CI runs smoke/contract checks on Node 20.x and 22.x. The v0.1.1 release target is publication of the scoped package to npm as a public package using trusted publishing with provenance; it has not yet been published.
16 changes: 16 additions & 0 deletions SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# @replynodes/brand-kit

Use the public npm package with one bare domain:

```sh
npx @replynodes/brand-kit example.com
```

The package is scoped, but its installed executable remains `brand-kit`:

```sh
npm install -g @replynodes/brand-kit
brand-kit example.com
```

The client makes one HTTPS GET to `https://brand.replynodes.com/{bare-domain}` and writes the deterministic brand artifacts locally. It requires no API key or signup, does not download binary assets, and does not claim capabilities beyond this service boundary. The v0.1.1 npm publication is the release target and has not yet occurred.
12 changes: 12 additions & 0 deletions examples/brand-reference-package/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
# Reusable brand reference package for github.com

Prepare local brand references for GitHub slides, reports, or email work:

```sh
npx @replynodes/brand-kit github.com
```

The package is scoped as `@replynodes/brand-kit`. Version `0.1.1` publication is
the release target and has not happened. Runtime is one GET to
`https://brand.replynodes.com/github.com`; no API key or signup is required, and
no binary downloads are involved.
13 changes: 13 additions & 0 deletions examples/build-landing-page-with-agent/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# Build a landing page with an agent for vercel.com

Give an agent a local, deterministic brand reference package for a Vercel
landing page:

```sh
npx @replynodes/brand-kit vercel.com
```

The package is scoped as `@replynodes/brand-kit`. Version `0.1.1` publication is
the release target and has not happened. Runtime is one GET to
`https://brand.replynodes.com/vercel.com`; no API key or signup is required, and
no binary downloads are involved.
12 changes: 12 additions & 0 deletions examples/css-token-handoff/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
# CSS and token handoff for stripe.com

Generate local CSS and design-token references for a Stripe handoff:

```sh
npx @replynodes/brand-kit stripe.com
```

The package is scoped as `@replynodes/brand-kit`. Version `0.1.1` publication is
the release target and has not happened. Runtime is one GET to
`https://brand.replynodes.com/stripe.com`; no API key or signup is required, and
no binary downloads are involved.
12 changes: 12 additions & 0 deletions examples/design-handoff-audit/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
# Design handoff audit for notion.so

Create a portable set of brand references for auditing a Notion design handoff:

```sh
npx @replynodes/brand-kit notion.so
```

The package is scoped as `@replynodes/brand-kit`. Version `0.1.1` publication is
the release target and has not happened. Runtime is one GET to
`https://brand.replynodes.com/notion.so`; no API key or signup is required, and
no binary downloads are involved.
12 changes: 12 additions & 0 deletions examples/generate-brand-kit/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
# Generate a brand kit for linear.app

Create an agent-ready local brand context package from Linear’s public domain:

```sh
npx @replynodes/brand-kit linear.app
```

The package is scoped as `@replynodes/brand-kit`. Version `0.1.1` publication is
the release target and has not happened. At runtime, the client makes one GET to
`https://brand.replynodes.com/linear.app`; no API key or signup is required, and
no binary downloads are involved.
5 changes: 5 additions & 0 deletions llms.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# @replynodes/brand-kit

Run `npx @replynodes/brand-kit <bare-domain>` with exactly one bare domain. A global install uses `npm install -g @replynodes/brand-kit`, then the executable is `brand-kit <bare-domain>`.

The client makes one HTTPS GET to `https://brand.replynodes.com/{bare-domain}` and writes local brand references and design artifacts. It requires no API key or signup and does not download binary assets. The v0.1.1 npm publication is the release target; the package is intended to be public on npm but is not yet published.
8 changes: 4 additions & 4 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 2 additions & 2 deletions package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "brand-kit",
"version": "0.1.0",
"name": "@replynodes/brand-kit",
"version": "0.1.1",
"description": "Generate a deterministic, agent-ready brand context package from a public brand aggregate.",
"type": "module",
"bin": { "brand-kit": "bin/brand-kit.mjs" },
Expand Down
Loading