Skip to main content
rule CX Codex

fonts-config-plugin — Claude Code rule: what it does, how to install

fonts-config-plugin is a Claude Code rule that embeds Expo fonts at build time. It directs the assistant to configure the expo-font plugin instead of runtime loaders.

AGPL-3.0 ★ 88 updated 2026-11-17

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/rules/fonts-config-plugin.md
Open on GitHub

What fonts-config-plugin does

This rule guides the coding agent to declare font assets inside app.json via the expo-font configuration plugin. Embedding files into the native package eliminates runtime calls like useFonts or Font.loadAsync, removing the need for loading screens or display guards in React Native views.

Applying these asset changes requires running npx expo prebuild followed by a fresh native compilation. Native binaries will miss the linked font files if the prebuild command is omitted.

What it helps with

  • embed custom font files into native Expo builds
  • eliminate font loading state guards in components
  • configure the expo-font entry in app.json
  • replace useFonts and Font.loadAsync implementations

Example prompts for the agent

  • Configure our custom font in app.json using the expo-font plugin
  • Switch font handling from useFonts to build-time embedding
  • Clean up font loading checks from the main App component

How to install fonts-config-plugin

Manually: put the files in place

.claude/rules/fonts-config-plugin.md

The paths frontmatter field limits the files

Step by step, with commands for each platform: AGENTS.md vs CLAUDE.md: what they are and which one to use

Questions about fonts-config-plugin

How to install fonts-config-plugin in Claude Code?

Save the rule configuration file to .claude/rules/fonts-config-plugin.md in the root of your project.

What does fonts-config-plugin change in a project?

It directs the agent to embed typography assets into native packages using Expo config plugins rather than loading them asynchronously inside UI components.

What command is required after editing app.json?

Run npx expo prebuild in your terminal and rebuild the native application.

Similar IDE rules

All IDE rules for Mobile →

From the same set47

The whole set →
react-compiler-destructure-functions react-compiler-destructure-functions is a Claude Code rule that enforces extracting hook functions early in render scope. It targets projects running the React Compiler. CX Codex +1 ★ 88repo stars ui-scrollview-content-inset ui-scrollview-content-inset is a Claude Code rule for changing ScrollView spacing when keyboards, toolbars, or content alter the available space. CX Codex +1 ★ 88repo stars monorepo-single-dependency-versions monorepo-single-dependency-versions is a Claude Code rule that pins identical dependency versions across monorepo packages. It stops bundle bloat and runtime version clashes. CX Codex +1 ★ 88repo stars animation-derived-value animation-derived-value is a Claude Code rule for computing one animated shared value from another. It applies to React Native Reanimated code that derives values. CX Codex +1 ★ 88repo stars list-performance-images list-performance-images is a Claude Code rule for loading appropriately sized images in lists. It applies when editing interfaces that display image thumbnails. CX Codex +1 ★ 88repo stars imports-design-system-folder imports-design-system-folder is a Claude Code rule that forbids importing UI packages directly into application code. All components must pass through a local design system directory. CX Codex +1 ★ 88repo stars ui-pressable ui-pressable is a Claude Code rule for choosing touch components in React Native. It applies when an agent adds or edits buttons and list items. CX Codex +1 ★ 88repo stars ui-safe-area-scroll ui-safe-area-scroll is a Claude Code rule that enforces native iOS safe area handling in React Native ScrollViews. It stops layout jumping during keyboard transitions. CX Codex +1 ★ 88repo stars

Project sponsors

Companies that keep this analytics open