# Website integration notes

This folder is an implementation reference for a public brand-resources route.
It is not a patch to the live website.

## Recommended route

`https://www.by4si.com/brand`

Use one stable canonical route. Do not create separate press, logo, media-kit,
and partner pages unless their content becomes materially different.

## Page order

1. Hero with complete-package and guide actions
2. One-sentence identity decision
3. Corporate and Presence examples
4. Four download groups
5. Public Presence family
6. Four non-negotiable rules
7. Permission and contact note

This order lets a visitor download immediately while keeping the core rules
visible before they leave the page.

## Files to publish

- `Brand-Guide/4SI-Brand-Guide-for-Partners-v2.1.pdf`
- `Downloads/4SI-Corporate-Logo-v2.1.zip`
- `Downloads/4SI-Presence-Signatures-v2.1.zip`
- `Downloads/4SI-Digital-Brand-Assets-v2.1.zip`
- `4SI-Online-Brand-Resources-v2.1.zip`
- `4SI-Online-Brand-Resources-v2.1.zip.sha256`

The page template uses relative paths so it can be previewed inside the package.
Replace them with final public asset URLs during integration.

## Download behavior

- Serve ZIP downloads with `Content-Type: application/zip`.
- Serve the guide with `Content-Type: application/pdf`.
- Prefer `Content-Disposition: attachment` for ZIP files.
- Keep version numbers in downloadable filenames.
- The page URL remains unversioned. The files remain versioned.
- Publish the SHA-256 checksum beside the complete package.

## Caching

- Versioned assets: `Cache-Control: public, max-age=31536000, immutable`
- Unversioned HTML and manifest: short cache with revalidation
- Never replace a versioned file with different bytes. Publish a new version.

## Accessibility

- The header logo uses the accessible name `4SI`.
- Decorative previews use an empty alt attribute.
- Product signatures use their exact product names as alt text.
- Every interactive control has a minimum height of 44 pixels.
- Focus visibility must remain at least as strong as the browser default.
- Do not communicate file type, permission, or product role through color alone.

## Analytics

Recommended event:

`brand_resource_download`

Recommended properties:

- `resource_id`
- `resource_version`
- `file_type`
- `page_path`

Do not place tracking parameters inside downloadable files.

## Search and metadata

- Title: `4SI Brand Resources`
- Description: `Official 4SI logos, Presence product signatures, usage
  guidelines, and digital brand assets for partners, press, and approved public
  communication.`
- Canonical: `https://www.by4si.com/brand`
- Expose the partner-guide PDF to search.
- Do not index raw directory listings or checksum files as separate pages.

## Release checklist

- All four page downloads resolve without authentication.
- ZIP files pass integrity checks.
- The complete-package SHA-256 checksum matches.
- Corporate artwork is entirely black or white.
- Key, Layer, and Home names match the current website.
- The current version and update date are visible.
- Permission copy and usage terms are linked.
