Skip to content

feat(expo): add native component theming via Expo config plugin #8243

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
wobsoriano merged 12 commits into from
Apr 15, 2026
Merged

feat(expo): add native component theming via Expo config plugin #8243

Changes from 1 commit
Commits
Show all changes
12 commits
Select commit Hold shift + click to select a range
3f2f058
feat(expo): add native component theming via Expo config plugin
chriscanin Apr 6, 2026
221e30c
fix(expo): apply Android theme after Clerk.initialize and use real Cl…
chriscanin Apr 8, 2026
b5af733
chore(expo): add changeset for native component theming
chriscanin Apr 8, 2026
19bc65a
fix(expo): reject 3-digit hex in theme validation and fix Android 8-d…
chriscanin Apr 10, 2026
3c703ef
fix(expo): stop removing UIUserInterfaceStyle when darkColors is present
chriscanin Apr 13, 2026
665952e
chore(expo): update changeset to reflect UIUserInterfaceStyle change
chriscanin Apr 13, 2026
64521d0
fix(expo): fix iOS theme parsing for clerk-ios 1.0.0 API
chriscanin Apr 13, 2026
2490b35
fix(expo): strict object validation in theme JSON and add tests
chriscanin Apr 13, 2026
578ac31
fix(expo): add top-level object validation and remove stale JSDoc
manovotny Apr 14, 2026
4786284
fix(expo): address review feedback on theming PR
chriscanin Apr 14, 2026
257de36
chore(expo): remove stale ClerkViewFactory.swift template
chriscanin Apr 14, 2026
1ae23f1
fix(expo): suppress no-require-imports lint error in theme test
chriscanin Apr 15, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
chore(expo): add changeset for native component theming
  • Loading branch information
@chriscanin
chriscanin committed Apr 8, 2026
commit b5af733345d4cc4be9d2a378b22a596135e5887d
24 changes: 24 additions & 0 deletions .changeset/expo-native-component-theming.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
---
'@clerk/expo': minor
---

Add native component theming via the Expo config plugin. You can now customize the appearance of Clerk's native components (`<AuthView />`, `<UserButton />`, `<UserProfileView />`) on iOS and Android by passing a `theme` prop to the plugin pointing at a JSON file:

```json
{
"expo": {
"plugins": [
["@clerk/expo", { "theme": "./clerk-theme.json" }]
]
}
}
```

The JSON theme supports:

- `colors` — 15 semantic color tokens (`primary`, `background`, `input`, `danger`, `success`, `warning`, `foreground`, `mutedForeground`, `primaryForeground`, `inputForeground`, `neutral`, `border`, `ring`, `muted`, `shadow`) as 6- or 8-digit hex strings.
- `darkColors` — same shape as `colors`; applied automatically when the system is in dark mode.
- `design.borderRadius` — number, applied to both platforms.
- `design.fontFamily` — string, **iOS only**.

Theme JSON is validated at prebuild. On iOS the theme is embedded into `Info.plist` (and `UIUserInterfaceStyle` is removed when `darkColors` is present, so the system can switch modes). On Android the JSON is copied into `android/app/src/main/assets/clerk_theme.json`.
Loading