# OpenClaw design proposal — maintainer handoff

This is an independent community contribution, not adopted upstream branding. The live Site and its portable source present the same final identity, Claw Sans family, shell texture, character studio, device concepts, voice study and merch collection.

## Start here

1. Read the final family specifications at `/research/typography-v7/family-guide.md` and use the live glyph inspector for exact style measurements.
2. Use the exact SVG identity masters in `OpenClaw-Identity.zip`; the wordmark is artwork, not typeset text.
3. Choose one real upstream surface to evaluate. The examples are interactive design studies, not an OpenClaw Gateway client.
4. Use semantic tokens and accessible primitives. Verify actual words, keyboard operation, enlarged text and target platforms before adoption.
5. Review licensing and provenance for each adopted asset. Upstream maintainers decide what to adopt.

## Resource map

| Area | Files | Details |
|---|---|---|
| Family | `Claw-Sans-0.7.zip` | Ten TTF/WOFF2 styles, all 285 encoded glyphs/style, metrics, production source and OFL 1.1 |
| Editable type | `Claw-Sans-0.7-Fontra.zip` | UFO/native Fontra sources, build guide, preserved outlines and kerning |
| Type evidence | `Claw-Sans-0.7-Proofs.zip` | Full glyph sheets, reading proofs, research and historical comparison evidence |
| Identity | `OpenClaw-Identity.zip` | SVG masters, dimensions and identity specification PDF |
| Textures | `OpenClaw-Textured-Appearance.zip` | Final colourless shell glints/relief, portable CSS, tokens and fallbacks |
| Icon studies | `OpenClaw-Materials-and-Icons.zip` | Unmasked SVG layers for native composition; not compiled Icon Composer files |
| Character | `OpenClaw-Character-Studio.zip` | Transparent solo WebP, six current studio WebPs and provenance |
| Merch | `OpenClaw-Merch.zip` | Current1536px mockups and provenance; not manufacturing-ready tech packs |
| Tokens | `openclaw.tokens.json`, `openclaw.tokens.css` | Portable colour, type, spacing, motion and appearance roles |
| Site | `OpenClaw-Design-Source.zip` | Code, styles, assets, documentation and repeatable checks |
| Integrity | `resource-index.json`, `SHA256SUMS.txt` | Byte sizes, SHA-256 and current/historical labels for downloadable resources |

All named files are under `/downloads/`. The source ZIP excludes other ZIPs and the six large 4K PNGs; retrieve those from the resource index. Its checksum files are generated after packaging to avoid circular hashes. Run `npm run resources` to regenerate them in your checkout.

### Individual 4K studio illustrations

These 3840px PNGs are high-quality local enlargements of the approved artwork, not newly generated native 4K detail. Separate downloads keep each asset below the host's 25MiB limit.

- [Love](/character/studio/01-love-3840.png)
- [Positive empathy](/character/studio/02-positive-empathy-3840.png)
- [Empowerment](/character/studio/03-empowerment-3840.png)
- [Caring](/character/studio/04-caring-3840.png)
- [Celebration](/character/studio/05-celebration-3840.png)
- [Divine wonder](/character/studio/06-divine-wonder-3840.png)

The [solo character](/character/claw-solo.webp) is supplied with transparency. Preserve its anatomy, shell, antennae, positive expression and the recognizable, unobscured icon silhouette. No rigged 3D character or finished animation is included.

## Develop and verify

Use Node 22.13+ and Python 3. Install with `npm ci`; use `npm run dev` for development. Before release, run:

```
npm run resources
npm run check
npm run build
npm run preview
SITE_URL=http://127.0.0.1:8897 npm run verify:site
```

`resources` refreshes documentation copies and current texture/character/merch/source archives, then checks ZIP integrity and emits a checksum index. The font and identity archives are independently authored releases; changing a font requires rebuilding its measurements, proof evidence and editable package together.

`check` runs TypeScript, lint and resource validation. `verify:site` checks all twelve routes, the legacy Materials redirect, unknown-route 404 handling, current Typography content and linked static assets. Set `VERIFY_DOWNLOADS=1` to hash every indexed resource against the running host. HTTP and build checks do not replace browser or native-device accessibility/rendering qualification.

The production preview runs one Worker. Optional `PREVIEW_ALIASES=4180,4181,8901,8903,8905 npm run preview` preserves older local URLs with redirects. Stop it with Ctrl-C; child processes and alias listeners close together. Rebuild before starting the preview. The public Site is deployed from the same validated source and build; never upload credentials, local environment files, caches or runtime state.

## Scope and adoption boundaries

Claw Sans is a static Latin-focused family. There are no variable/optical-size axes or arbitrary combining-mark positioning. Light is for larger headings; Regular/Medium suit reading and controls. Texture CSS approximates shell glass; it is not measured PBR refraction or native Apple Liquid Glass. Voice visualizes states and optionally a user-selected local audio file; it does not capture a microphone or send audio. Merch is illustrative and requires production sampling. Preserve reduced-motion, reduced-transparency, forced-colour and visible-focus behavior.

Original code/tokens are MIT; font software is SIL OFL 1.1; contributor-owned documentation/artwork is CC BY 4.0 to the extent rights can be granted. Third-party marks remain with their owners. No trademark rights or endorsement are implied. See LICENSES.md, CONTRIBUTING.md and per-asset provenance.

## Site verification record

The [release check scope](/research/site-maintenance/verification.json) and [JavaScript bundle measurements](/research/site-maintenance/bundle-comparison.json) provide the technical cleanup evidence. Resource checksums identify every indexed artifact. The same source inputs produce identical resource archives; packaging normalizes ZIP timestamps and permissions.

### Using the portable source ZIP

The source ZIP omits companion ZIPs to avoid nesting large archives. Before regenerating resources from that download, run `npm run resources:restore` once. This explicitly downloads missing current companion resources from the public proposal Site and verifies their published SHA-256 checksums. It does not overwrite existing files or execute downloaded content. Use `npm run resources:restore -- --dry-run` to inspect the missing-file list. A full Git checkout already contains those archives.

Historical character-study PNG originals remain byte-for-byte in `/downloads/OpenClaw-Character.zip`, indexed as historical references. Their redundant loose public copies are omitted to keep the complete hosted bundle within its size limit. Final solo/studio images, original merch masters and all current resources remain available.