# fonts-config-plugin

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.

- rule · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 88 repo stars
- Author: alexj11324
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/alexj11324/Mikka/tree/HEAD/.claude/skills/react-native-skills/rules/fonts-config-plugin.md
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/rules/fonts-config-plugin

## What it 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.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/rules/fonts-config-plugin.md` — The paths frontmatter field limits the files

### Codex

**AGENTS.md**
- Codex reads AGENTS.md: paste the rule text there

### Cursor

**Manually: put the files in place**
- File: `.cursor/rules/fonts-config-plugin.mdc` — Frontmatter: description, globs, alwaysApply

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/instructions/fonts-config-plugin.instructions.md` — The applyTo field sets which files it applies to

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/rules/fonts-config-plugin.md`

### Cline

**Manually: put the files in place**
- File: `.clinerules/fonts-config-plugin.md`

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/alexj11324/Mikka/tree/HEAD/.claude/skills/react-native-skills/rules/fonts-config-plugin.md

## When to use it
- 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
- 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

## Similar
- [maplibre-fonts-glyphs](https://affpapa.org/en/nevibecode/skills/maplibre-fonts-glyphs.md) — skill · 335 installs
- [google-fonts-skill](https://affpapa.org/en/nevibecode/skills/google-fonts-skill.md) — skill · 210 installs
- [fonts](https://affpapa.org/en/nevibecode/rules/fonts.md) — rule · ★ 849 repo stars
- [design-mobile-apps](https://affpapa.org/en/nevibecode/skills/design-mobile-apps.md) — skill · 1500000 installs
- [animate-expo](https://affpapa.org/en/nevibecode/skills/animate-expo.md) — skill · 189400 installs
- [expo-module](https://affpapa.org/en/nevibecode/skills/expo-expo-module.md) — skill · 51000 installs

From the same set: [alexj11324/mikka](https://affpapa.org/en/nevibecode/by/alexj11324/mikka.md) — 47 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
