Compuertas de Calidad de CI

Las compuertas de calidad de CI ejecutan los mismos scripts lint, typecheck, format:check y test en cada pull request - capturando errores de dependencias de hooks y rupturas de tipos entre paquetes antes de que EAS gaste minutos en una compilación nativa.

Receta

Tarjeta de referencia rápida - lista para copiar y pegar.

// package.json - scripts que CI llamará
{
  "scripts": {
    "lint": "expo lint",
    "typecheck": "tsc --noEmit",
    "format:check": "prettier --check .",
    "test": "jest"
  }
}

# Pre-push local (misma secuencia que CI)
npm run format:check && npm run lint && npm run typecheck && npm run test

Cuándo usarlo:

• Cada equipo que usa pull requests para fusionarse con main o release/*.
• Apps de Expo donde un error de tipo actualmente solo aparece durante eas build.
• Monorepos que necesitan lint y tsc a través de apps/mobile y packages/*.
• Proyectos adoptando EAS Workflows y queriendo comprobaciones de calidad antes de trabajos type: build.
• Aplicando una política ESLint de cero advertencias sin depender de hooks pre-commit de honor-system.

Ejemplo Funcional

# .github/workflows/quality.yml
name: Quality Gates
 
on:
  pull_request:
    branches: [main]
  push:
    branches: [main]
 
concurrency:
  group: quality-${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true
 
jobs:
  quality:
    name: Lint, Format, Types, Tests
    runs-on: ubuntu-latest
    timeout-minutes: 15
 
    steps:
      - name: Checkout
        uses: actions/checkout@v4
 
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: npm
 
      - name: Install dependencies
        run: npm ci
 
      - name: Generate Expo types
        run: npx expo customize tsconfig.json
 
      - name: Prettier
        run: npm run format:check
 
      - name: ESLint
        run: npm run lint
 
      - name: TypeScript
        run: npm run typecheck
 
      - name: Unit tests
        run: npm run test -- --ci --passWithNoTests

# .eas/workflows/quality-gates.yml - mismos scripts en infraestructura Expo
name: Quality Gates
 
on:
  pull_request:
    branches: [main]
  push:
    branches: [main]
 
concurrency:
  cancel_in_progress: true
  group: ${{ workflow.filename }}-${{ github.ref }}
 
jobs:
  quality:
    name: Lint, Format, Types, Tests
    steps:
      - uses: eas/checkout
      - uses: eas/use_npm_token
      - uses: eas/install_node_modules
 
      - name: Generate Expo types
        run: npx expo customize tsconfig.json
 
      - name: Format check
        run: npm run format:check
 
      - name: Lint
        run: npm run lint
 
      - name: Typecheck
        run: npm run typecheck
 
      - name: Unit tests
        run: npm run test -- --ci --passWithNoTests
 
  build_ios:
    name: iOS build (after quality)
    needs: [quality]
    type: build
    params:
      platform: ios
      profile: preview

// turbo.json - monorepo expande las mismas compuertas
{
  "$schema": "https://turbo.build/schema.json",
  "tasks": {
    "lint": {
      "dependsOn": ["^lint"]
    },
    "typecheck": {
      "dependsOn": ["^typecheck"]
    },
    "test": {
      "dependsOn": ["^test"]
    },
    "format:check": {
      "outputs": []
    }
  }
}

# .github/workflows/quality-monorepo.yml
name: Monorepo Quality
 
on:
  pull_request:
 
jobs:
  quality:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: npm
      - run: npm ci
      - run: npx turbo run format:check lint typecheck test

Lo que esto demuestra:

• Una superficie de scripts package.json - desarrolladores y CI ejecutan comandos idénticos.
• GitHub Actions usa npm ci, Node 20 y cancelación de concurrencia para ahorrar minutos.
• npx expo customize tsconfig.json asegura que .expo/types exista antes de tsc --noEmit.
• EAS Workflows reutilizan los mismos scripts, luego needs: [quality] bloquea compilaciones nativas en caso de fallo.
• Turborepo ejecuta lint/typecheck/test a través de workspaces con ordenamiento consciente de dependencias.

Profundo

Cómo Funciona

• Cada paso de CI es un comando shell que sale con código distinto de cero en caso de fallo - GitHub y EAS marcan la ejecución como fallida.
• expo lint envuelve ESLint con eslint-config-expo - los errores fallan el trabajo a menos que pases --max-warnings intencionalmente.
• tsc --noEmit valida el gráfico completo de TypeScript, incluyendo paquetes de workspace importados por la app.
• prettier --check falla en divergencia de formateo sin mutar el sistema de archivos del runner.
• Las reglas de protección de rama pueden requerir la comprobación quality antes de fusionar - aplicación de política, no sugerencias.

Scripts que CI Debe Llamar

GitHub Actions vs EAS Workflows

Ordenamiento de Compuertas

format:check - lint - typecheck - test - (opcional) eas build

• Format primero - señal más rápida; falla en segundos en diffs pequeños.
• Lint segundo - captura problemas específicos de RN que ESLint posee.
• Typecheck tercero - más lento pero encuentra rupturas entre archivos.
• Tests último - más costoso; aún antes de compilación nativa.
• EAS build - solo después de que la calidad pase; ahorra tiempo de cola y créditos de compilación.

Notas de Monorepo

// apps/mobile/package.json
{
  "scripts": {
    "lint": "expo lint",
    "typecheck": "tsc --noEmit",
    "test": "jest"
  }
}

• Root turbo run lint typecheck respeta dependsOn: ["^lint"] así que packages/ui se lintea antes de apps/mobile.
• Fija una versión de Node en engines y CI - las herramientas de RN asumen Node 20 LTS.
• Para pnpm, reemplaza npm ci con pnpm install --frozen-lockfile y cache: pnpm en setup-node.

Errores Comunes

• Saltarse expo customize antes de tsc - Las rutas tipificadas fallan con .expo/types faltante en un checkout de CI limpio. Solución: Agrega un paso explícito antes de typecheck, o confirma tipos generados solo si la política de tu equipo lo requiere (usualmente no).

• npm install en lugar de npm ci en CI - La divergencia de lockfile produce flakiness "funciona en CI, falla localmente". Solución: Siempre usa npm ci cuando package-lock.json existe.

• Ejecutar prettier --write en CI - El runner formatea archivos que nunca se confirman; main queda sucia. Solución: Usa solo --check en workflows.

• Se permiten advertencias de lint al fusionar - --max-warnings 0 no es el predeterminado en todas partes; las advertencias se acumulan. Solución: Trata advertencias como errores en CI al adoptar una política de cero advertencias, o soluciona advertencias antes de habilitar la compuerta.

• Trabajo de calidad no requerido en protección de rama - Los desarrolladores fusionan con bypass de admin mientras las comprobaciones están en rojo. Solución: GitHub - Configuración - Branches - requiere la comprobación de estado quality.

• EAS build sin needs: [quality] - Las compilaciones nativas comienzan mientras lint aún está fallando. Solución: Encadena needs para que trabajos type: build esperen el trabajo de calidad personalizado.

Alternativas

Preguntas Frecuentes

npx turbo run test --filter=mobile
# o todos los paquetes:
npx turbo run test

Relacionado

• Linting Basics - eslint-config-expo y las reglas que expo lint aplica
• Prettier & Import Sorting - script format:check e .prettierignore
• TypeScript Strict Mode - lo que typecheck valida
• Monorepo with Turborepo - turbo run lint typecheck a través de workspaces
• Project Setup Basics - scripts predeterminados scaffolded con SDK 57
• EAS Workflows - catálogo completo de workflow más allá de compuertas de calidad

Versiones de Stack: Esta página fue escrita para Expo SDK 57 (expo ~57.0.4), React Native 0.86.0, y React 19.2.3.