Font Management

Font Management

Manage typography assets. 11 seed typefaces are hosted at GitHub YaoApp/design-assets and downloaded on demand. Additional fonts can be installed via Google Fonts.

Seed Typefaces (11 total)

English (7)

Chinese (3)

Icon (1)

Listing Available Fonts

Parse the font table from INDEX.md and check local cache:

cat $WORKDIR/design-works/.cache/assets/INDEX.md

For each font, check if cached:

ls $WORKDIR/design-works/.cache/assets/fonts/{family}/{file} 2>/dev/null \
  && echo "cached" || echo "not cached"

Display as a table with status: ✅ cached or ☁️ on-demand.

Font Recommendations

Installing Fonts

From GitHub Registry (seed fonts)

FAMILY="Inter"
FONT_FILE="fonts/inter/Inter-Variable.woff2"
RAW_BASE="https://raw.githubusercontent.com/YaoApp/design-assets/main"
CACHE="$WORKDIR/design-works/.cache/assets/$FONT_FILE"

if [ ! -f "$CACHE" ]; then
  echo "Downloading $FAMILY..."
  mkdir -p "$(dirname "$CACHE")"
  curl -# "$RAW_BASE/$FONT_FILE" -o "$CACHE"
  echo "$FAMILY downloaded"
fi

# Copy to fonts/ and register with preview server
TARGET_DIR="$WORKDIR/design-works/fonts/$(echo "$FAMILY" | tr 'A-Z ' 'a-z-')"
mkdir -p "$TARGET_DIR"
cp "$CACHE" "$TARGET_DIR/"
curl -s -X POST http://localhost:3000/api/fonts/install \
  -H "Content-Type: application/json" \
  -d '{"family": "Inter", "weights": [400, 500, 600, 700, 800]}'

From Google Fonts (non-seed fonts)

curl -X POST http://localhost:3000/api/fonts/install \
  -H "Content-Type: application/json" \
  -d '{"family": "Montserrat", "weights": [400, 600, 700]}'

Extracting Fonts from Reference

When user provides a reference URL:

1. web_fetch the page
2. Extract CSS font-family declarations
3. Match against INDEX.md seed fonts first (prefer managed fonts)
4. For unmatched fonts, recommend from Google Fonts
5. Present recommendation for user confirmation before installing

Chinese/English Font Pairing

Rules

• Prefer seed fonts — 11 typefaces cover 95% of scenarios
• Download fonts on first use; show user visible download progress
• Only install additional fonts when user explicitly requests a special typeface
• Seed fonts are protected — deletion must check target is NOT one of the 11
• Chinese fonts are large (Noto Sans SC ~8MB per weight); warn before downloading
• Variable fonts (Inter, Material Symbols) preferred to reduce file count
• INDEX.md version changes auto-override cached font files
• User-installed non-seed fonts cached to .cache/assets/fonts/ user subdirectory