# THE DDS HUB brand kit — install guide

## 1. Where each folder goes
- `static/` maps to the web root. `static/favicon.svg` is served as `/favicon.svg`.
- `apple/` and `android/` are handoff sources for native teams. They are not served.
- `source/brand/` holds the master logo files. `social/` holds upload-only images.

## 2. Head tags
Paste `install/head-tags.html` into the `<head>` of every HTML entry page. Keep the `brand-kit:start` and `brand-kit:end` comments.

## 3. Manifest
Serve `static/manifest.webmanifest` with `Content-Type: application/manifest+json`.

## 4. Caching
Give icons and social images a long cache lifetime. When art changes, rename the file or add a version folder. Do not add query strings to `og:image`.

## 5. Loader
Use `static/loader.svg` as an image, or inline its markup with `static/loader.css`. Wrap it in an element with `role="status"` and a visually hidden label such as "Loading" (class `brand-loader-label`). Wait 300 ms before showing it, keep it at least 500 ms once shown, and never use it in place of a real progress bar. Reduced motion shows the static mark (`static/loader-static.svg`).

## 6. Colour tokens
```css
:root {
  --brand-tile: #34D399;
  --brand-tile-hi: #A7F3D0;
  --brand-tile-lo: #059669;
  --brand-ink: #08080A;
  --brand-ink-2: #0E0E11;
  --brand-surface: #F6F6F8;
  --brand-white: #FFFFFF;
  --brand-black: #000000;
  --brand-text: #EDEDF2;
  --brand-text-2: #A3A3AE;
  --brand-text-l: #0E0E14;
  --brand-text-2-l: #4A4A56;
  --brand-accent: #047857;
  --brand-accent-text: #6EE7B7;
  --brand-accent-l: #047857;
}
/* All brand colours are inside sRGB, so no display-p3 overrides are needed. */
```

## 7. Apple native
`apple/AppIcon-1024*.png` and `apple/layers/*.svg` are sources for Icon Composer. Xcode builds every point size from the 1024 source. Do not export legacy sizes by hand.

## 8. Android native
`android/adaptive-*-432.png` are the 108 dp layers at 4×. `android/play-store-512.png` is uploaded in Play Console, not bundled. The `res/` tree was not requested in this kit.

## 9. Social uploads
- `static/social/og-1200x630.jpg` — og:image, twitter:image. Alt text: "THE DDS HUB, the dental practice suite. Skip The Demo. Just Open The App."
- `static/social/og-1200x630.webp` — First-party use. Alt text: "THE DDS HUB, the dental practice suite. Skip The Demo. Just Open The App."
- `social/avatar-1000x1000.png` — Master avatar: Bluesky, YouTube (800), X (400), LinkedIn (400), Instagram (320). Alt text: "THE DDS HUB logo: a teal rounded tile with two white squares above two softer curved shapes."
- `social/avatar-400x400.png` — X, LinkedIn profile photo. Alt text: "THE DDS HUB logo: a teal rounded tile with two white squares above two softer curved shapes."
- `social/x-header-1500x500.png` — X header. Alt text: "THE DDS HUB, the dental practice suite. Skip The Demo. Just Open The App."
- `social/linkedin-share-1200x627.png` — LinkedIn link and image posts. Alt text: "THE DDS HUB, the dental practice suite. Skip The Demo. Just Open The App."
- `social/linkedin-cover-1584x396.png` — LinkedIn personal cover. Alt text: "THE DDS HUB, the dental practice suite. Skip The Demo. Just Open The App."
- `social/linkedin-company-1128x191.png` — LinkedIn company page cover. Alt text: "THE DDS HUB, the dental practice suite. Skip The Demo. Just Open The App."
- `social/youtube-banner-2560x1440.png` — YouTube channel art (safe 1546×423). Alt text: "THE DDS HUB, the dental practice suite. Skip The Demo. Just Open The App."
- `social/story-1080x1920.png` — Instagram Story and Reels, TikTok, YouTube Shorts, Facebook Story. Alt text: "THE DDS HUB, the dental practice suite. Skip The Demo. Just Open The App."
- `social/instagram-square-1080x1080.png` — Instagram and Threads square. Alt text: "THE DDS HUB, the dental practice suite. Skip The Demo. Just Open The App."
- `social/instagram-portrait-1080x1350.png` — Instagram and Threads portrait. Alt text: "THE DDS HUB, the dental practice suite. Skip The Demo. Just Open The App."

## 10. How to verify
Open the Brand Assets page and read Kit checks. Then check the tab icon in a light and a dark browser, install the PWA on one desktop and one phone, and run a link preview debugger for the OG card.

## 11. Checksums
Run `sha256sum -c CHECKSUMS.sha256` in the kit folder.
