api-expert

Handles backend integration using best practices like expo/fetch and React Query. Use when the user needs to connect to an API, handle data fetching, or implement caching.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

The API Expert skill streamlines backend integration for React Native Expo applications by implementing industry-standard best practices. It automates the creation of robust data fetching layers using expo/fetch and TanStack React Query, ensuring high performance, efficient caching, and strict type safety through Zod schema validation. This skill helps developers build maintainable, production-ready network layers with clean architectural separation.

Use Cases

  • Scenario 1: Connecting a mobile application to RESTful backend services with optimized caching and state synchronization.
  • Scenario 2: Implementing type-safe API responses using Zod to prevent runtime crashes and ensure data integrity.
  • Scenario 3: Architecting a clean service layer in React Native projects to decouple API logic from UI components.
  • Scenario 4: Setting up standardized error handling and loading states across a mobile application using React Query hooks.
nameapi-expert
descriptionHandles backend integration using best practices like expo/fetch and React Query. Use when the user needs to connect to an API, handle data fetching, or implement caching.

API Expert Skill

This skill provides expertise in integrating backend services into React Native Expo applications. It emphasizes reliability, performance, and clean architecture.

Core Principles

  • Use expo/fetch: Always prefer expo/fetch over standard fetch or axios.
  • React Query: Use @tanstack/react-query for managing server state, caching, and synchronization.
  • Service Layer: Keep API logic in the services/ directory.
  • Type Safety: Define Zod schemas for runtime validation and TypeScript interfaces for compile-time safety.

Instructions

  1. Setup Client: Ensure the React Query client is configured in app/_layout.tsx.
  2. Define Services: Create service files in services/api/ that use expo/fetch.
  3. Custom Hooks: Wrap service calls in custom React Query hooks.
  4. Error Handling: Implement early returns and use ErrorBoundary for unexpected failures.
  5. Validation: Use Zod to validate API responses at the network boundary.

Example

// services/api/user-service.ts
import { fetch } from 'expo/fetch';
import { z } from 'zod';

const UserSchema = z.object({
  id: z.string(),
  name: z.string(),
});

export const fetchUser = async (id: string) => {
  const response = await fetch(`https://api.example.com/users/${id}`);
  if (!response.ok) throw new Error('Failed to fetch user');
  const data = await response.json();
  return UserSchema.parse(data);
};

// hooks/use-user.ts
import { useQuery } from '@tanstack/react-query';
import { fetchUser } from '@/services/api/user-service';

export const useUser = (id: string) => {
  return useQuery({
    queryKey: ['user', id],
    queryFn: () => fetchUser(id),
  });
};

See API Best Practices for more details.