<!-- Atunus Home Single-File Complete AI Design System Pack | URL: https://atunus-home-ds-33405.pages.dev -->

---
name: atunus-home-design-system
description: Official Atunus Home (atunushome.com) Design System V2: locked visual DNA, W3C DTCG & CSS tokens, perceptual contrast rules, bilingual copy guardrails (en-US & zh-Hans-US), and canonical storefront page blueprints. Activate whenever designing, coding, reviewing, or writing UI/copy for Atunus Home.
---

# Atunus Home Design System Skill (`atunus-home-design-system`)

> **Dedicated Brand Design System URL**: `https://atunus-home-ds-33405.pages.dev`
> **1-Click Local Refresh Command**:
> ```bash
> python -c "import urllib.request as u; exec(u.urlopen(u.Request('https://atunus-home-ds-33405.pages.dev/save-ds.py', headers={'User-Agent':'Mozilla/5.0'})).read().decode('utf-8'))" ./design-system/atunus-home
> ```

## Quick Integration in Any Frontend / Prototype

1. **Link Brand Tokens & Offline Fonts** (from extracted local folder):
   ```html
   <link rel="stylesheet" href="./tokens/brand-fonts.css">
   <link rel="stylesheet" href="./tokens/tokens.css">
   <link rel="stylesheet" href="./tokens/semantic-bridge.css">
   ```
2. **Core Locked Tokens**:
   - **Canvas / Surface / Band / Footer**: `#FAFAF9` / `#FFFFFF` / `#F3F3F0` / `#292D23`
   - **Primary / Secondary Ink**: `#2A2926` / `#56534F`
   - **Primary CTA Fill / Text / Label**: `#707461` / `#FFFFFF` / `Add to cart` (`加入购物车`)
   - **Button / Card / Input Radius**: `8px` / `12px` / `8px`
   - **Display / Body / CJK Fonts**: `Archivo` / `Archivo` / `Noto Sans SC`
3. **Self-Verify Generated Pages Before Delivery**:
   ```bash
   python tools/ds_lint.py --target path/to/your-page.html
   ```

---

# Atunus Home Design System V2 · AI Agent Replication Guide (`CLAUDE.md`)

## 1. Brand Identity & Business Model

- **Brand**: Atunus Home (`atunushome.com`)
- **Category & Public Price Band**: Whole-Room Coordinated Furniture Sets & Bilingual Spatial Planning DTC | Public storefront single pieces & coordinated room sets (single sofa anchor $1,598; $199/room Room Plan credited within 60 days)
- **Business Model (EN)**: Single-Piece to Whole-Space Furniture DTC + Coordinated Sets + Bilingual Spatial Planning
- **Business Model (ZH)**: Atunus Home（家具与空间方案）：中高端单品到整屋空间方案与中英双语设计咨询 DTC
- **Core Positioning**: From concept to home, all in Atunus. (`从构想到家，尽在 Atunus。` · `From single pieces to complete spaces.`): first Chinese mention locked to `Atunus Home（家具与空间方案）`, spanning single pieces, coordinated sets (`Set saves you $X`), room concepts, free 30-45 min bilingual consultations, `$199/room` Room Plans (100% credited within 60 days), custom pieces (3-business-day quote, 50% deposit), and commercial spaces.
- **Self-Contained Package**: Every token file, offline webfont, bilingual runtime helper, Brand Book chapter, component preview, asset, and specimen referenced below lives inside this folder using portable relative paths.

## 2. Canonical Entrypoints (Read Order)

1. **Machine Contract**: `ai-replication-contract.json` (`schemaVersion: "4.0.0"`)
2. **Design Tokens & Offline Runtime**:
   - Canonical JSON: `tokens/tokens.json`
   - W3C DTCG 10-Group JSON: `tokens/tokens.dtcg.json`
   - Brand CSS Variables: `tokens/tokens.css`
   - 48-Variable Cross-Brand Semantic Bridge: `tokens/semantic-bridge.css`
   - Shopify OS 2.0 Theme Settings Bridge: `tokens/shopify-theme-tokens.css`
   - Multi-Platform Token Exports: `tokens/tailwind.preset.json`, `tokens/tokens.tailwind.config.js`, `tokens/tokens.style-dictionary.json`, `tokens/shopify-settings_schema.json`, `tokens/figma-variables.json`
   - Offline Brand Webfonts & CJK Mono Stack: `tokens/brand-fonts.css` (`assets/Fonts/*.woff2`)
   - Bilingual Switcher Helper: `tokens/ds-i18n.js`
3. **Bilingual Brand Book**:
   - Chinese (`zh-Hans-US` governance): `docs/`
   - English (`en-US` governance): `docs/en/`
4. **Brand Evidence & Dossier**:
   - Manifest: `brand-archive/manifest.json`
   - Official Materials: `brand-archive/official-materials.md` and `brand-archive/en/official-materials.md`
   - Strategic Dossier: `brand-archive/third-party-dossier.md` and `brand-archive/en/third-party-dossier.md`
5. **Interactive Viewers & Candidates**:
   - Standalone Bilingual System Viewer: `index.html` (`?lang=en` / `?lang=zh`)
   - Baseline V1 Structural Specimen: `candidates/baseline_v1/specimen.html`
   - Flagship V2 Interactive Specimen: `candidates/optimized_v2/specimen.html`

## 3. Locked Visual DNA

| Property | Locked Value |
| --- | --- |
| Primary Page Ground | `#FAFAF9` |
| Card / Elevated Surface | `#FFFFFF` |
| Alternating Band / Footer | `#F3F3F0` / `#292D23` |
| Primary / Secondary Ink | `#2A2926` / `#56534F` |
| Primary Action Fill / Text | `#707461` / `#FFFFFF` |
| Button / Card Corner Radius | `8px` / `12px` |
| Display / Body / CJK Fonts | `Archivo` / `Archivo` / `Noto Sans SC` |
| Elevation & Shadow Rule | Calm warm-minimal border (`1px solid #E8E6E1`) and subtle `0 2px 12px rgba(42,41,38,0.05)` lift; `#2A2926` primary body ink, `#56534F` secondary ink, `#292D23` reserved for deep forest footer/inverse band, single Latin font family `Archivo`. |

## 4. Commercial & Legal Guardrails

- **primaryCta**: PDP primary CTA is `Add to cart · $1,598` (or `Add to cart`) / `加入购物车 · $1,598` (`8px` radius, `#707461` sage fill, sentence case). Homepage hero primary CTA is `Shop furniture sets` / `看整套家具` + secondary `Book a consultation` / `预约设计咨询`. Room concept CTA is `Shop the look` / `看整间搭配` + `Plan a room like this` / `照这个房间规划`. Custom/commercial CTA is `Request a custom quote` / `Plan a project space`.
- **eightNonPromises**: ATH-CORE-06 Eight Non-Promises: never promise white-glove delivery, free shipping, free full design, free swatches, third-party sourcing, dedicated concierge, installment financing, or Trade/member discounts.
- **designConsultation**: Free 30-45 min bilingual (`en-US` / `zh-Hans-US`) initial design consultation; `$199/room` Room Plan package credited 100% toward furniture orders placed within 60 days.
- **shippingAndSwatches**: Per-piece transparent lead times (in-stock 3-7 days; made-to-order 8-9 weeks; multi-item orders with mixed lead times ship separately by item schedule). Shipping is calculated by region and shipment batch at checkout (rate table [NEED ALLEN REVIEW]). Paid fabric swatches only (non-returnable; never promise free swatches).
- **returns**: 30-day returns on unused in-stock items in original packaging (no restocking fee; regional return pickup fee [NEED ALLEN REVIEW]; original shipping non-refundable; MTO/custom/clearance/display/swatches final sale; report transit damage within 7 days).
- **warranty**: Limited warranty: 5-year frame, 2-year other components, 1-year upholstery/leather/lighting/mirrors/accessories (pending written manufacturer sign-off [NEED ALLEN REVIEW]).
- **photographyNotice**: Images under `assets/Photos/` are Editorial Reference Photography (mood and material reference only, non-SKU) until studio SKU photography is supplied.

## 5. Non-Negotiable Redlines

- Always use official domain `atunushome.com` (never `atunus.com`) and first Chinese mention `Atunus Home（家具与空间方案）`.
- Enforce `ATH-CORE-06` Eight Non-Promises: strictly zero promises of white-glove delivery, free shipping, free swatches, free full design, third-party sourcing, dedicated concierge, installments, or Trade/member dual-track pricing.
- Use single Latin font family `Archivo` (600/500/400) + `Noto Sans SC`, `#2A2926` primary body ink, `#56534F` secondary ink, `#292D23` forest footer, and `#707461` `8px` sentence-case CTAs (`Add to cart`, `Shop furniture sets`, `Shop the look`, `Book a consultation`).
- State split-shipment transparency (`in-stock 3-7 days; MTO 8-9 weeks; multi-item orders ship by item lead time`) and preserve `[NEED ALLEN REVIEW]` on regional shipping rates, regional return pickup fees, and manufacturer sign-off for the `5/2/1-year` warranty.
- Label `assets/Photos/` clearly as `Editorial Reference Photography` (non-SKU mood reference), and maintain `zh-Hans-US` parity (polite `您`, `$1,598` USD format, CJK-Latin half-width spacing).

## 6. Nine Canonical Page Blueprints

| Blueprint ID | Primary Specimen (`en-US`) | Localized Specimen (`zh-Hans-US`) | Implementation Notes |
| --- | --- | --- | --- |
| `PageHome` | `components/PageHome/preview.html` | `components/PageHomeZh/preview.html` | 1440px homepage (`PageHome`, `PageHomeMobile`, `PageHomeZh`) leading with `Shop furniture sets` + `Book a consultation`. |
| `PageCategoryHub` | `components/PageRoomConcept/preview.html` | `components/PageRoomConceptZh/preview.html` | Spatial room hub (`PageRoomConcept` / `PageRoomConceptZh`) with `Shop the look` + `Plan a room like this`. |
| `PagePLPWithFacetDrawer` | `components/PagePLP/preview.html` | `components/PagePLPZh/preview.html` | Interactive collection grid (`PagePLP`, `PagePLPMobile`, `PagePLPZh`) showing in-stock `3-7d` vs MTO `8-9w` lead times. |
| `PagePDPFullLongScroll` | `components/PagePDP/preview.html` | `components/PagePDPZh/preview.html` | Supports Single Piece (`Add to cart · $1,598`) and Coordinated Set (`Set saves you $X`) modes with split-delivery transparency. |
| `CartDrawer` | `components/PageCart/preview.html` | `components/PageCartZh/preview.html` | Slide-over `AddedToCart` drawer plus `PageCart` / `PageCartZh` calculating shipping by region and shipment batch at checkout. |
| `PageTradeOrConsultation` | `components/PageConsultation/preview.html` | `components/PageConsultationZh/preview.html` | Bilingual consultation flow (`PageConsultation`, `PageConsultationZh`) for residential Room Plans and commercial space inquiries. |
| `PageEditorialLookbook` | `components/ShopTheLook/preview.html` | `components/PageRoomConceptZh/preview.html` | Editorial room scenes (`ShopTheLook` + `PageRoomConcept`) using labeled Editorial Reference Photography. |
| `PageCraftsmanshipStory` | `components/PageAbout/preview.html` | `components/PageAboutZh/preview.html` | Canonical brand story from `01-brand-core.md` in English (`PageAbout`) and `zh-Hans-US` (`PageAboutZh`). |
| `PageFreeSwatchesStudio` | `components/SwatchPicker/preview.html` | `components/SwatchCard/preview.html` | Paid material swatch selector (non-returnable per `ATH-CORE-06`) paired with 30-45 min design consultations. |

## 7. Bilingual Copy & Typography Checklist (`en-US` & `zh-Hans-US`)

- **Preferred `en-US` Terms**: `From concept to home, all in Atunus.`, `From single pieces to complete spaces.`, `Add to cart`, `Shop furniture sets`, `Shop the look`, `Book a consultation`, `Set saves you`
- **Prohibited `en-US` Terms**: `atunus.com`, `Verified US Buyers`, `Shop the Room`, `ADD ROOM SET`, `White-glove delivery`, `Complimentary swatch kit`, `Trade discount`, `30-Day In-Home Trial`
- **Preferred `zh-Hans-US` Terms**: `从构想到家，尽在 Atunus。`, `Atunus Home（家具与空间方案）`, `加入购物车`, `看整套家具`, `看整间搭配`, `预约设计咨询`, `每个房间 $199（60 天内下单全额抵扣）`
- **Prohibited `zh-Hans-US` Terms**: `美元`, `美刀`, `包邮`, `亲`, `atunus.com`, `白手套送装`, `免费小样`, `选购整屋搭配`, `30 天试用`
- **Imperial Furniture Units**: Always format inches with `"` and feet with `'` (for example `96"W x 38"D x 30"H` and `12' x 14'` room size). Always state Overall Depth separately from Inside Seat Depth (`22"` to `28"`).

---

## Machine Replication Contract (`ai-replication-contract.json` Core)

```json
{
  "schemaVersion": "4.0.0",
  "brand": {
    "key": "atunus",
    "folder": "15_Atunus_Home",
    "name": "Atunus Home",
    "domain": "atunushome.com",
    "siteUrl": "https://atunushome.com",
    "isOwnBrand": true,
    "bmTrack": "BM0",
    "category": "Whole-Room Coordinated Furniture Sets & Bilingual Spatial Planning DTC",
    "categoryZh": "单品到整屋空间方案与中英双语设计咨询 DTC",
    "publicPriceAnchor": "Public storefront single pieces & coordinated room sets (single sofa anchor $1,598; $199/room Room Plan credited within 60 days)"
  },
  "businessModel": {
    "en": "Single-Piece to Whole-Space Furniture DTC + Coordinated Sets + Bilingual Spatial Planning",
    "zh": "Atunus Home（家具与空间方案）：中高端单品到整屋空间方案与中英双语设计咨询 DTC",
    "positioning": "From concept to home, all in Atunus. (`从构想到家，尽在 Atunus。` · `From single pieces to complete spaces.`): first Chinese mention locked to `Atunus Home（家具与空间方案）`, spanning single pieces, coordinated sets (`Set saves you $X`), room concepts, free 30-45 min bilingual consultations, `$199/room` Room Plans (100% credited within 60 days), custom pieces (3-business-day quote, 50% deposit), and commercial spaces."
  },
  "visualDna": {
    "bgCanvas": "#FAFAF9",
    "bgSurface": "#FFFFFF",
    "bgBand": "#F3F3F0",
    "bgFooter": "#292D23",
    "inkPrimary": "#2A2926",
    "inkSecondary": "#56534F",
    "inkMuted": "#7A7670",
    "borderSubtle": "#E8E6E1",
    "actionPrimaryBg": "#707461",
    "actionPrimaryFg": "#FFFFFF",
    "accentTerracotta": "#A85A3D",
    "radiusButton": "8px",
    "radiusCard": "12px",
    "radiusInput": "8px",
    "shadowPolicy": "Calm warm-minimal border (`1px solid #E8E6E1`) and subtle `0 2px 12px rgba(42,41,38,0.05)` lift; `#2A2926` primary body ink, `#56534F` secondary ink, `#292D23` reserved for deep forest footer/inverse band, single Latin font family `Archivo`.",
    "fontDisplay": "Archivo",
    "fontBody": "Archivo",
    "fontCjk": "Noto Sans SC"
  },
  "commercialPolicies": {
    "primaryCta": "PDP primary CTA is `Add to cart · $1,598` (or `Add to cart`) / `加入购物车 · $1,598` (`8px` radius, `#707461` sage fill, sentence case). Homepage hero primary CTA is `Shop furniture sets` / `看整套家具` + secondary `Book a consultation` / `预约设计咨询`. Room concept CTA is `Shop the look` / `看整间搭配` + `Plan a room like this` / `照这个房间规划`. Custom/commercial CTA is `Request a custom quote` / `Plan a project space`.",
    "eightNonPromises": "ATH-CORE-06 Eight Non-Promises: never promise white-glove delivery, free shipping, free full design, free swatches, third-party sourcing, dedicated concierge, installment financing, or Trade/member discounts.",
    "designConsultation": "Free 30-45 min bilingual (`en-US` / `zh-Hans-US`) initial design consultation; `$199/room` Room Plan package credited 100% toward furniture orders placed within 60 days.",
    "shippingAndSwatches": "Per-piece transparent lead times (in-stock 3-7 days; made-to-order 8-9 weeks; multi-item orders with mixed lead times ship separately by item schedule). Shipping is calculated by region and shipment batch at checkout (rate table [NEED ALLEN REVIEW]). Paid fabric swatches only (non-returnable; never promise free swatches).",
    "returns": "30-day returns on unused in-stock items in original packaging (no restocking fee; regional return pickup fee [NEED ALLEN REVIEW]; original shipping non-refundable; MTO/custom/clearance/display/swatches final sale; report transit damage within 7 days).",
    "warranty": "Limited warranty: 5-year frame, 2-year other components, 1-year upholstery/leather/lighting/mirrors/accessories (pending written manufacturer sign-off [NEED ALLEN REVIEW]).",
    "photographyNotice": "Images under `assets/Photos/` are Editorial Reference Photography (mood and material reference only, non-SKU) until studio SKU photography is supplied."
  },
  "nonNegotiableRedlines": [
    "Always use official domain `atunushome.com` (never `atunus.com`) and first Chinese mention `Atunus Home（家具与空间方案）`.",
    "Enforce `ATH-CORE-06` Eight Non-Promises: strictly zero promises of white-glove delivery, free shipping, free swatches, free full design, third-party sourcing, dedicated concierge, installments, or Trade/member dual-track pricing.",
    "Use single Latin font family `Archivo` (600/500/400) + `Noto Sans SC`, `#2A2926` primary body ink, `#56534F` secondary ink, `#292D23` forest footer, and `#707461` `8px` sentence-case CTAs (`Add to cart`, `Shop furniture sets`, `Shop the look`, `Book a consultation`).",
    "State split-shipment transparency (`in-stock 3-7 days; MTO 8-9 weeks; multi-item orders ship by item lead time`) and preserve `[NEED ALLEN REVIEW]` on regional shipping rates, regional return pickup fees, and manufacturer sign-off for the `5/2/1-year` warranty.",
    "Label `assets/Photos/` clearly as `Editorial Reference Photography` (non-SKU mood reference), and maintain `zh-Hans-US` parity (polite `您`, `$1,598` USD format, CJK-Latin half-width spacing)."
  ],
  "copyLexicon": {
    "preferredEn": [
      "From concept to home, all in Atunus.",
      "From single pieces to complete spaces.",
      "Add to cart",
      "Shop furniture sets",
      "Shop the look",
      "Book a consultation",
      "Set saves you"
    ],
    "bannedEn": [
      "atunus.com",
      "Verified US Buyers",
      "Shop the Room",
      "ADD ROOM SET",
      "White-glove delivery",
      "Complimentary swatch kit",
      "Trade discount",
      "30-Day In-Home Trial"
    ],
    "preferredZh": [
      "从构想到家，尽在 Atunus。",
      "Atunus Home（家具与空间方案）",
      "加入购物车",
      "看整套家具",
      "看整间搭配",
      "预约设计咨询",
      "每个房间 $199（60 天内下单全额抵扣）"
    ],
    "bannedZh": [
      "美元",
      "美刀",
      "包邮",
      "亲",
      "atunus.com",
      "白手套送装",
      "免费小样",
      "选购整屋搭配",
      "30 天试用"
    ]
  },
  "perceptualAndMotionPhysics": {
    "schemaRevision": "4.0.0",
    "colorSpace": "OKLCH (Bjorn Ottosson 2020 perceptual cylindrical space)",
    "oklchPalette": {
      "bgCanvas": {
        "hex": "#FAFAF9",
        "l": 0.9848,
        "c": 0.0013,
        "h": 106.42,
        "css": "oklch(0.9848 0.0013 106.42)",
        "isAchromatic": true
      },
      "bgSurface": {
        "hex": "#FFFFFF",
        "l": 1.0,
        "c": 0.0,
        "h": 0.0,
        "css": "oklch(1.0000 0.0000 0.00)",
        "isAchromatic": true
      },
      "bgSubtle": {
        "hex": "#F3F3F0",
        "l": 0.9633,
        "c": 0.004,
        "h": 106.47,
        "css": "oklch(0.9633 0.0040 106.47)",
        "isAchromatic": false
      },
      "textPrimary": {
        "hex": "#2A2926",
        "l": 0.2809,
        "c": 0.0056,
        "h": 91.57,
        "css": "oklch(0.2809 0.0056 91.57)",
        "isAchromatic": false
      },
      "textSecondary": {
        "hex": "#56534F",
        "l": 0.4438,
        "c": 0.0075,
        "h": 75.34,
        "css": "oklch(0.4438 0.0075 75.34)",
        "isAchromatic": false
      },
      "textMuted": {
        "hex": "#6E6E6E",
        "l": 0.5382,
        "c": 0.0,
        "h": 0.0,
        "css": "oklch(0.5382 0.0000 0.00)",
        "isAchromatic": true
      },
      "borderSubtle": {
        "hex": "#E8E6E1",
        "l": 0.9251,
        "c": 0.0071,
        "h": 88.65,
        "css": "oklch(0.9251 0.0071 88.65)",
        "isAchromatic": false
      },
      "ctaBg": {
        "hex": "#707461",
        "l": 0.5499,
        "c": 0.0289,
        "h": 117.02,
        "css": "oklch(0.5499 0.0289 117.02)",
        "isAchromatic": false
      },
      "ctaText": {
        "hex": "#FFFFFF",
        "l": 1.0,
        "c": 0.0,
        "h": 0.0,
        "css": "oklch(1.0000 0.0000 0.00)",
        "isAchromatic": true
      },
      "accent": {
        "hex": "#707461",
        "l": 0.5499,
        "c": 0.0289,
        "h": 117.02,
        "css": "oklch(0.5499 0.0289 117.02)",
        "isAchromatic": false
      },
      "footerBg": {
        "hex": "#292D23",
        "l": 0.2897,
        "c": 0.0185,
        "h": 125.29,
        "css": "oklch(0.2897 0.0185 125.29)",
        "isAchromatic": false
      },
      "footerText": {
        "hex": "#FFFFFF",
        "l": 1.0,
        "c": 0.0,
        "h": 0.0,
        "css": "oklch(1.0000 0.0000 0.00)",
        "isAchromatic": true
      }
    },
    "canvasToleranceGate": {
      "targetHex": "#FAFAF9",
      "targetOklch": "oklch(0.9848 0.0013 106.42)",
      "maxAbsDeltaL": 0.03,
      "maxAbsDeltaC": 0.02
    },
    "contrastMatrix": {
      "algorithm": "APCA-W3 (0.0.98G-4g) + WCAG 2.1 Relative Luminance",
      "pairs": {
        "bodyOnCanvas": {
          "role": "Editorial body & headings on primary canvas",
          "foregroundHex": "#2A2926",
          "backgroundHex": "#FAFAF9",
          "foregroundOklch": "oklch(0.2809 0.0056 91.57)",
          "backgroundOklch": "oklch(0.9848 0.0013 106.42)",
          "apcaLc": 98.32,
          "apcaAbsLc": 98.32,
          "apcaPolarity": "BoW (dark-on-light)",
          "apcaTargetAbsLc": 75.0,
          "apcaPasses": true,
          "wcag21Ratio": 13.93
        },
        "bodyOnSurface": {
          "role": "Card & specification copy on secondary surface",
          "foregroundHex": "#2A2926",
          "backgroundHex": "#FFFFFF",
          "foregroundOklch": "oklch(0.2809 0.0056 91.57)",
          "backgroundOklch": "oklch(1.0000 0.0000 0.00)",
          "apcaLc": 101.36,
          "apcaAbsLc": 101.36,
          "apcaPolarity": "BoW (dark-on-light)",
          "apcaTargetAbsLc": 75.0,
          "apcaPasses": true,
          "wcag21Ratio": 14.55
        },
        "secondaryOnCanvas": {
          "role": "Metadata & dimension captions on primary canvas",
          "foregroundHex": "#56534F",
          "backgroundHex": "#FAFAF9",
          "foregroundOklch": "oklch(0.4438 0.0075 75.34)",
          "backgroundOklch": "oklch(0.9848 0.0013 106.42)",
          "apcaLc": 83.56,
          "apcaAbsLc": 83.56,
          "apcaPolarity": "BoW (dark-on-light)",
          "apcaTargetAbsLc": 55.0,
          "apcaPasses": true,
          "wcag21Ratio": 7.32
        },
        "ctaLabelOnFill": {
          "role": "Primary CTA button label on solid CTA fill",
          "foregroundHex": "#FFFFFF",
          "backgroundHex": "#707461",
          "foregroundOklch": "oklch(1.0000 0.0000 0.00)",
          "backgroundOklch": "oklch(0.5499 0.0289 117.02)",
          "apcaLc": -78.86,
          "apcaAbsLc": 78.86,
          "apcaPolarity": "WoB (light-on-dark)",
          "apcaTargetAbsLc": 60.0,
          "apcaPasses": true,
          "wcag21Ratio": 4.82
        },
        "footerLabelOnGround": {
          "role": "Footer navigation copy on footer ground",
          "foregroundHex": "#FFFFFF",
          "backgroundHex": "#292D23",
          "foregroundOklch": "oklch(1.0000 0.0000 0.00)",
          "backgroundOklch": "oklch(0.2897 0.0185 125.29)",
          "apcaLc": -103.74,
          "apcaAbsLc": 103.74,
          "apcaPolarity": "WoB (light-on-dark)",
          "apcaTargetAbsLc": 60.0,
          "apcaPasses": true,
          "wcag21Ratio": 14.06
        }
      },
      "cvdDistinguishability": {
        "deuteranopiaCtaPair": {
          "ctaBgSimHex": "#767262",
          "ctaFgSimHex": "#FFFFFF",
          "apcaAbsLcUnderDeuteranopia": 78.91,
          "ctaVsCanvasDeltaEOk": 0.4345
        },
        "protanopiaCtaPair": {
          "ctaBgSimHex": "#777260",
          "ctaFgSimHex": "#FFFFFF",
          "apcaAbsLcUnderProtanopia": 78.86,
          "ctaVsCanvasDeltaEOk": 0.4343
        }
      }
    },
    "typographyOpticalMetrics": {
      "bundledWoff2Count": 16,
      "bundledWoff2Files": [
        {
          "file": "assets/Fonts/archivo-latin-300-normal.woff2",
          "bytes": 14444,
          "sha256Prefix": "24a97635cc12"
        },
        {
          "file": "assets/Fonts/archivo-latin-400-normal.woff2",
          "bytes": 14700,
          "sha256Prefix": "07f9160163da"
        },
        {
          "file": "assets/Fonts/archivo-latin-500-normal.woff2",
          "bytes": 14600,
          "sha256Prefix": "ab74eca5ad11"
        },
        {
          "file": "assets/Fonts/archivo-latin-600-normal.woff2",
          "bytes": 34928,
          "sha256Prefix": "8f704806dbed"
        },
        {
          "file": "assets/Fonts/archivo-latin-700-normal.woff2",
          "bytes": 34928,
          "sha256Prefix": "8f704806dbed"
        },
        {
          "file": "assets/Fonts/archivo-latin-ext-300-normal.woff2",
          "bytes": 32608,
          "sha256Prefix": "ff4f17d21930"
        },
        {
          "file": "assets/Fonts/archivo-latin-ext-400-normal.woff2",
          "bytes": 32608,
          "sha256Prefix": "ff4f17d21930"
        },
        {
          "file": "assets/Fonts/archivo-latin-ext-500-normal.woff2",
          "bytes": 32608,
          "sha256Prefix": "ff4f17d21930"
        },
        {
          "file": "assets/Fonts/archivo-latin-ext-600-normal.woff2",
          "bytes": 32608,
          "sha256Prefix": "ff4f17d21930"
        },
        {
          "file": "assets/Fonts/archivo-latin-ext-700-normal.woff2",
          "bytes": 32608,
          "sha256Prefix": "ff4f17d21930"
        },
        {
          "file": "assets/Fonts/jetbrains-mono-latin-400-normal.woff2",
          "bytes": 31432,
          "sha256Prefix": "83c005d49d8a"
        },
        {
          "file": "assets/Fonts/jetbrains-mono-latin-500-normal.woff2",
          "bytes": 31432,
          "sha256Prefix": "83c005d49d8a"
        },
        {
          "file": "assets/Fonts/jetbrains-mono-latin-600-normal.woff2",
          "bytes": 31432,
          "sha256Prefix": "83c005d49d8a"
        },
        {
          "file": "assets/Fonts/jetbrains-mono-latin-ext-400-normal.woff2",
          "bytes": 11624,
          "sha256Prefix": "db5ff4db83e5"
        },
        {
          "file": "assets/Fonts/jetbrains-mono-latin-ext-500-normal.woff2",
          "bytes": 11624,
          "sha256Prefix": "db5ff4db83e5"
        },
        {
          "file": "assets/Fonts/jetbrains-mono-latin-ext-600-normal.woff2",
          "bytes": 11624,
          "sha256Prefix": "db5ff4db83e5"
        }
      ],
      "display": {
        "fileName": "archivo-latin-300-normal.woff2",
        "byteSize": 14444,
        "sha256Prefix": "24a97635cc12",
        "family": "Archivo SemiBold Light",
        "unitsPerEm": 1000,
        "sxHeight": 526,
        "sCapHeight": 686,
        "sTypoAscender": 878,
        "sTypoDescender": -210,
        "xHeightRatio": 0.526,
        "capHeightRatio": 0.686,
        "cssFontSizeAdjust": "ex-height 0.5260",
        "ascentOverridePct": "87.80%",
        "descentOverridePct": "21.00%",
        "lineGapOverridePct": "0.00%",
        "extractionMethod": "live_woff2_binary_tables",
        "configuredFamily": "Archivo"
      },
      "sans": {
        "fileName": "archivo-latin-300-normal.woff2",
        "byteSize": 14444,
        "sha256Prefix": "24a97635cc12",
        "family": "Archivo SemiBold Light",
        "unitsPerEm": 1000,
        "sxHeight": 526,
        "sCapHeight": 686,
        "sTypoAscender": 878,
        "sTypoDescender": -210,
        "xHeightRatio": 0.526,
        "capHeightRatio": 0.686,
        "cssFontSizeAdjust": "ex-height 0.5260",
        "ascentOverridePct": "87.80%",
        "descentOverridePct": "21.00%",
        "lineGapOverridePct": "0.00%",
        "extractionMethod": "live_woff2_binary_tables",
        "configuredFamily": "Archivo"
      },
      "mono": {
        "fileName": "jetbrains-mono-latin-400-normal.woff2",
        "byteSize": 31432,
        "sha256Prefix": "83c005d49d8a",
        "family": "JetBrains Mono",
        "unitsPerEm": 1000,
        "sxHeight": 550,
        "sCapHeight": 730,
        "sTypoAscender": 1020,
        "sTypoDescender": -300,
        "xHeightRatio": 0.55,
        "capHeightRatio": 0.73,
        "cssFontSizeAdjust": "ex-height 0.5500",
        "ascentOverridePct": "102.00%",
        "descentOverridePct": "30.00%",
        "lineGapOverridePct": "0.00%",
        "extractionMethod": "live_woff2_binary_tables",
        "configuredFamily": "JetBrains Mono"
      },
      "clsTargetMax": 0.01
    },
    "motionPhysics": {
      "archetype": "warm_residential_architectural",
      "archetypeLabelZh": "温润居住空间阻尼动效（稳重自然、零浮夸弹跳）",
      "archetypeLabelEn": "Warm Residential Architectural Motion (Composed Natural Settle)",
      "easePrimary": "cubic-bezier(0.25, 1, 0.5, 1)",
      "easeDrawer": "cubic-bezier(0.22, 1, 0.36, 1)",
      "easeExit": "cubic-bezier(0.4, 0, 1, 1)",
      "durationMicroMs": 160,
      "durationDrawerMs": 320,
      "durationEditorialRevealMs": 500,
      "springOvershootAllowed": false,
      "reducedMotionPolicy": "Honor `@media (prefers-reduced-motion: reduce)` by limiting transitions to <=120ms opacity changes."
    }
  },
  "artDirectionAndOpticalSpec": {
    "archetype": "residential_afternoon_window_light",
    "archetypeLabelZh": "北美住宅午后自然窗光与真实材质肌理光学",
    "archetypeLabelEn": "North American Residential Window Light & True Material Grain Optics",
    "lensFocalLengthMm": "35mm-50mm rectilinear living/dining lens + 85mm upholstery & wood-grain macro",
    "daylightKelvinRange": "4800K-5300K balanced residential window daylight",
    "lightingContrastRatio": "2.4:1 soft directional window key light preserving warm undertones",
    "cameraElevationCm": "105cm-120cm residential eye line with level horizon and vertical wall edges",
    "shadowDiscipline": "Soft grounded room shadows matching window light direction; calm card elevation.",
    "macroTextureShareMin": "25% close-up frames documenting wood joinery, cushion crown, and fabric hand-feel",
    "brandOpticalGuardrail": "Render solid timber, stone, and upholstery under calm 5000K organic daylight on #FAFAF9 alabaster ground with muted #707461 olive-slate accents (`atunushome.com` canonical domain).",
    "fiveShotPdpSequenceEn": [
      "01 Architectural Room Hero",
      "02 Three-Quarter Distortion-Free Silhouette",
      "03 85mm Material Surface & Craft Detail Macro",
      "04 Human Scale & Entryway Clearance Elevation",
      "05 Structural Base & Protective Packaging Detail"
    ],
    "fiveShotPdpSequenceZh": [
      "01 北美真实居住空间主景",
      "02 四分之三零畸变单品体量",
      "03 85mm 表面材质肌理与工艺细节微距",
      "04 人体尺度比例与入户通行净宽立面",
      "05 底部承重结构与包装防护细节"
    ],
    "threeKelvinLightingSimulator": [
      {
        "kelvin": 6500,
        "id": "daylight_6500k",
        "labelEn": "6500K North Daylight",
        "labelZh": "6500K 朝北晴空自然光"
      },
      {
        "kelvin": 4000,
        "id": "gallery_4000k",
        "labelEn": "4000K Gallery Neutral",
        "labelZh": "4000K 展厅中性白光"
      },
      {
        "kelvin": 2700,
        "id": "evening_2700k",
        "labelEn": "2700K Warm Evening",
        "labelZh": "2700K 居家夜间暖光"
      }
    ],
    "positivePromptEn": "Architectural & product photography for Atunus Home (atunushome.com), canvas ground #FAFAF9 (oklch(0.9848 0.0013 106.42)), shot on 35mm-50mm rectilinear living/dining lens + 85mm upholstery & wood-grain macro, 4800K-5300K balanced residential window daylight, 2.4:1 soft directional window key light preserving warm undertones, 105cm-120cm residential eye line with level horizon and vertical wall edges, authentic matte surface texture, zero CGI plastic sheen, zero wide-angle edge distortion. Render solid timber, stone, and upholstery under calm 5000K organic daylight on #FAFAF9 alabaster ground with muted #707461 olive-slate accents (`atunushome.com` canonical domain).",
    "positivePromptZh": "Atunus Home（atunushome.com）空间与单品光学规范：主画布基准色 #FAFAF9（oklch(0.9848 0.0013 106.42)），采用 35mm-50mm rectilinear living/dining lens + 85mm upholstery & wood-grain macro 焦段，4800K-5300K balanced residential window daylight 照明色温，2.4:1 soft directional window key light preserving warm undertones 光比与 105cm-120cm residential eye line with level horizon and vertical wall edges 机位高度；保留哑光天然材质肌理，严禁塑料反光感、高饱和促销滤镜与广角边缘拉伸。"
  }
}
```

---

## Production CSS Custom Properties (`tokens/tokens.css`)

```css
/* Atunus Home — tokens.css compiled from tokens.json for local use (2026-10-22). Edit tokens.json, not this file. */
:root, [data-theme="atunus-home"] {
  --brand-100: #eeefe6;
  --brand-200: #e2e3d7;
  --brand-500: #8b8f7c;
  --brand-600: #707461;
  --brand-700: #565a49;
  --brand-800: #3d4134;
  --brand-900: #292d23;
  --neutral-white: #ffffff;
  --neutral-400: #bebbb4;
  --bg-base: #fafaf9;
  --bg-white: #ffffff;
  --bg-section: #f3f3f0;
  --surface-brand: #f7f8f2;
  --surface-card: #ffffff;
  --surface-muted: #e8e7e2;
  --surface-subtle: #f3f3f0;
  --surface-fill-selected: #eeefe6;
  --text-primary: #2a2926;
  --text-secondary: #56534f;
  --text-text-2: #696765;
  --text-tertiary: #98958f;
  --text-disabled: #bebbb4;
  --text-brand: #707461;
  --text-inverse: #fafaf9;
  --border-subtle: #e8e7e2;
  --border-base: #d7d5cf;
  --border-strong: #98958f;
  --border-brand: #707461;
  --action-primary: #707461;
  --action-primary-hover: #565a49;
  --action-primary-active: #3d4134;
  --action-secondary: #eeefe6;
  --action-secondary-hover: #e2e3d7;
  --action-disabled: #e8e7e2;
  --state-error: #b94a3e;
  --state-warning: #b8895a;
  --sale-sale: #b96a4c;
  --other-overlay: rgba(23, 22, 19, 0.48);
  --logo-ink: #171613;
  --overlay-image: rgba(0, 0, 0, 0.2);
  --header-gradient: rgba(86, 90, 73, 0.8);
  --neutral-500: #8f8c86;
  --sale-700: #a85a3d;
  --warning-700: #936637;
  --state-error-100: #f9f1f0;
  --state-warning-100: #f8f3ee;
  --overlay-strong: rgba(23, 22, 19, 0.64);
  --text-subtle: var(--text-text-2);
  --control-border: var(--neutral-500);
  --control-border-hover: var(--text-secondary);
  --control-border-focus: var(--border-brand);
  --choice-border: var(--neutral-500);
  --choice-checked: var(--action-primary);
  --action-secondary-text: var(--brand-700);
  --text-eyebrow: var(--brand-700);
  --action-outline-text: var(--brand-700);
  --rating-star: var(--text-primary);
  --price-sale: var(--sale-700);
  --price-compare: var(--text-secondary);
  --badge-neutral-bg: var(--brand-100);
  --badge-neutral-text: var(--brand-700);
  --badge-set-bg: var(--brand-600);
  --badge-set-text: var(--text-inverse);
  --badge-new-bg: var(--brand-100);
  --badge-new-text: var(--brand-700);
  --badge-bestseller-bg: var(--brand-800);
  --badge-bestseller-text: var(--text-inverse);
  --badge-sale-bg: var(--sale-700);
  --badge-sale-text: var(--neutral-white);
  --count-badge-bg: var(--sale-700);
  --feedback-error-text: var(--state-error);
  --feedback-error-bg: var(--state-error-100);
  --feedback-warning-text: var(--warning-700);
  --feedback-warning-bg: var(--state-warning-100);
  --feedback-success-text: var(--brand-700);
  --feedback-success-bg: var(--brand-100);
  --delivery-extended-text: var(--text-secondary);
  --focus-ring-color: var(--brand-800);
  --focus-ring-inverse-color: var(--text-inverse);
  --shadow-card: 0 4px 10px rgba(0, 0, 0, 0.02), 0 4px 5px rgba(0, 0, 0, 0.02);
  --shadow-overlay: 0 12px 32px rgba(23, 22, 19, 0.16), 0 2px 6px rgba(23, 22, 19, 0.08);
  --focus-ring: 0 0 0 2px #fafaf9, 0 0 0 4px #3d4134;
  --focus-ring-inverse: 0 0 0 2px #292d23, 0 0 0 4px #fafaf9;
}
:root {
  --padding-lr: 40px;
  --padding-lr-t: 20px;
  --page-gutter-m: 16px;
  --padding-tb: 60px;
  --padding-tb-t: 40px;
  --padding-tb-m: 32px;
  --space-4: 4px;
  --space-8: 8px;
  --space-12: 12px;
  --space-16: 16px;
  --space-20: 20px;
  --space-24: 24px;
  --space-32: 32px;
  --space-40: 40px;
  --space-48: 48px;
  --space-60: 60px;
  --space-80: 80px;
  --radius-xs: 4px;
  --radius-sm: 6px;
  --radius-md: 8px;
  --radius-lg: 12px;
  --radius-full: 999px;
  --display-1: 72px;
  --display-1-t: 56px;
  --display-1-m: 36px;
  --display-2: 56px;
  --display-2-t: 44px;
  --display-2-m: 34px;
  --heading-h1: 48px;
  --heading-h1-t: 40px;
  --heading-h1-m: 32px;
  --heading-h2: 40px;
  --heading-h2-t: 32px;
  --heading-h2-m: 28px;
  --heading-h3: 32px;
  --heading-h3-t: 28px;
  --heading-h3-m: 22px;
  --heading-h4: 24px;
  --heading-h4-m: 20px;
  --heading-h5: 20px;
  --heading-h5-m: 18px;
  --heading-h6: 18px;
  --heading-h6-m: 16px;
  --body-large: 18px;
  --body-large-m: 16px;
  --body-base: 16px;
  --body-base-m: 14px;
  --body-small: 14px;
  --body-small-m: 12px;
  --body-caption: 12px;
  --price-large-m: 24px;
  --zh-display-1: 64px;
  --zh-display-1-t: 48px;
  --zh-display-1-m: 32px;
  --zh-display-2: 48px;
  --zh-display-2-t: 40px;
  --zh-display-2-m: 30px;
  --zh-heading-h1: 40px;
  --zh-heading-h1-t: 34px;
  --zh-heading-h1-m: 28px;
  --zh-heading-h2: 34px;
  --zh-heading-h2-t: 28px;
  --zh-heading-h2-m: 24px;
  --zh-heading-h3: 28px;
  --zh-heading-h3-t: 24px;
  --zh-heading-h3-m: 20px;
  --zh-heading-h4: 22px;
  --zh-heading-h4-m: 19px;
  --zh-heading-h5: 18px;
  --zh-heading-h5-m: 17px;
  --zh-heading-h6: 16px;
  --zh-heading-h6-m: 15px;
  --zh-body-base-m: 15px;
  --zh-body-small-m: 13px;
  --control-lg: 48px;
  --control-md: 40px;
  --control-sm: 36px;
  --icon-sm: 16px;
  --icon-md: 20px;
  --icon-lg: 24px;
  --icon-btn-md: 18px;
  --icon-btn-lg: 22px;
  --bp-mobile: 390px;
  --bp-tablet: 800px;
  --bp-desktop: 1440px;
  --bp-max-mobile: 599px;
  --bp-max-tablet: 1023px;
  --container-max: 1360px;
  --grid-gap: 24px;
  --grid-gap-m: 16px;
  --z-header: 100;
  --z-drawer: 300;
  --z-toast: 500;
  --font-title: "Archivo", sans-serif;
  --font-text: "Archivo", sans-serif;
  --font-zh-title: "Archivo", "PingFang SC", "Hiragino Sans GB", "Noto Sans SC", "Noto Sans CJK SC", "Source Han Sans SC", "Microsoft YaHei", sans-serif;
  --font-zh-text: "Archivo", "PingFang SC", "Hiragino Sans GB", "Noto Sans SC", "Noto Sans CJK SC", "Source Han Sans SC", "Microsoft YaHei", sans-serif;
}
.display-1-semibold { font-family: var(--font-title); font-size: 72px; line-height: 1.1; font-weight: 600; }
.display-2-semibold { font-family: var(--font-title); font-size: 56px; line-height: 1.12; font-weight: 600; }
.heading-h1-semibold { font-family: var(--font-title); font-size: 48px; line-height: 1.16; font-weight: 600; }
.heading-h2-semibold { font-family: var(--font-title); font-size: 40px; line-height: 1.2; font-weight: 600; }
.heading-h3-medium { font-family: var(--font-title); font-size: 32px; line-height: 1.25; font-weight: 500; }
.heading-h3-semibold { font-family: var(--font-title); font-size: 32px; line-height: 1.25; font-weight: 600; }
.heading-h4-medium { font-family: var(--font-title); font-size: 24px; line-height: 1.3; font-weight: 500; }
.heading-h5-medium { font-family: var(--font-title); font-size: 20px; line-height: 1.35; font-weight: 500; }
.heading-h6-medium { font-family: var(--font-title); font-size: 18px; line-height: 1.4; font-weight: 500; }
.body-large-regular { font-family: var(--font-text); font-size: 18px; line-height: 1.5; font-weight: 400; }
.body-large-medium { font-family: var(--font-text); font-size: 18px; line-height: 1.5; font-weight: 500; }
.body-base-regular { font-family: var(--font-text); font-size: 16px; line-height: 1.5; font-weight: 400; }
.body-base-medium { font-family: var(--font-text); font-size: 16px; line-height: 1.5; font-weight: 500; }
.body-small-regular { font-family: var(--font-text); font-size: 14px; line-height: 1.45; font-weight: 400; }
.body-small-medium { font-family: var(--font-text); font-size: 14px; line-height: 1.45; font-weight: 500; }
.caption-base-regular { font-family: var(--font-text); font-size: 12px; line-height: 1.4; font-weight: 400; }
.caption-base-medium { font-family: var(--font-text); font-size: 12px; line-height: 1.4; font-weight: 500; }
.button-base { font-family: var(--font-text); font-size: 16px; line-height: 1.2; font-weight: 600; }
.button-small { font-family: var(--font-text); font-size: 14px; line-height: 1.2; font-weight: 600; }
.label-base { font-family: var(--font-text); font-size: 14px; line-height: 1.2; font-weight: 500; }
.label-large { font-family: var(--font-text); font-size: 16px; line-height: 1.2; font-weight: 500; }
.commerce-price-base { font-family: var(--font-title); font-size: 20px; line-height: 1.2; font-weight: 600; }
.commerce-price-large { font-family: var(--font-title); font-size: 32px; line-height: 1.25; font-weight: 500; }
.zh-display-1 { font-family: var(--font-zh-title); font-size: 64px; line-height: 1.2; font-weight: 600; }
.zh-display-2 { font-family: var(--font-zh-title); font-size: 48px; line-height: 1.25; font-weight: 600; }
.zh-heading-h2 { font-family: var(--font-zh-title); font-size: 34px; line-height: 1.3; font-weight: 600; }
.zh-heading-h3 { font-family: var(--font-zh-title); font-size: 28px; line-height: 1.35; font-weight: 600; }
.zh-heading-h4 { font-family: var(--font-zh-title); font-size: 22px; line-height: 1.4; font-weight: 600; }
.zh-heading-h6 { font-family: var(--font-zh-title); font-size: 16px; line-height: 1.5; font-weight: 600; }
.zh-body-large { font-family: var(--font-zh-text); font-size: 18px; line-height: 1.75; font-weight: 400; }
.zh-body-base { font-family: var(--font-zh-text); font-size: 16px; line-height: 1.75; font-weight: 400; }
.zh-body-small { font-family: var(--font-zh-text); font-size: 14px; line-height: 1.7; font-weight: 400; }
.zh-caption { font-family: var(--font-zh-text); font-size: 12px; line-height: 1.6; font-weight: 400; }
.zh-button { font-family: var(--font-zh-text); font-size: 16px; line-height: 1.2; font-weight: 600; }
.zh-label { font-family: var(--font-zh-text); font-size: 14px; line-height: 1.2; font-weight: 500; }
```

---

## 48-Variable Semantic Bridge (`tokens/semantic-bridge.css`)

```css
/* 15_Atunus_Home - Canonical 48-Variable Semantic Bridge (Stage R9 Contract v3.0.0) */
/* Maps locked brand primitives onto the 4 Cross-Brand Design Fusion & AI Replication axes. */
:root {
  /* Axis 1: Space, Canvas & Color Proportion (25 vars) */
  --ds-sem-bg-canvas: #FAFAF9;
  --ds-sem-bg-surface: #FFFFFF;
  --ds-sem-bg-elevated: #FFFFFF;
  --ds-sem-bg-band: #F3F3F0;
  --ds-sem-bg-footer: #292D23;
  --ds-sem-ink-primary: #2A2926;
  --ds-sem-ink-secondary: #56534F;
  --ds-sem-ink-muted: #696765;
  --ds-sem-ink-on-footer: #FAFAF9;
  --ds-sem-border-hairline: #E8E7E2;
  --ds-sem-border-strong: #98958F;
  --ds-sem-action-primary-bg: #707461;
  --ds-sem-action-primary-fg: #FAFAF9;
  --ds-sem-action-secondary-bg: #EEEFE6;
  --ds-sem-action-secondary-fg: #565A49;
  --ds-sem-accent-brand: #707461;
  --ds-sem-status-offer: #A85A3D;
  --ds-sem-status-error: #B94A3E;
  --ds-sem-announcement-bg: #292D23;
  --ds-sem-announcement-fg: #FAFAF9;
  --ds-sem-section-pad-y: 60px;
  --ds-sem-section-pad-x: 40px;
  --ds-sem-container-max: 1360px;
  --ds-sem-grid-gutter: 24px;
  --ds-sem-whitespace-ratio: 0.66;

  /* Axis 2: Typography & Editorial Scale (18 vars) */
  --ds-sem-font-display: "Archivo", "Helvetica Neue", Arial, sans-serif;
  --ds-sem-font-sans: "Archivo", "Helvetica Neue", Arial, sans-serif;
  --ds-sem-font-mono: "JetBrains Mono", "DM Mono", ui-monospace, SFMono-Regular, Menlo, Consolas, "Noto Sans SC", "PingFang SC", "Microsoft YaHei", sans-serif;
  --ds-sem-font-cjk: "Archivo", "PingFang SC", "Noto Sans SC", "Source Han Sans SC", sans-serif;
  --ds-sem-display-size-desktop: 72px;
  --ds-sem-display-size-mobile: 36px;
  --ds-sem-h2-size: 40px;
  --ds-sem-pdp-title-size: 24px;
  --ds-sem-body-size: 16px;
  --ds-sem-kicker-size: 14px;
  --ds-sem-heading-weight: 600;
  --ds-sem-body-weight: 400;
  --ds-sem-cta-weight: 600;
  --ds-sem-heading-tracking: -0.01em;
  --ds-sem-cta-tracking: 0.02em;
  --ds-sem-heading-transform: none;
  --ds-sem-cta-transform: none;
  --ds-sem-measure-prose: 65ch;

  /* Axis 3: Corner Geometry & Control Elevation (7 vars) */
  --ds-sem-radius-btn: 8px;
  --ds-sem-radius-card: 12px;
  --ds-sem-radius-input: 8px;
  --ds-sem-btn-height: 48px;
  --ds-sem-header-height: 72px;
  --ds-sem-card-shadow: 0 4px 10px rgba(0, 0, 0, 0.02), 0 4px 5px rgba(0, 0, 0, 0.02);
  --ds-sem-focus-ring: 0 0 0 2px #FAFAF9, 0 0 0 4px #3D4134;
}

/* === BEGIN DS-V4 PERCEPTUAL OKLCH, APCA, WOFF2 & MOTION PHYSICS === */
:root {
  /* Perceptual OKLCH Coordinates (Atunus Home · Schema v4.0.0) */
  --ds-oklch-canvas: oklch(0.9848 0.0013 106.42);
  --ds-oklch-surface: oklch(1.0000 0.0000 0.00);
  --ds-oklch-subtle: oklch(0.9633 0.0040 106.47);
  --ds-oklch-ink: oklch(0.2809 0.0056 91.57);
  --ds-oklch-ink-secondary: oklch(0.4438 0.0075 75.34);
  --ds-oklch-border: oklch(0.9251 0.0071 88.65);
  --ds-oklch-cta-bg: oklch(0.5499 0.0289 117.02);
  --ds-oklch-cta-ink: oklch(1.0000 0.0000 0.00);
  --ds-oklch-accent: oklch(0.5499 0.0289 117.02);
  --ds-oklch-footer-bg: oklch(0.2897 0.0185 125.29);
  --ds-oklch-footer-ink: oklch(1.0000 0.0000 0.00);

  /* APCA-W3 (0.0.98G-4g) Perceptual Contrast Readouts */
  --ds-apca-body-on-canvas-lc: 98.32;
  --ds-apca-body-on-surface-lc: 101.36;
  --ds-apca-cta-label-lc: -78.86;
  --ds-apca-footer-label-lc: -103.74;

  /* WOFF2 Binary OS/2 Optical x-height Calibration */
  --ds-font-display-x-ratio: 0.5260;
  --ds-font-sans-x-ratio: 0.5260;
  --ds-font-mono-x-ratio: 0.5500;
  --ds-font-size-adjust-display: ex-height 0.5260;
  --ds-font-size-adjust-sans: ex-height 0.5260;

  /* Physical Motion & Photographic Optical Tokens */
  --ds-motion-ease-primary: cubic-bezier(0.25, 1, 0.5, 1);
  --ds-motion-ease-drawer: cubic-bezier(0.22, 1, 0.36, 1);
  --ds-motion-ease-exit: cubic-bezier(0.4, 0, 1, 1);
  --ds-motion-dur-micro: 160ms;
  --ds-motion-dur-drawer: 320ms;
  --ds-motion-dur-reveal: 500ms;
  --ds-optics-kelvin-daylight: 6500K;
  --ds-optics-kelvin-gallery: 4000K;
  --ds-optics-kelvin-evening: 2700K;
  --ds-optics-archetype: "residential_afternoon_window_light";
}
@media (prefers-reduced-motion: reduce) {
  :root {
    --ds-motion-dur-micro: 0ms;
    --ds-motion-dur-drawer: 100ms;
    --ds-motion-dur-reveal: 120ms;
  }
}
/* === END DS-V4 PERCEPTUAL OKLCH, APCA, WOFF2 & MOTION PHYSICS === */
```

---

## Bundled Reference: `docs/01-brand-core.md`

# 01 品牌核心

Atunus Home 是以设计为导向的家具品牌，帮顾客把空间构想变成完整、协调的家或项目空间。下面是对内对外都要守住的核心说法，文案、设计和页面都从这里出发。

## 品牌一页

| 项 | 内容 |
|---|---|
| 品牌主张（口号） | **From concept to home, all in Atunus.** · **从构想到家，尽在 Atunus。** |
| 品牌叙事 | From single pieces to complete spaces. · 从单品到完整空间。 |
| 品牌精髓 | Everything your space needs, from concept to home. · 空间所需的一切，从构想到家。 |
| 品牌承诺 | 通过相互搭配的家具、房间搭配和项目方案，帮顾客把设计构想变成完整、宜居的空间。 |
| 六大支柱 | 从构想到家 · 完整空间思维 · 整体协调 · 简化决策 · 家居与项目兼顾 · 从灵感到行动 |
| 价值观 | 完整空间思维 · 整体协调 · 实用的优雅 · 简单 · 家居与项目兼顾 · 信任 |
| 语气 | 清楚、懂设计 · 专业但亲切 · 自信、乐于帮忙 · 实用又有向往 · 以解决问题为导向 |
| 目标客户 | 屋主 · 年轻职场人 · 重视设计的买家 · 小企业主与项目采购方 · 想要整体方案、不想独自把想法落成空间的顾客；美国华语顾客用中文服务 |
| 不做 | Trade 会员、行业折扣、批量价、账期；任何未确认的服务和政策承诺（ATH-CORE-06） |

## 愿景、使命与定位

| 项 | English | 中文 |
|---|---|---|
| 愿景 Vision | To become a trusted design-led furniture brand that helps customers turn space concepts into complete, cohesive homes and project environments. | 成为值得信赖、以设计为导向的家具品牌，帮顾客把空间构想变成完整、协调的家和项目空间。 |
| 使命 Mission | To make the furnishing journey easier and more complete by connecting inspiration, room concepts, individual products, coordinated sets, and project-ready solutions into one clearer path from idea to finished space. | 把灵感、房间搭配、单品、整套家具和项目方案连成一条从想法到完成空间的清楚路径，让布置空间更轻松、更完整。 |
| 定位 Positioning | Atunus is positioned as a design-led furniture brand that supports the full journey from space concept to home realization. Unlike brands that only present isolated furniture pieces, Atunus connects inspiration, coordinated sets, room concepts, product discovery, and consultation-driven solutions to help customers create a more cohesive and finished space. | Atunus 是以设计为导向的家具品牌，支持从空间构想到家落成的完整过程。和只展示单件家具的品牌不同，Atunus 把灵感、整套家具、房间搭配、选品和设计咨询连在一起，帮顾客做出更协调、更完整的空间。 |
| 定位语句 Positioning statement | For customers who want to move from inspiration to a complete home or project space, Atunus delivers design-led furniture, coordinated sets, room concepts, and project-ready solutions that make the journey from concept to home easier and more cohesive. | 对想从灵感走到一个完整的家或项目空间的顾客，Atunus 提供以设计为导向的家具、整套家具、房间搭配和项目方案，让从构想到家的过程更轻松、更协调。 |

定位和定位语句用来统一内部判断，不整句写给顾客；对外用口号、叙事和支柱。

## 价值观

| 价值观 | 在工作里意味着 |
|---|---|
| 完整空间思维 Complete Space Thinking | 先看整个空间，再选每一件 |
| 整体协调 Cohesive Design | 件与件的比例、材质、颜色相配，风格统一 |
| 实用的优雅 Practical Elegance | 好看，也好用、好清洁、放得下 |
| 简单 Simplicity | 选择少而清楚，流程短，说法直接 |
| 家居与项目兼顾 Home + Project Capability | 家和项目空间都能接，项目需求走设计咨询 |
| 信任 Trust | 尺寸、材质、交期、政策说实话，承诺的都做得到 |

## 六大支柱

一个页面区块只讲一个支柱。支柱文案要落到顾客能买或能预约的东西上；证据补齐前不写数字。

### 1 从构想到家 Concept-to-Home Journey

- 是什么：顾客从灵感或房间想法出发，经由单品、整套家具和设计咨询，走到完整、宜居的空间。
- English：From concept to home, Atunus helps bring every part of your space together.
- 中文：从构想到家，Atunus 帮您把空间里的每一部分配到一起。
- 落在：首页首屏、关于我们、品牌广告。

### 2 完整空间思维 Complete Space Thinking

- 是什么：不只看单件，按整个空间的结果来做决定。
- English：Move beyond single-item shopping and discover a more complete way to furnish.
- 中文：不再一件一件挑，用更完整的方式布置空间。
- 落在：列表页导语、ShopTheLook、套装商品页。

### 3 整体协调 Cohesive Design

- 是什么：整套家具、房间搭配和统一的视觉，让空间更和谐、更完整。
- English：Turn your room idea into a complete, cohesive space with furniture designed to work together.
- 中文：把您对房间的想法变成一个完整、协调的空间，每一件家具都为相互搭配而设计。
- 落在：SetCard、套装商品页（BundleItem 逐件标价）、ShopTheLook。
- 待补证据：在售套装数量、每套包含的件。

### 4 简化决策 Simplified Decision-Making

- 是什么：顾客不用自己去配风格、选组合、凭空想象最后的样子。
- English：Not sure what goes together? Start with a room concept or a set planned as one room.
- 中文：不知道怎么搭？从一套房间搭配，或按一个房间设计的套装开始。
- 落在：ShopTheLook、加购后的搭配推荐、HelpFAQ。

### 5 家居与项目兼顾 Home + Project Capability

- 是什么：日常的家和项目空间都能做，靠单品、整套家具、房间搭配和设计咨询。
- English：Furnishing a home or a project space? Book a consultation and we’ll plan the pieces with you.
- 中文：不管是自己的家还是项目空间，预约设计咨询，我们和您一起规划。
- 落在：设计咨询页、CTABanner、HelpFAQ。项目需求一律走设计咨询，不设单独入口和 Trade 价格。
- 待补证据：房间方案交付时间。

### 6 从灵感到行动 From Inspiration to Action

- 是什么：社媒内容、房间灵感、选品、设计咨询和购买连成一条清楚的路。
- English：From room concepts to project-ready solutions, Atunus helps turn furniture choices into finished spaces.
- 中文：从房间搭配到项目方案，Atunus 帮您把家具选择变成完成的空间。
- 落在：社媒、邮件、内容文章。每条内容都链接到对应的套装页、商品页或设计咨询页。

## 我们提供什么

| 提供 | English | 中文 | 规则 |
|---|---|---|---|
| 单品 | Individual pieces | 单品 | — |
| 整套家具 | Coordinated sets, planned as one room | 整套家具，按一个房间来搭 | ATH-PX-01 |
| 房间搭配 | Room concepts you can shop as a whole | 可以整间选购的房间搭配 | — |
| 设计咨询与房间方案 | Free design consultation; room plan $199 per room, credited toward your order | 免费设计咨询；房间方案每个房间 $199，下单抵扣 | ATH-PX-04 |
| 定制家具 | Custom pieces, quoted once the details are set | 定制家具，细节确认后报价 | ATH-PX-05 |
| 项目方案 | Project-ready solutions, planned through a consultation | 项目方案，通过设计咨询规划 | ATH-CORE-06 |

## 目标客户

| 客户 | 情况 | 要什么 | 先给什么 |
|---|---|---|---|
| 屋主 | 新买房、搬家或翻新，要布置一个或几个房间 | 一次配齐，配得协调 | 整套家具、房间搭配、设计咨询 |
| 年轻职场人 | 第一次自己布置，或换了新住处 | 好看又实用，不想花太多时间挑 | 房间搭配、单品、整套家具 |
| 重视设计的买家 | 在意整体风格，不打算请全程室内设计师 | 确定搭得对，看起来完整 | 整套家具、设计咨询与房间方案 |
| 小企业主与项目采购方 | 要布置一个项目空间 | 按时间配齐，风格统一 | 设计咨询、项目方案 |
| 想要整体方案的顾客 | 有想法，但不想独自把想法落成空间 | 有人帮忙把想法变成完整的空间 | 设计咨询、房间搭配 |

美国华语顾客（简体为主）分布在各类里：一对一咨询、方案报价、小红书和微信内容、中文广告、关键落地页用中文（见 03 中文）。

## 顾客要完成的事

| 顾客想 | 我们给 | English | 中文 |
|---|---|---|---|
| 有灵感，还没方案 | 房间搭配 | Start with a room concept and shop the whole look. | 从一套房间搭配开始，整间一起选。 |
| 一次配齐，省时间 | 整套家具 | Start with a set planned as one room. | 从按一个房间设计的套装开始。 |
| 确定搭得对 | 设计咨询与房间方案 | Not sure what goes together? Ask our design team. | 不知道怎么搭？问问我们的设计团队。 |
| 尺寸或材质特殊 | 定制家具 | Made to your size and material. | 按您要的尺寸和材质来做。 |
| 布置项目空间 | 设计咨询与项目方案 | Furnishing a project space? Tell us the rooms and your timeline. | 布置项目空间？告诉我们有几个房间、什么时候要。 |

## 语气

说话清楚、温暖、自信。精致，但不过分奢华；帮得上忙，但不空泛；引导顾客从灵感走到完整的空间，而不只描述产品功能。

| 语气 | 是 | 不是 |
|---|---|---|
| 清楚、懂设计 Clear & Design-Led | 具体名词、带单位的数字；用设计的道理讲清为什么这样搭 | 抽象的生活方式描写 |
| 专业但亲切 Professional but Approachable | 像展厅里懂行的设计顾问 | 销售话术、端着的奢华腔 |
| 自信、乐于帮忙 Confident & Helpful | 直接给建议和下一步；交期、缺货、限制直说 | 含糊其辞，用“很快”“马上”回避 |
| 实用又有向往 Practical yet Aspirational | 先讲尺寸、交期、价格，再讲空间完成后的样子 | 只有画面没有信息，或只有参数没有画面 |
| 以解决问题为导向 Solution-Oriented | 从顾客的空间和问题出发，讲怎么配成 | 罗列产品功能 |

## 品牌故事

英文是正式版本，照用；中文版用于中文渠道。

| English | 中文 |
|---|---|
| Atunus was built around a simple belief: a home does not begin with a single product, but with a concept of how a space should look, feel, and function. | Atunus 源于一个简单的信念：一个家不是从一件产品开始的，而是从对空间的构想开始：它该是什么样子，给人什么感觉，怎么用。 |
| Many customers start with an idea: a room they want to refresh, a style they want to create, or a project space they need to complete. But turning that idea into the right furniture choices can be difficult. Buying piece by piece often creates uncertainty: styles may not match, decisions become tiring, and the final space may still feel unfinished. | 很多顾客一开始只有一个想法：想翻新的一个房间，想做出的一种风格，或者一个要完成的项目空间。可要把想法变成合适的家具选择并不容易。一件一件买，常常拿不准：风格可能不搭，决定越做越累，最后的空间还是像没完成。 |
| Atunus offers a more complete way to furnish. By connecting inspiration, room concepts, individual products, coordinated sets, and project-ready solutions, Atunus helps customers move from scattered ideas and product choices to clearer space decisions. | Atunus 提供一种更完整的布置方式。把灵感、房间搭配、单品、整套家具和项目方案连在一起，Atunus 帮顾客从零散的想法和选品，走到更清楚的空间决定。 |
| Whether for a home, a room refresh, or a project-based furnishing need, Atunus focuses on making the process easier, more cohesive, and more visually complete. From concept to home, all in Atunus — the brand helps customers turn ideas into spaces that feel intentional, harmonious, and ready to live in. | 无论是布置一个家、翻新一个房间，还是一个项目的家具需求，Atunus 都让这个过程更轻松、更协调，最后的空间看起来更完整。从构想到家，尽在 Atunus：帮顾客把想法变成经过规划、协调和谐、可以入住的空间。 |

## 信息层级

一个触点讲清一层就够，从上往下用：

1. **品牌主张（口号）**：首页首屏、广告标题、社媒简介。
2. **品牌叙事与承诺**：首页品牌区、关于我们、邮件页脚。
3. **六大支柱**：首页区块、栏目页导语、内容选题；一个区块讲一个。
4. **我们提供什么**：导航、栏目页、落地页。
5. **证据**：真实的套装、尺寸、交期、评价、案例。
6. **行动**：用下面的行动用语。

## 标准介绍

照用，不改写；需要更短就用上一档。

| 长度 | English | 中文 |
|---|---|---|
| 一句 | Atunus Home is a design-led furniture brand that helps you turn a space concept into a complete, cohesive home or project space. | Atunus Home（家具与空间方案）是以设计为导向的家具品牌，帮您把空间构想变成完整、协调的家或项目空间。 |
| 短 | Atunus Home is a design-led furniture brand that takes you from concept to home. We connect room concepts, coordinated sets, single pieces and design consultation in one clear path, so the whole space comes together. Shop by room, buy the whole set or one piece, or plan a home or project space with our design team. | Atunus Home 是以设计为导向的家具品牌，陪您从构想走到家。我们把房间搭配、整套家具、单品和设计咨询连成一条清楚的路，让整个空间配得协调。可以按房间选，买整套或只买一件，也可以请设计团队一起规划您的家或项目空间。 |
| 长 | 短版之后加：Product pages list the size, materials and delivery estimate for every piece, so you can check fit and timing before you order. Our design team works from your floor plan or photos to plan the layout, pieces and fabrics. Custom pieces are quoted once the size, material and timeline are set. We also serve customers in Simplified Chinese. | 短版之后加：商品页写清每一件的尺寸、材质和预计送达时间，下单前就能确认放不放得下、什么时候到。设计团队根据户型图或照片规划布局、家具和面料；定制家具在尺寸、材质和时间确认后单独报价。中文顾客可以通过微信、电话或邮件联系我们。 |

## 行动用语

| 用途 | English | 中文 |
|---|---|---|
| 看套装 | Shop furniture sets | 看整套家具 |
| 看单品 | Shop all products | 看全部单品 |
| 看房间搭配 | Shop the look | 看整间搭配 |
| 照房间搭配规划 | Plan a room like this | 照这个房间规划 |
| 设计服务 | Book a consultation | 预约设计咨询 |
| 项目空间 | Plan a project space | 咨询项目空间 |
| 定制 | Request a custom quote | 申请定制报价 |
| 加购 | Add to cart — $1,598 | 加入购物车 — $1,598 |
| 中文联系 | — | 微信咨询 |

## 名称

- 全称 Atunus Home：Logo、页面标题、正文首次出现、法律文本都用全称。
- 简称 Atunus：用在口号、品牌故事，以及同一页面或同一份物料里全称出现之后。
- 品牌名不翻译、不加中文名；不写 ATUNUS、AtunusHome、Atunus Home Furniture；全大写只由 CSS 实现。
- 中文首次出现写 Atunus Home（家具与空间方案），之后写 Atunus Home 或 Atunus。
- 系列名保留英文。英文写“系列名 + 品类”（Amber Horizon Living Room Set），中文写“系列名 + 中文品类”（Amber Horizon 客厅套装）。

## 规则

| 编号 | 规则 | 挂到的组件 |
|---|---|---|
| ATH-CORE-01 | **品牌主张与定位**：品牌主张（口号）：From concept to home, all in Atunus. / 从构想到家，尽在 Atunus。品牌叙事：From single pieces to complete spaces. / 从单品到完整空间。定位：以设计为导向的家具品牌，支持从空间构想到家落成的完整过程。口号按原样写（句子式、带句号），不改字、不改大小写；定位不整句写给顾客。 | Hero、Footer、AnnouncementBar、PageHome |
| ATH-CORE-02 | **六大支柱**：六个支柱：从构想到家、完整空间思维、整体协调、简化决策、家居与项目兼顾、从灵感到行动。一个区块只讲一个支柱；支柱文案要落到顾客能买或能预约的东西上（单品、整套家具、房间搭配、设计咨询与房间方案、定制家具、项目方案）。证据补齐前不写数字。 | Header、Footer、FeatureList、ShopTheLook、TemplateConsultation、HelpFAQ |
| ATH-CORE-03 | **目标客户**：屋主、年轻职场人、重视设计的买家、小企业主与项目采购方，以及想要整体家具方案、又不想独自把想法落成空间的顾客。美国华语顾客（简体为主）分布在各类里，用中文服务。项目客户走设计咨询。 | TemplateConsultation、Locale |
| ATH-CORE-04 | **顾客要完成的事**：有灵感没方案 → 房间搭配；一次配齐 → 整套家具；确定搭得对 → 设计咨询与房间方案；尺寸或材质特殊 → 定制家具；布置项目空间 → 设计咨询与项目方案。“工厂直供、没有零售加价”“专属顾问、代采购”没有服务或证据支撑，不对外使用。 | ShopTheLook、BundleItem、TemplateConsultation |
| ATH-CORE-05 | **不用促销做定位**：促销是手段，不是品牌是谁。首页首屏、公告栏、页脚不放折扣口号；划线价要有真实参考价（ATH-PX-01），不写“全场最高 X 折”。 | AnnouncementBar、Hero、Price、Badge |
| ATH-CORE-06 | **不承诺未确认的服务**：以下内容在确认前不出现在任何对外文案、组件默认值或模板里：Trade 会员、行业折扣、批量价、账期、白手套送货、代采购、一对一专属顾问、免费设计（免费的是设计咨询）、免运费、分期付款，以及和 05 政策不一致的天数、年限。可以说“项目空间”“项目方案”，项目需求一律引到设计咨询。 | Header、TrustBar、HelpFAQ、OrderSummary、FinancingMessage、AnnouncementBar、PageCart |
| ATH-CORE-07 | **品牌名与简称**：全称 Atunus Home：Logo、页面标题、正文首次出现、法律文本。简称 Atunus：口号、品牌故事，以及同一页面或物料里全称出现之后。不翻译、不加中文名；不写 ATUNUS、AtunusHome、Atunus Home Furniture。中文首次出现写 Atunus Home（家具与空间方案）。系列名保留英文。 | Logo、Header、Footer、ProductCard、CartLine |

## 正反例

| 编号 | English ✓ | English ✗ | 中文 ✓ | 中文 ✗ |
|---|---|---|---|---|
| ATH-CORE-01 | From concept to home, all in Atunus. | Elevate your lifestyle.（没有说清做什么） | 从构想到家，尽在 Atunus。 | 让生活更美好（没有说清做什么） |
| ATH-CORE-02 | Move beyond single-item shopping and discover a more complete way to furnish. | Your one-stop shop for everything home, from sourcing to white-glove delivery. | 不再一件一件挑，用更完整的方式布置空间。 | 一站式全屋采购，专属顾问全程跟进，白手套送货到家。 |
| ATH-CORE-04 | Not sure what goes together? Start with a set planned as one room. | Designer quality without the retail markup. | 不知道怎么搭？从按一个房间设计的套装开始。 | 设计师品质，没有中间商差价。 |
| ATH-CORE-05 | Plan your whole room with our design team | Up to 65% OFF everything! | 整屋怎么配？设计团队帮您规划 | 全场低至 3.5 折！ |
| ATH-CORE-06 | 30-day returns · 5-year frame warranty | Free Shipping · Lifetime Warranty | 30 天退换 · 框架质保 5 年 | 包邮 · 终身质保 |
| ATH-CORE-07 | Atunus Home … From concept to home, all in Atunus. | ATUNUS HOME Furniture Co. / AtunusHome | Atunus Home（家具与空间方案） | 阿图纳斯家居 |

---

## Bundled Reference: `docs/en/01-brand-core.md`

# 01 Brand core

Atunus Home is a design-led furniture brand that helps customers turn a space concept into a complete, cohesive home or project space. These are the core statements we hold to inside and outside the company; copy, design and pages all start here.

## Atunus Home on one page

| Item | Content |
|---|---|
| Brand proposition (slogan) | **From concept to home, all in Atunus.** |
| Strategic narrative | From single pieces to complete spaces. |
| Essence | Everything your space needs, from concept to home. |
| Promise | To help customers turn design ideas into complete, livable spaces through coordinated furniture, room concepts, and project-ready solutions. |
| Six pillars | Concept-to-Home Journey · Complete Space Thinking · Cohesive Design · Simplified Decision-Making · Home + Project Capability · From Inspiration to Action |
| Values | Complete Space Thinking · Cohesive Design · Practical Elegance · Simplicity · Home + Project Capability · Trust |
| Tone | Clear & Design-Led · Professional but Approachable · Confident & Helpful · Practical yet Aspirational · Solution-Oriented |
| Target customers | Homeowners · Young professionals · Design-conscious buyers · Small business owners and project buyers · Customers who want a cohesive solution without turning ideas into a finished space on their own; US Chinese-speaking customers are served in Chinese |
| We don't | Trade programs, trade discounts, bulk pricing or payment terms; any unconfirmed service or policy promise (ATH-CORE-06) |

## Vision, mission and positioning

| Item | English |
|---|---|
| Vision | To become a trusted design-led furniture brand that helps customers turn space concepts into complete, cohesive homes and project environments. |
| Mission | To make the furnishing journey easier and more complete by connecting inspiration, room concepts, individual products, coordinated sets, and project-ready solutions into one clearer path from idea to finished space. |
| Positioning | Atunus is positioned as a design-led furniture brand that supports the full journey from space concept to home realization. Unlike brands that only present isolated furniture pieces, Atunus connects inspiration, coordinated sets, room concepts, product discovery, and consultation-driven solutions to help customers create a more cohesive and finished space. |
| Positioning statement | For customers who want to move from inspiration to a complete home or project space, Atunus delivers design-led furniture, coordinated sets, room concepts, and project-ready solutions that make the journey from concept to home easier and more cohesive. |

The positioning and positioning statement keep internal decisions aligned; they are not quoted to customers. Customers hear the slogan, the narrative and the pillars.

## Values

| Value | What it means at work |
|---|---|
| Complete Space Thinking | See the whole space first, then choose each piece |
| Cohesive Design | Proportions, materials and colors work together; one consistent style |
| Practical Elegance | Good-looking, and easy to live with, clean and fit |
| Simplicity | Few, clear choices; short steps; plain wording |
| Home + Project Capability | Homes and project spaces alike; project needs go through a design consultation |
| Trust | Tell the truth about size, materials, lead times and policies; keep every promise |

## Six pillars

One page block talks about one pillar. Pillar copy lands on something a customer can buy or book; until the proof exists, it carries no numbers.

### 1 Concept-to-Home Journey

- What it is: customers move from inspiration or a room idea, through single pieces, coordinated sets and a design consultation, to a complete, livable space.
- English: From concept to home, Atunus helps bring every part of your space together.
- Where it lives: home hero, About, brand ads.

### 2 Complete Space Thinking

- What it is: decisions are made for the whole space, not one piece at a time.
- English: Move beyond single-item shopping and discover a more complete way to furnish.
- Where it lives: listing-page intros, ShopTheLook, set product pages.

### 3 Cohesive Design

- What it is: coordinated sets, room concepts and a consistent look make the space feel harmonious and complete.
- English: Turn your room idea into a complete, cohesive space with furniture designed to work together.
- Where it lives: SetCard, set product pages (BundleItem prices each piece), ShopTheLook.
- Proof still needed: number of sets on sale; the pieces in each set.

### 4 Simplified Decision-Making

- What it is: customers don't have to match styles, pick combinations or imagine the final result from scratch.
- English: Not sure what goes together? Start with a room concept or a set planned as one room.
- Where it lives: ShopTheLook, pairing suggestions after add-to-cart, HelpFAQ.

### 5 Home + Project Capability

- What it is: everyday homes and project spaces, served through products, sets, room concepts and the design consultation.
- English: Furnishing a home or a project space? Book a consultation and we’ll plan the pieces with you.
- Where it lives: consultation page, CTABanner, HelpFAQ. Project needs always go through the design consultation; no separate entry and no trade pricing.
- Proof still needed: room-plan turnaround.

### 6 From Inspiration to Action

- What it is: social content, room inspiration, product discovery, the consultation and purchase form one clear path.
- English: From room concepts to project-ready solutions, Atunus helps turn furniture choices into finished spaces.
- Where it lives: social, email, articles. Every piece of content links to the matching set page, product page or consultation page.

## What we offer

| Offer | English | Rule |
|---|---|---|
| Single pieces | Individual pieces | — |
| Coordinated sets | Coordinated sets, planned as one room | ATH-PX-01 |
| Room concepts | Room concepts you can shop as a whole | — |
| Design consultation and room plan | Free design consultation; room plan $199 per room, credited toward your order | ATH-PX-04 |
| Custom furniture | Custom pieces, quoted once the details are set | ATH-PX-05 |
| Project solutions | Project-ready solutions, planned through a consultation | ATH-CORE-06 |

## Target customers

| Customer | Situation | What they want | What we lead with |
|---|---|---|---|
| Homeowners | Just bought, moved or renovating; furnishing one room or several | Furnish it all and have it work together | Furniture sets, room concepts, design consultation |
| Young professionals | Furnishing on their own for the first time, or in a new place | Good-looking and practical, without hours of choosing | Room concepts, single pieces, furniture sets |
| Design-conscious buyers | Care about the overall style; not hiring a full-service interior designer | To be sure it goes together and looks finished | Furniture sets, design consultation and room plan |
| Small business owners and project buyers | Furnishing a project space | Furnished on schedule, in one consistent style | Design consultation, project solutions |
| Customers who want a cohesive solution | Have ideas but don't want to turn them into a finished space alone | Someone to help turn the idea into a complete space | Design consultation, room concepts |

US Chinese-speaking customers (mostly Simplified script) are found in every group. 1:1 consultation, proposals and quotes, RedNote and WeChat content, Chinese ads and key landing pages are in Chinese (see 03 Chinese).

## Jobs customers want done

| Customer wants to | We offer | English |
|---|---|---|
| Has inspiration, no plan yet | Room concepts | Start with a room concept and shop the whole look. |
| Furnish it all at once and save time | Furniture sets | Start with a set planned as one room. |
| Be sure it goes together | Design consultation and room plan | Not sure what goes together? Ask our design team. |
| Needs a special size or material | Custom furniture | Made to your size and material. |
| Furnish a project space | Design consultation and project solutions | Furnishing a project space? Tell us the rooms and your timeline. |

## Tone

Speak with clarity, warmth and confidence. Refined, but not overly luxurious; helpful, but not generic; guide customers from inspiration to a complete space rather than only describing product features.

| Tone | Is | Isn't |
|---|---|---|
| Clear & Design-Led | Concrete nouns, numbers with units; explains why pieces go together in design terms | Abstract lifestyle language |
| Professional but Approachable | A knowledgeable design consultant in the showroom | Sales talk, stiff luxury language |
| Confident & Helpful | Gives a recommendation and the next step; states lead times, stock limits and constraints | Vague answers; hiding behind "soon" or "right away" |
| Practical yet Aspirational | Size, lead time and price first, then what the finished space will be like | All mood and no facts, or all specs and no picture |
| Solution-Oriented | Starts from the customer's space and problem and shows how it comes together | A list of product features |

## Brand story

The English version is the official text; use it as written. The Chinese version is for Chinese channels.

> Atunus was built around a simple belief: a home does not begin with a single product, but with a concept of how a space should look, feel, and function.
>
> Many customers start with an idea: a room they want to refresh, a style they want to create, or a project space they need to complete. But turning that idea into the right furniture choices can be difficult. Buying piece by piece often creates uncertainty: styles may not match, decisions become tiring, and the final space may still feel unfinished.
>
> Atunus offers a more complete way to furnish. By connecting inspiration, room concepts, individual products, coordinated sets, and project-ready solutions, Atunus helps customers move from scattered ideas and product choices to clearer space decisions.
>
> Whether for a home, a room refresh, or a project-based furnishing need, Atunus focuses on making the process easier, more cohesive, and more visually complete. From concept to home, all in Atunus — the brand helps customers turn ideas into spaces that feel intentional, harmonious, and ready to live in.

## Message hierarchy

One touchpoint only needs to land one level. Use them top down:

1. **Brand proposition (slogan)**: home hero, ad headlines, social bios.
2. **Narrative and promise**: the brand section on the home page, About, email footers.
3. **Six pillars**: home-page blocks, listing-page intros, content topics; one per block.
4. **What we offer**: navigation, category pages, landing pages.
5. **Proof**: real sets, sizes, lead times, reviews and projects.
6. **Action**: use the calls to action below.

## Standard intro

Use as written; when you need shorter, drop to the level above.

| Length | English |
|---|---|
| One line | Atunus Home is a design-led furniture brand that helps you turn a space concept into a complete, cohesive home or project space. |
| Short | Atunus Home is a design-led furniture brand that takes you from concept to home. We connect room concepts, coordinated sets, single pieces and design consultation in one clear path, so the whole space comes together. Shop by room, buy the whole set or one piece, or plan a home or project space with our design team. |
| Long | Add after the short version: Product pages list the size, materials and delivery estimate for every piece, so you can check fit and timing before you order. Our design team works from your floor plan or photos to plan the layout, pieces and fabrics. Custom pieces are quoted once the size, material and timeline are set. We also serve customers in Simplified Chinese. |

## Calls to action

| Purpose | English |
|---|---|
| Browse sets | Shop furniture sets |
| Browse single pieces | Shop all products |
| Browse room concepts | Shop the look |
| Plan from a room concept | Plan a room like this |
| Design service | Book a consultation |
| Project space | Plan a project space |
| Custom | Request a custom quote |
| Add to cart | Add to cart — $1,598 |
| Contact in Chinese | Chat on WeChat (Chinese support) |

## Names

- Full name Atunus Home: the logo, page titles, the first mention in body copy and legal text.
- Short name Atunus: in the slogan, the brand story, and after the full name has appeared on the same page or piece.
- The name is never translated or given a Chinese name; never ATUNUS, AtunusHome or Atunus Home Furniture; all caps only through CSS.
- In Chinese copy, the first mention pairs Atunus Home with its localized furniture-and-space descriptor (see Chapter 03); after that, Atunus Home or Atunus.
- Series names stay in English. English uses series name + product type (Amber Horizon Living Room Set); Chinese uses the English series name + localized product type (see Chapter 03).

## Rules

| ID | Rule | Components |
|---|---|---|
| ATH-CORE-01 | **Brand proposition and positioning**: Brand proposition (slogan): From concept to home, all in Atunus. Strategic narrative: From single pieces to complete spaces. Positioning: a design-led furniture brand that supports the full journey from space concept to home. The slogan is used exactly as written (sentence case, with the period), never reworded or recased; the positioning is not quoted to customers. | Hero, Footer, AnnouncementBar, PageHome |
| ATH-CORE-02 | **Six pillars**: Six pillars: Concept-to-Home Journey, Complete Space Thinking, Cohesive Design, Simplified Decision-Making, Home + Project Capability, From Inspiration to Action. One block talks about one pillar; pillar copy lands on something the customer can buy or book (single pieces, coordinated sets, room concepts, design consultation and room plans, custom furniture, project solutions). Until the proof exists, copy carries no numbers. | Header, Footer, FeatureList, ShopTheLook, TemplateConsultation, HelpFAQ |
| ATH-CORE-03 | **Target customers**: Homeowners, young professionals, design-conscious buyers, small business owners and project buyers, and customers who want a cohesive furniture solution without turning ideas into a finished space on their own. US Chinese-speaking customers (mostly Simplified script) are found in every group and are served in Chinese. Project customers go through the design consultation. | TemplateConsultation, Locale |
| ATH-CORE-04 | **Jobs customers want done**: Has inspiration but no plan → room concepts; furnish it all at once → coordinated sets; be sure it goes together → design consultation and room plan; special size or material → custom furniture; furnish a project space → design consultation and project solutions. "Factory-direct, no retail markup" and "dedicated specialist, sourcing" have no service or evidence behind them and are not used externally. | ShopTheLook, BundleItem, TemplateConsultation |
| ATH-CORE-05 | **Promotions are not the positioning**: Promotion is a tactic, not who the brand is. No discount slogans in the home hero, announcement bar or footer; a strikethrough price needs a real reference price (ATH-PX-01); no "up to X% off everything". | AnnouncementBar, Hero, Price, Badge |
| ATH-CORE-06 | **Do not promise unconfirmed services**: Until confirmed, none of these appear in any external copy, component default or template: trade programs, trade discounts, bulk pricing, payment terms, white-glove delivery, sourcing, a dedicated 1:1 specialist, free design (the design consultation is the free part), free shipping, financing, or any day count or warranty term that differs from the policies in 05. "Project space" and "project solutions" are fine; every project need is routed to the design consultation. | Header, TrustBar, HelpFAQ, OrderSummary, FinancingMessage, AnnouncementBar, PageCart |
| ATH-CORE-07 | **Brand name and short name**: Full name Atunus Home: the logo, page titles, the first mention in body copy, legal text. Short name Atunus: the slogan, the brand story, and after the full name has appeared on the same page or piece. Never translated or given a Chinese name; never ATUNUS, AtunusHome or Atunus Home Furniture. In Chinese, the first mention includes the approved parenthetical descriptor from Chapter 03. Series names stay in English. | Logo, Header, Footer, ProductCard, CartLine |

## Examples

| ID | English ✓ | English ✗ |
|---|---|---|
| ATH-CORE-01 | From concept to home, all in Atunus. | Elevate your lifestyle. (says nothing about what we do) |
| ATH-CORE-02 | Move beyond single-item shopping and discover a more complete way to furnish. | Your one-stop shop for everything home, from sourcing to white-glove delivery. |
| ATH-CORE-04 | Not sure what goes together? Start with a set planned as one room. | Designer quality without the retail markup. |
| ATH-CORE-05 | Plan your whole room with our design team | Up to 65% OFF everything! |
| ATH-CORE-06 | 30-day returns · 5-year frame warranty | Free Shipping · Lifetime Warranty |
| ATH-CORE-07 | Atunus Home … From concept to home, all in Atunus. | ATUNUS HOME Furniture Co. / AtunusHome |

---

## Bundled Reference: `docs/02-language-en.md`

# 02 英文

英文写给美国顾客：美式拼写、AP 风格；语气清楚、懂设计，专业但亲切，自信、乐于帮忙。

## 规则

| 编号 | 规则 | 挂到的组件 |
|---|---|---|
| ATH-EN-01 | **美式英语与 AP 风格**：美式拼写；风格手册用 AP：不用 serial comma；数字一到九拼写，10 以上用数字，价格、尺寸、日期一律用数字。 | 全部组件 |
| ATH-EN-02 | **Voice：Clear & Design-Led · Professional but Approachable · Confident & Helpful · Practical yet Aspirational · Solution-Oriented**：说话清楚、温暖、自信；精致但不过分奢华，帮得上忙但不空泛；引导顾客从灵感走到完整的空间，而不只描述产品功能。交期、缺货、限制直接说。 | Hero、SectionHeader、HelpFAQ、EmptyState |
| ATH-EN-03 | **大小写**：区块标题用 AP 标题式大小写（Designed to Work Together）；按钮、标签、表单、提示用句子式（Add to cart）；大写只由 CSS 实现，源文案不打全大写。 | SectionHeader、Button、Badge、TextField |
| ATH-EN-04 | **格式**：价格 $1,598（商品页去掉 .00，购物车与结算保留两位小数）；日期 Oct 25 / Oct 25, 2026；时间 9:00 a.m. ET；尺寸 90″ W × 35″ D × 30″ H，可附厘米；范围用短横 3–7 days。 | Price、DeliveryEstimate、DeliveryTimeline、CartLine、OrderSummary |
| ATH-EN-05 | **错误与空状态**：说清楚发生了什么，再说下一步。不怪顾客，不用 Oops。 | PromoCode、TextField、EmptyState、FileUpload、CartLine |
| ATH-EN-06 | **禁用词**：见 02 英文「禁用词」表：无法核验的最高级、空洞形容词、未确认的服务与政策承诺、环保与产地主张。 | 全部组件 |

## Voice

| 语气 | 是 | 不是 | 例句 |
|---|---|---|---|
| Clear & Design-Led | 具体名词、带单位的数字；用设计的道理讲清为什么这样搭 | 抽象的生活方式描写 | The sofa is 90″ wide, so the coffee table sits 18″ in front of it. |
| Professional but Approachable | 像展厅里懂行的设计顾问 | 销售话术、端着的奢华腔 | Not sure about the size? Ask our design team. |
| Confident & Helpful | 直接给建议和下一步；交期、缺货、限制直说 | 用“soon”“fast”回避 | The coffee table ships Oct 25, after the sofa. |
| Practical yet Aspirational | 先讲尺寸、交期、价格，再讲空间完成后的样子 | 只有画面没有信息，或只有参数没有画面 | Turn your room idea into a complete, cohesive space with furniture designed to work together. |
| Solution-Oriented | 从顾客的空间和问题出发，讲怎么配成 | 罗列产品功能 | Send a floor plan and we’ll suggest a layout. |

分寸：精致但不过分奢华；口语但不用俚语；以严肃为主，社媒可以轻松；热情来自具体帮助，不来自形容词。

## 品牌例句

照用，或按同样的意思写：

- From concept to home, Atunus helps bring every part of your space together.
- Turn your room idea into a complete, cohesive space with furniture designed to work together.
- Move beyond single-item shopping and discover a more complete way to furnish.
- From room concepts to project-ready solutions, Atunus helps turn furniture choices into finished spaces.

## 关键词

Concept to home · Complete spaces · Design-led furniture · Coordinated sets · Room concepts · Project-ready · Cohesive style · Space planning · Effortless furnishing · Practical elegance · Finished look · Home and project spaces

关键词用来选题和写标题，一段里不堆砌。

## Tone 矩阵

| 场景 | 英文怎么调 | 例句 |
|---|---|---|
| 营销内容（首页、广告、邮件） | 具体的房间和结果，少形容词 | From concept to home, all in Atunus. |
| 交易与物流 | 先给事实：件数、日期、金额 | Arrives in 2 deliveries: sofa Sep 2, tables Oct 25. |
| 客服与投诉 | 先认事实，再给下一步和时间 | Your coffee table is delayed to Nov 8. We’ll email you when it ships. |
| 法律与合规 | 准确完整，不做营销修饰 | Message and data rates may apply. Reply STOP to opt out. |
| 社媒互动（英文 IG / Pinterest；中文小红书 / 微信） | 轻松一点，但不用夸张和表情堆叠 | This room started as a floor plan and two photos. |

## 格式速查

| 项 | 写法 |
|---|---|
| 价格 | $1,598（商品页）；$1,598.00（购物车、结算） |
| 日期 | Oct 25；Oct 25, 2026；不写 10/25/26 |
| 时间 | 9:00 a.m. ET（AP） |
| 尺寸 | 90″ W × 35″ D × 30″ H；可附 229 × 89 × 76 cm |
| 范围 | 3–7 days（短横，不用连字符） |
| 大小写 | 区块标题 AP 标题式；按钮和标签句子式；全大写只用 CSS |
| 名称 | Atunus Home；系列名 + 品类：Amber Horizon Living Room Set |

## 禁用词

| 词或句式 | 原因 | 规则 |
|---|---|---|
| best, #1, leading, unparalleled, best-in-class | 无法核验的最高级 | — |
| elevate, seamless, timeless, curated (堆用), bespoke, luxurious | 空洞形容词；bespoke 易被理解为全定制 | — |
| free shipping, free design, free swatches | 只有设计咨询免费 | ATH-CORE-06 |
| lifetime warranty, no-questions-asked returns | 和政策不一致 | ATH-PX-03 |
| white-glove, dedicated specialist, sourcing service | 服务未确认 | ATH-CORE-06 |
| trade pricing, trade discount, bulk pricing, B2B | 项目需求走设计咨询；不设 Trade 价格 | ATH-CORE-06 |
| factory-direct, no middleman, without retail markups | 需要成本与比价证据 | ATH-CORE-04 |
| eco-friendly, sustainable, non-toxic, green | 环保主张需证据 | — |
| Made in USA, Italian leather（未核实） | 产地与材料主张需证据 | — |
| Up to 65% OFF, Was $X（无依据） | 参考价与“最高折扣” | — |
| Oops!, Hurry!, !!! | 语气不符 | ATH-EN-02 |

## 正反例（规则）

| 编号 | English ✓ | English ✗ | 中文 ✓ | 中文 ✗ |
|---|---|---|---|---|
| ATH-EN-01 | Sofas, chairs and tables | Sofas, chairs, and tables · colour · catalogue | — | — |
| ATH-EN-02 | Turn your room idea into a complete, cohesive space with furniture designed to work together. | Experience unparalleled luxury that elevates your lifestyle. | — | — |
| ATH-EN-03 | Add to cart | ADD TO CART（文案里打全大写） | — | — |
| ATH-EN-04 | Ships in 3–7 days · $1,598 | Ships in 3-7 Days · USD 1598.00 | — | — |
| ATH-EN-05 | This code isn’t valid. Check the spelling or try another code. | Oops! Invalid input. | — | — |
| ATH-EN-06 | Solid walnut top | Luxurious, eco-friendly, best-in-class walnut | — | — |

## 示例库（按触点）

| 触点 | ✓ | ✗ | 规则 |
|---|---|---|---|
| 首页首屏 | From concept to home, all in Atunus. | Elevate your lifestyle. | ATH-CORE-01 |
| 项目咨询 | Furnishing a project space? Book a consultation and tell us the rooms and your timeline. | Trade pricing available. Apply now! | ATH-CORE-06 |
| 公告栏 | Plan your whole room with our design team | Free interior design with every order | ATH-PX-04 |
| 商品名 | Terra Coffee Table, Travertine | TERRA LUXURY TRAVERTINE COFFEE TABLE | ATH-ZH-03 |
| 交期 | Pre-order · ships Oct 25 (60 days) | Ships soon! | ATH-PX-02 |
| 加购按钮 | Add 2 sets to cart — $3,196 | BUY NOW!!! | ATH-ZH-07 |
| 政策 | 30-day returns | Free returns, no questions asked | ATH-PX-03 |
| 优惠码报错 | This code isn’t valid. Check the spelling or try another code. | Oops! Invalid code. | ATH-EN-05 |
| 购物车运费 | Calculated at checkout | Free | ATH-PX-07 |
| 空购物车 | Saved items stay in your wishlist. Need help choosing? A designer can plan the room with you. | Your cart is sad and empty :( | ATH-EN-02 |
| 评价 | （原文显示） | （机翻后显示） | ATH-ZH-09 |

---

## Bundled Reference: `docs/03-language-zh.md`

# 03 中文

中文写给住在美国、习惯读简体中文的华语顾客。它和英文各自按读者习惯写，不是英文的翻译：联系方式、称呼、日期写法、美国房产用语的处理都不同。

## 用在哪里

用：一对一咨询（微信、电话、展厅）、方案与报价、小红书和微信内容、中文广告、关键落地页（设计咨询、套装商品页、购物车说明）。
不用：全站中文。繁体只在渠道需要时从简体转换，再由人工复核用词。

## 规则

| 编号 | 规则 | 挂到的组件 |
|---|---|---|
| ATH-ZH-01 | **受众与字形**：中文 = 美国华语顾客，简体为主（zh-Hans-US）。不做全站中文；用在一对一咨询（微信、电话、展厅）、方案与报价、小红书/微信内容、中文广告和关键落地页。繁体只在渠道需要时由简体转换，再由人工复核。 | Locale、TemplatePDP、TemplateCart、TemplateConsultation |
| ATH-ZH-02 | **称呼与语气**：交易、服务、法律文本用“您”；小红书和社媒互动可用“你”。语气：实在、周到、懂行；不用“亲”“宝子”“家人们”，不堆感叹号。 | CartLine、PromoCode、EmptyState、Alert、TemplateConsultation |
| ATH-ZH-03 | **名称写法**：品牌名、系列名保留英文，品类写中文：Amber Horizon 客厅套装、Terra 茶几（洞石）。材质第一次出现可中英并列。 | ProductCard、BundleItem、CartLine、AddedToCart、Gallery |
| ATH-ZH-04 | **中文排版**：中文与英文、数字之间加半角空格（日期、时间除外：10月25日、上午9:00）；用全角标点（，。：；（）“”），数字范围用短横 3–7；不用斜体、全大写和字距；正文行高 1.7–1.75。 | 全部组件、tokens: zh-* |
| ATH-ZH-05 | **格式**：价格写 $1,598，不写“美元”“刀”；日期 10月25日、2026年10月25日；时间 上午9:00（美东时间）；尺寸 90 英寸（229 厘米）；电话保留美国格式 (626) 555-0142；邮编写“邮编（ZIP）”。 | Price、DeliveryEstimate、DeliveryTimeline、OrderSummary、TextField |
| ATH-ZH-06 | **术语表**：按 03 中文「术语表」统一：购物车、去结算、优惠码、收藏、面料小样、预售、下单后生产、预估税费等。美国房产与尺寸用语保留英文括注（Townhouse、Queen）。 | 全部组件 |
| ATH-ZH-07 | **按钮与标签**：动词在前、短；数量和金额放在括号或破折号后：加入购物车（2 套）— $3,196。不用“点击这里”。 | Button、ShopTheLook、OrderSummary、AddedToCart |
| ATH-ZH-08 | **中文禁用词**：极限词（最、第一、顶级、国际大牌）、无证据的环保与健康主张（零甲醛、环保无味）、未确认的服务（包邮、白手套、专属顾问、批发价）、网络流行语。 | 全部组件 |
| ATH-ZH-09 | **中文合规**：中文广告里的必要披露也用中文（16 CFR 14.9）；用中文洽谈的合同、报价、分期等，是否需要提供中文译本由法务按加州民法 §1632 判断，确认前不用中文签约；顾客评价按原文显示，不翻译。 | ReviewsSummary、TemplateConsultation、FinancingMessage、OrderSummary |
| ATH-ZH-10 | **渠道与联系方式**：中文触点优先给华语顾客常用的联系方式：微信、电话、邮箱（微信在前）；默认沟通语言为中文。英文触点用邮箱、电话、短信，短信需单独同意。 | HelpFAQ、TemplateConsultation |

## Tone 矩阵

| 场景 | 中文怎么调 | 例句 |
|---|---|---|
| 营销内容（首页、广告、邮件） | 说清能帮顾客做成什么；除品牌口号外不另造口号，不用极限词 | 从构想到家，尽在 Atunus。 |
| 交易与物流 | 日期金额前置，用“您” | 分 2 次送到：沙发 9月2日，茶几和边几 10月25日。 |
| 客服与投诉 | 先说明情况，再说怎么办；不说“非常抱歉给您带来不便”这类套话 | 您的茶几推迟到 11月8日发货。发货后我们会发邮件通知您。 |
| 法律与合规 | 与英文原文等义，法务复核；不添加营销语气 | 可能产生短信和流量费用。回复 STOP 退订。 |
| 社媒互动（英文 IG / Pinterest；中文小红书 / 微信） | 可用“你”，口语化；数字和服务说法照样核实 | 这间客厅，最开始只是一张户型图和两张照片。 |

## 排版与格式速查

| 项 | 写法 | 不写 |
|---|---|---|
| 中英、中数之间 | 加半角空格：Amber 沙发、3–7 天 | Amber沙发、3–7天 |
| 日期 | 10月25日；2026年10月25日 | 10/25、2026-10-25 |
| 时间 | 上午9:00（美东时间） | 9am EST |
| 价格 | $1,598；省 $320 | 1598 美元、1598 刀 |
| 尺寸 | 90 英寸（229 厘米）；表头写单位，数值可用 90″ | 90寸 |
| 标点 | 全角：，。：；（）“”；书名号用于政策名 | 半角逗号句号 |
| 范围 | 3–7（短横） | 3~7、3-7 |
| 强调 | 加粗 | 斜体、全大写、字距 |
| 电话 | (626) 555-0142 | 626-5550142 |

## 术语表

| English | 中文 | 说明 |
|---|---|---|
| Furniture Sets | 整套家具 | 导航与栏目 |
| Set | 套装 | 商品名：Amber Horizon 客厅套装 |
| Products / single piece | 单品 |  |
| Design Service | 设计服务 / 整屋设计 | 首次出现写“整屋设计服务” |
| Custom Furniture | 定制家具 |  |
| Consultation | 设计咨询 | 预约设计咨询 |
| Room concept | 房间搭配 | 可以整间选购的搭配 |
| Room plan | 房间方案 | 设计团队按户型出的方案，见 05 |
| Project space / project-ready solution | 项目空间 / 项目方案 | 不写“工程” |
| From concept to home | 从构想到家 | 口号用语 |
| Design-led | 以设计为导向 |  |
| Cart | 购物车 |  |
| Checkout | 去结算（按钮）/ 结算 |  |
| Subtotal | 小计 |  |
| Estimated tax | 预估税费 | 提示“以结算页为准” |
| Shipping | 运费 / 配送 | 金额行写“运费” |
| Promo code | 优惠码 | 不用“折扣码”“优惠券”混用 |
| Wishlist | 收藏 | 不用“心愿单” |
| Save for later | 移到收藏 |  |
| Swatch | 面料小样 |  |
| Pre-order | 预售 |  |
| Made to order | 下单后生产 |  |
| Ships in 3–7 days | 3–7 天内发货 |  |
| Sold out | 已售罄 |  |
| Notify me | 到货通知我 |  |
| Seater | 人位 | 2–3 人位 |
| Sectional | 转角沙发 |  |
| Chaise | 贵妃位 |  |
| Ottoman | 脚凳 |  |
| Boucle | 圈圈绒 | 首次可写“圈圈绒（Boucle）” |
| Velvet | 丝绒 |  |
| Travertine | 洞石 |  |
| Floor plan | 户型图 |  |
| ZIP code | 邮编（ZIP） |  |
| Townhouse / Condo | 联排别墅（Townhouse）/ 公寓（Condo） | 保留英文括注 |
| Queen / King | Queen / King 尺寸 | 床垫尺寸不翻译 |
| Verified buyer | 已验证买家 |  |
| Return & Refund Policy | 《退换与退款政策》 | 政策名用书名号 |

## 禁用词

| 词或句式 | 原因 | 规则 |
|---|---|---|
| 最、第一、顶级、全网最低、国际大牌 | 极限词，无法核验 | — |
| 亲、宝子、家人们、绝绝子、yyds | 网络用语，不符合“您”的语气 | ATH-ZH-02 |
| 包邮、免费设计、免费小样 | 只有设计咨询免费 | ATH-CORE-06 |
| 无理由退货、终身质保 | 和政策不一致 | ATH-PX-03 |
| 白手套、专属顾问、一对一管家、代采购 | 服务未确认 | ATH-CORE-06 |
| 批发价、团购价、工程价、行业折扣 | 项目需求走设计咨询；不设 Trade 价格 | ATH-CORE-06 |
| 工厂直供、没有中间商赚差价 | 需要证据 | ATH-CORE-04 |
| 零甲醛、环保无味、母婴级 | 环保与健康主张需证据 | — |
| 意大利进口、美国制造（未核实） | 产地主张需证据 | — |
| 原价 $X 现价 $Y（无依据）、低至 X 折 | 参考价规则 | — |
| 点击这里、请注意、我们很高兴地通知您 | 翻译腔与空话 | ATH-ZH-07 |

## 正反例（规则）

| 编号 | English ✓ | English ✗ | 中文 ✓ | 中文 ✗ |
|---|---|---|---|---|
| ATH-ZH-01 | — | — | 页面 lang="zh-Hans-US" | 页面写 lang="zh"，或简繁混排 |
| ATH-ZH-02 | — | — | 到货后我们会发邮件通知您 | 亲~到货第一时间通知宝子哦！！ |
| ATH-ZH-03 | — | — | Amber Horizon 客厅套装 | 琥珀地平线客厅套装 |
| ATH-ZH-04 | — | — | 3–7 天内发货 · 共 430 条评价 | 3-7天内发货,共430条评价 |
| ATH-ZH-05 | — | — | 预售 · 10月25日发货（约 60 天） | 预售，2026/10/25 出货，1598 美刀 |
| ATH-ZH-06 | — | — | 优惠码 · 去结算 · 收藏 | 折扣代码 · 结帐 · 心愿单（同一页混用） |
| ATH-ZH-07 | — | — | 加入购物车（2 套）— $3,196 | 点击这里立即抢购 2 套 |
| ATH-ZH-08 | — | — | 实木胡桃木 | 顶级进口胡桃木，零甲醛，全网最低价 |
| ATH-ZH-09 | — | — | 评价按顾客原文显示，不做翻译。 | 把英文评价机翻成中文后展示 |
| ATH-ZH-10 | Email · Phone call · Text message | — | 微信 · 电话 · 邮箱 | 只给英文在线聊天入口 |

## 示例库（按触点）

| 触点 | ✓ | ✗ | 规则 |
|---|---|---|---|
| 首页首屏 | 从构想到家，尽在 Atunus。 | 让生活更美好 | ATH-CORE-01 |
| 项目咨询 | 布置项目空间？预约设计咨询，告诉我们有几个房间、什么时候要。 | 工程价批量供货，欢迎洽谈 | ATH-CORE-06 |
| 公告栏 | 整屋怎么配？设计团队帮您规划 | 下单就送免费设计 | ATH-PX-04 |
| 商品名 | Terra 茶几（洞石） | 泰拉奢华洞石茶几 | ATH-ZH-03 |
| 交期 | 预售 · 10月25日发货（约 60 天） | 很快发货哦 | ATH-PX-02 |
| 加购按钮 | 加入购物车（2 套）— $3,196 | 立即抢购！！ | ATH-ZH-07 |
| 政策 | 30 天退换 | 无理由退货 | ATH-PX-03 |
| 优惠码报错 | 优惠码无效。请检查拼写，或换一个优惠码。 | 您输入的优惠码有误！ | ATH-EN-05 |
| 购物车运费 | 结算时计算 | 包邮 | ATH-PX-07 |
| 空购物车 | 收藏的商品都还在。不知道怎么选？设计师可以和您一起规划。 | 购物车空空如也~快去逛逛吧！ | ATH-EN-02 |
| 评价 | 评价按顾客原文显示，不做翻译。 | （把英文评价机翻后展示） | ATH-ZH-09 |

## 合规

- 中文广告里的价格条件、限制、免责说明一律用中文（16 CFR 14.9）。
- 用中文洽谈的合同、报价、分期，是否需要提供中文译本（加州民法 §1632）由法务判断；确认前不用中文签约。
- 顾客评价按原文显示，不翻译、不改写。

---

## Bundled Reference: `docs/04-visual-identity.md`

# 04 视觉识别

安静、有秩序：暖中性色做底，一种橄榄绿做品牌，赤陶色只给价格和促销。页面靠留白、细线和真实的家具照片说话。

## 规则

| 编号 | 规则 | 挂到的组件 |
|---|---|---|
| ATH-VIS-01 | **颜色**：一套颜色：橄榄色阶 brand-100…900、暖中性色，促销用 sale-700（#A85A3D），警示文字用 warning-700（#936637），控件边框用 neutral-500（#8F8C86）。文字与背景对比度按 WCAG AA：正文 4.5:1，大字与界面图形 3:1；23 组关键配对全部达标。 | ContrastAudit、Button、Badge、Price、Rating |
| ATH-VIS-02 | **标题字体**：标题和正文都用 Archivo（Google Fonts，OFL 授权）；所有标题只走 font-title 一个 token。标题字重 600 或 500，正文 400；购物车与结算金额用等宽数字。 | TypeScale、全部组件 |
| ATH-VIS-03 | **中文字体与字号**：中文不加载网络字体：拉丁字符用 Archivo，中文回落到 PingFang SC（Apple）、Microsoft YaHei（Windows）、Noto Sans SC（Android）。标题比英文阶梯小约 10–15%，字重 600；正文 16px，手机不低于 15px。token：zh-display-1 … zh-body-small-m。 | TypeScaleZh、Locale、tokens: zh-* |
| ATH-VIS-04 | **影像**：房间场景、单品白底、材质细节、规划图四类图按 04「影像」拍摄和挑选；渲染图标注 Rendering / 效果图；AI 不改产品的形状、颜色和材质；设计系统里的家具剪影是占位图。 | Image、Art、Gallery |
| ATH-VIS-05 | **无障碍**：WCAG 2.2 AA：对比度、焦点可见、键盘可达、表单错误可读；中英文页面同一标准。 | 全部组件 |

## Logo

| 版本 | 文件 | 用在 |
|---|---|---|
| 深色字标 | `assets/Logos/atunus-home-logo-dark.svg` | 白底、`bg-base`、浅色照片的留白处 |
| 浅色字标 | `assets/Logos/atunus-home-logo-light.svg` | 页脚 `brand-900`、透明页头、深色或加了遮罩的照片 |
| 图标版 | `assets/Logos/atunus-home-favicon.svg` | 浏览器标签、社媒头像等小尺寸 |

- 尺寸：页头桌面 284 宽、平板 228、手机 185；页脚 256 / 228 / 199；任何地方不小于 120 宽，更小时用图标版。
- 留白：四周留出不少于字母高度的空白。
- 不要：改比例、加描边或阴影、换颜色、拆开 ATUNUS 和 HOME、用文字重新打出字标、放在杂乱的照片上不加遮罩。

## 色彩

| token | 色值 | 用途 |
|---|---|---|
| `bg-base` | #FAFAF9 | 页面底色，品牌的“纸” |
| `bg-section` | #F3F3F0 | 交替区块、信任面板 |
| `surface-brand` | #F7F8F2 | 单品白底图的底色 |
| `brand-100` | #EEEFE6 | 浅橄榄：选中、提示底 |
| `brand-600` | #707461 | 品牌橄榄：主按钮、公告栏 |
| `brand-700` | #565A49 | 橄榄文字、按钮悬停 |
| `brand-900` | #292D23 | 深橄榄：页脚、深色区块 |
| `text-primary` | #2A2926 | 正文、标题、价格 |
| `text-secondary` | #56534F | 辅助文字 |
| `border-base` | #D7D5CF | 细线、分割 |
| `sale-sale` | #B96A4C | 赤陶：24px 以上的促销大字 |
| `sale-700` | #A85A3D | 促销价、Save $X、促销徽章 |

用色比例（一屏或一张图）：

- 暖中性底色（`bg-base`、`bg-section`、白）约 70%。
- 橄榄品牌色约 20%：大面积只用 `brand-900`（页脚、深色区块）和 `brand-100` / `surface-brand`（浅色底）；`brand-600` 用于主按钮、公告栏、套装徽章。
- 赤陶促销色不超过 5%：只用于促销价、Save $X、促销徽章；大字用 `sale-sale`，小字和徽章用 `sale-700`。
- 不加第二个强调色。成功提示用橄榄色，不新增绿色。

文字放在哪种底色上（对比度达到 WCAG AA，见 ContrastAudit）：

| 文字 | 放在 | 用于 |
|---|---|---|
| `text-primary` | bg-base / bg-white / bg-section | 正文和标题 |
| `text-secondary` | bg-base / bg-white / bg-section | 辅助文字 |
| `text-inverse` | brand-600 及更深、页脚、加遮罩的照片 | 按钮字、页脚字、图上字 |
| `brand-700` | bg-base / bg-white / brand-100 | 眉题、次按钮字、橄榄小字 |
| `sale-700` | bg-base / bg-white | 促销价、Save $X |
| `warning-700` | bg-base | 低库存、延期 |

不要：用 `state-error` 画星星或 BEST SELLER；把 `sale-sale` 当高亮（编号、播放中）；把 `brand-500` 当按钮填充；在 `brand-100`、`bg-section` 上放 `text-brand` 小字；`text-tertiary` 只用于深色页脚或 24px 以上文字。

## 字体

只用 Archivo 一个字族（Google Fonts，OFL 授权）：标题 SemiBold 600 或 Medium 500，正文 Regular 400，按钮与标签 Medium / SemiBold。

| 样式 | 桌面 / 手机 | 用在 |
|---|---|---|
| `display-1-semibold` | 72 / 36 | 首页首屏，每页一个 |
| `display-2-semibold` | 56 / 34 | 列表页标题 |
| `heading-h2-semibold` | 40 / 28 | 区块标题（SectionHeader） |
| `heading-h3-medium` | 32 / 22 | 房间卡、步骤标题、商品页大价格 |
| `heading-h4-medium` | 24 / 20 | 商品页品名、订单摘要标题 |
| `heading-h6-medium` | 18 / 16 | 卡片品名 |
| `body-base-regular` | 16 / 14 | 正文（输入框始终 16） |
| `body-small-regular` | 14 / 12 | 辅助信息、面包屑 |
| `caption-base-regular` | 12 / 12 | 日期、法律小字，最小 12 |

- 购物车和结算金额加 `font-variant-numeric: tabular-nums`。
- 大写只由 CSS 的 text-transform 实现，文案不手打大写；不用斜体做强调。
- 中文页面的字号和字体栈见本章最后一节。

## 影像

照片要回答顾客的三个问题：放进房间是什么样，和别的家具怎么配，材质近看怎么样。

| 类型 | 用在哪 | 怎么拍 | 比例 |
|---|---|---|---|
| 房间场景 | 首页首屏、套装商品页首图、广告、社媒 | 拍完整的一角或整个房间，套装的每一件都在画面里；机位齐腰高，平视或略俯；白天自然光，中性偏暖；陈设克制，一个台面不超过 3 件小物 | 16:9（首屏、套装卡、横幅、文章）、3:4（房间卡）、4:5（社媒） |
| 单品白底 | 商品卡、商品页图库、购物车、加购抽屉 | 放在 `surface-brand` 底上居中；正面偏左约 30°；同一行商品用同一比例、同一机位；柔和的落地阴影 | 1:1 |
| 材质与细节 | 商品页图库、面料小样、社媒 | 面料纹理、木纹、石材、接缝和五金的近景；侧光打出纹理 | 4:5 或 1:1 |
| 规划图 | 设计服务页、方案、社媒 | 户型平面图和组合示意图：`brand-700` 线条，`brand-100` 底，标注尺寸 | 1:1 或 4:5 |

- 色调统一：中性偏暖，不偏蓝也不发黄，和 `bg-base` 放在一起不跳色。
- 真实：照片里的产品就是在售的规格和面料。渲染图标注 Rendering / 效果图。AI 只能调背景和光线，不能改产品的形状、颜色、材质。
- 人物：可以出现正在使用家具的人，自然、不看镜头、不作为画面主体。
- 图上文字：放在留白处；大标题下用 `other-overlay`，16–18px 文字用局部 `overlay-strong`；价格和促销字不压在产品上。
- 中文渠道用同一批照片，中文字同样放在留白处。
- 不要：冷蓝光、重滤镜、杂乱道具、和在售产品无关的图库照片、把促销字直接做进照片、同一行混用白底图和场景图。
- 设计系统里的家具剪影（Art）只用于预览，上线时换成真实照片，比例不变。

## 品牌图形：房间方块

用圆角矩形代表一件件家具，在一个平面上排成一个房间，对应“整屋规划”。样子见 Overview 顶部的封面。

- 构成：大块用 `radius-lg`（12），小块用 `radius-sm`（6）；间距用 `space-8` 的倍数；颜色只用 `brand-100`、`brand-200`、`brand-600`、`brand-900`，赤陶色最多一小块。
- 用在：没有照片时的社媒图和邮件头图、方案与报价封面、展厅和印刷物料的背景。
- 不用在：商品页、购物车、结算；不叠在照片上。

## 图标

- Lucide 线性图标，24px 网格，1.5px 描边，圆头圆角，共 61 个；新增图标从 Lucide 取，同样设置。
- 用 `Icon` 组件或 `assets/Icons` 里的 SVG；颜色用 currentColor 跟随文字。尺寸 16 / 20 / 24，按钮内 18 / 22。
- 只有图标的按钮必须有文字标签（`IconButton` 的 `label`）。支付和社媒图标保持各自品牌原色。

## 版式与间距

- 断点：手机 ≤599，平板 600–1023，桌面 ≥1024（设计画板 390 / 800 / 1440）。
- 内容最大宽 `container-max` 1360；左右边距桌面 `padding-lr` 40、平板 `padding-lr-t` 20、手机 `page-gutter-m` 16。
- 区块上下内边距只用 `padding-tb` / `-t` / `-m`（60 / 40 / 32），不用于左右。
- 区块内间距只用 4–80 的刻度（`space-*`）；网格间距 `grid-gap` 24、手机 `grid-gap-m` 16。商品列表桌面 4 列、平板 3 列、手机 2 列。

## 形状、层级、动效

- 圆角随尺寸：小控件与 chip `radius-sm` 6，大按钮与输入框 `radius-md` 8，图片、卡片、面板 `radius-lg` 12，徽章与圆形按钮 `radius-full`。
- 层级靠底色和细线；卡片阴影只用 `shadow-card`，浮层用 `shadow-overlay`。
- 动效：悬停变色 150ms，图片放大 106.25% 用 400ms；轮播必须能暂停；尊重 `prefers-reduced-motion`。
- 每个交互组件都有 default、hover、pressed、focus-visible、disabled；键盘焦点统一用 `focus-ring`（2px 底色间隙 + 2px `brand-800`），深色底和图片上用 `focus-ring-inverse`。

## 中文排版

中文页面在 `.ah-lang-zh` 作用域里把字号 token 指向 zh-* 阶梯，字体 token 指向中文字体栈，现有组件不用改。

| token | 桌面 | 平板 | 手机 | 用途 |
|---|---|---|---|---|
| zh-display-1 | 64px | 48px | 32px | 首页首屏 |
| zh-display-2 | 48px | 40px | 30px | 页面标题 |
| zh-heading-h1 | 40px | 34px | 28px | 落地页大标题 |
| zh-heading-h2 | 34px | 28px | 24px | 区块标题 |
| zh-heading-h3 | 28px | 24px | 20px | 表单与模块标题 |
| zh-heading-h4 | 22px | — | 19px | 商品详情页品名 |
| zh-heading-h5 | 18px | — | 17px | 问答标题 |
| zh-heading-h6 | 16px | — | 15px | 卡片与购物车品名 |
| zh-body-base-m / zh-body-small-m | — | — | 15px / 13px | 中文正文不降到 14px |

字体栈：`font-zh-text` 与 `font-zh-title` 都是 "Archivo", "PingFang SC", "Hiragino Sans GB", "Noto Sans SC", "Noto Sans CJK SC", "Source Han Sans SC", "Microsoft YaHei", sans-serif。行高：标题 1.25–1.45，正文 1.7–1.75。`line-break: strict`（避头尾）。样式卡：Foundations / TypeScaleZh。
