callstackincubator/apex-software-factory / .agents/skills/expo-ui
expo-ui
VerifiedBuild native UI with the @expo/ui package: real SwiftUI on iOS and Jetpack Compose on Android. Default to @expo/ui for sheets (BottomSheet), pickers, sliders, toggles, menus, and grouped-form sections — do NOT reach for Reanimated, @gorhom/bottom-sheet, or RN built-in Picker/Switch; use @expo/ui instead. Fall back to RN built-ins only when @expo/ui is missing the component. NOTE: @expo/ui List renders native grouped rows like an iOS Settings screen — it is NOT a virtualized list; use FlatList/FlashList for large datasets. Covers universal components (Host, Column, Row, Button, Text, List, BottomSheet, FieldGroup, Switch, Slider, Picker, Menu), drop-in replacements for RN community libraries, and platform-specific SwiftUI/Jetpack Compose trees. Not for Expo Router navigation, Reanimated, or data fetching.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.6 KB |
| SOURCE.md | markdown | 1.1 KB |
| references/drop-in-replacements.md | markdown | 2.6 KB |
| references/jetpack-compose.md | markdown | 5.4 KB |
| references/swift-ui.md | markdown | 4.3 KB |
| references/universal.md | markdown | 5.1 KB |
| scripts/list-components.js | script | 7.3 KB |
scripts/list-components.js
View on GitHub#!/usr/bin/env node
/**
* List available @expo/ui components and modifiers installed in a project.
*
* Usage:
* node list-components.js <project-path> [--docs]
*
* --docs Include a one-line JSDoc description per modifier.
* Omit (default) for a compact names-only list that consumes fewer tokens.
*
* Output goes to stdout. Redirect or capture it to inject into an agent prompt.
*/
"use strict";
const fs = require("fs");
const path = require("path");
const projectPath = process.argv[2];
const withDocs = process.argv.includes("--docs");
if (!projectPath) {
console.error("Usage: node list-components.js <project-path> [--docs]");
process.exit(1);
}
const pkgRoot = path.join(projectPath, "node_modules", "@expo", "ui");
if (!fs.existsSync(pkgRoot)) {
console.error(`@expo/ui not found in ${projectPath}/node_modules`);
process.exit(1);
}
// Read installed version from package.json
let version = "unknown";
try {
const pkg = JSON.parse(fs.readFileSync(path.join(pkgRoot, "package.json"), "utf8"));
version = pkg.version || "unknown";
} catch {}
// ---------------------------------------------------------------------------
// Component extraction — parse `export * from './Name'` in an index.d.ts
// ---------------------------------------------------------------------------
// TypeScript type names that are not components — skip anything matching these suffixes
const TYPE_SUFFIX =
/(?:Props|Ref|Handle|Params|Config|Options|Type|Types|Value|Values|Colors|Style|Styles|Event|Events|Alignment|Animation|Spec)$/;
function extractComponents(indexFile) {
if (!fs.existsSync(indexFile)) return [];
const src = fs.readFileSync(indexFile, "utf8");
const names = [];
for (const line of src.split("\n")) {
// export * from './ComponentName' or export * from './ComponentName/index'
const m = line.match(/^export \* from ['"]\.\/([^/'"]+)/);
if (m) {
const name = m[1];
// Skip non-component re-exports (types, utils, state internals)
if (/^(types|utils|index|State|hooks|colors|layout-types|MaterialSymbols)/.test(name))
continue;
if (TYPE_SUFFIX.test(name)) continue;
names.push(name);
}
// export { Name, ... } from './Something' — pick up named re-exports too
const n = line.match(/^export \{([^}]+)\}/);
if (n) {
for (const part of n[1].split(",")) {
// Skip `type Foo` re-exports
if (/^\s*type\s/.test(part)) continue;
const id = part
.trim()
.split(/\s+as\s+/)[0]
.trim();
if (id && /^[A-Z]/.test(id) && !TYPE_SUFFIX.test(id)) names.push(id);
}
}
}
return [...new Set(names)].sort();
}
// ---------------------------------------------------------------------------
// Modifier extraction — parse `export declare const/function <name>` in
// a flat modifiers/index.d.ts, optionally with the preceding JSDoc summary.
// ---------------------------------------------------------------------------
function extractModifiers(modifiersFile) {
if (!fs.existsSync(modifiersFile)) return [];
const src = fs.readFileSync(modifiersFile, "utf8");
const lines = src.split("\n");
const results = [];
const seen = new Set();
for (let i = 0; i < lines.length; i++) {
const line = lines[i];
const m = line.match(/^export declare (?:const|function) ([a-zA-Z_][a-zA-Z0-9_]*)/);
if (!m) continue;
const name = m[1];
// Skip type-only helpers and internal symbols
if (/^(is|filter|create|type|export)/.test(name) && name !== "frame") continue;
if (seen.has(name)) continue;
seen.add(name);
if (!withDocs) {
results.push({ name });
continue;
}
// Find /** that opens the JSDoc block immediately preceding this export,
// then scan forward through the block for the first plain-prose summary.
let jsdocStart = -1;
for (let j = i - 1; j >= 0; j--) {
const jl = lines[j].trim();
if (jl === "/**") {
jsdocStart = j;
break;
}
if (jl !== "" && jl !== "*/" && !jl.startsWith("*")) break;
}
let summary = "";
let deprecated = false;
if (jsdocStart >= 0) {
let inCodeBlock = false;
for (let k = jsdocStart + 1; k < i; k++) {
const kl = lines[k].trim();
if (kl.startsWith("* ```")) {
inCodeBlock = !inCodeBlock;
continue;
}
if (inCodeBlock) continue;
// Check @deprecated anywhere in the block (may appear after @param)
if (kl.startsWith("* @deprecated")) {
deprecated = true;
continue;
}
// Extract summary from opening prose only — stop at first non-deprecated tag
if (!summary) {
if (kl.startsWith("* @")) continue; // skip tags while looking for prose
if (kl === "*/" || kl === "/**" || kl === "*") continue;
if (kl.startsWith("* ")) {
const text = kl.slice(2).trim();
if (!text.startsWith("-") && !text.startsWith("<")) {
summary = text.replace(/\.$/, "");
}
}
}
}
}
results.push({ name, summary, deprecated });
}
return results;
}
// ---------------------------------------------------------------------------
// Format helpers
// ---------------------------------------------------------------------------
function formatNames(names) {
return names.join(", ");
}
function formatModifiers(mods) {
if (!withDocs) return mods.map((m) => m.name).join(", ");
const lines = [];
for (const m of mods) {
const dep = m.deprecated ? " [deprecated]" : "";
const desc = m.summary ? ` — ${m.summary}` : "";
lines.push(` ${m.name}${dep}${desc}`);
}
return lines.join("\n");
}
// ---------------------------------------------------------------------------
// Main
// ---------------------------------------------------------------------------
const buildRoot = path.join(pkgRoot, "build");
// Universal
const universalComponents = extractComponents(path.join(buildRoot, "universal", "index.d.ts"));
// Swift-UI (iOS only)
const swiftuiComponents = extractComponents(path.join(buildRoot, "swift-ui", "index.d.ts"));
const swiftuiModifiers = extractModifiers(
path.join(buildRoot, "swift-ui", "modifiers", "index.d.ts"),
);
// Jetpack Compose (Android only)
const composeComponents = extractComponents(path.join(buildRoot, "jetpack-compose", "index.d.ts"));
const composeModifiers = extractModifiers(
path.join(buildRoot, "jetpack-compose", "modifiers", "index.d.ts"),
);
const docsNote = withDocs
? " (with descriptions)"
: " (names only — run with --docs for descriptions)";
console.log(`@expo/ui ${version}${docsNote}\n`);
console.log(`@expo/ui — universal (iOS + Android + web)`);
console.log(` Components: ${formatNames(universalComponents)}\n`);
console.log(`@expo/ui/swift-ui — iOS ONLY (crashes on Android)`);
console.log(` Components: ${formatNames(swiftuiComponents)}`);
if (withDocs) {
console.log(` Modifiers:\n${formatModifiers(swiftuiModifiers)}`);
} else {
console.log(` Modifiers: ${formatModifiers(swiftuiModifiers)}`);
}
console.log();
console.log(`@expo/ui/jetpack-compose — Android ONLY (crashes on iOS)`);
console.log(` Components: ${formatNames(composeComponents)}`);
if (withDocs) {
console.log(` Modifiers:\n${formatModifiers(composeModifiers)}`);
} else {
console.log(` Modifiers: ${formatModifiers(composeModifiers)}`);
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |