For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /es/docs/modules/config.md (or send Accept: text/markdown).
Entorno y configuración
Un esquema validado para todo el workspace.
Realice un cambio de configuración y compruébelo
Comience con una aplicación web en ejecución. En el editor abra apps/web/.env.local; si no existe, copie .env.example allí usando el tutorial web. Para una primera comprobación inofensiva, busque EMAIL_PROVIDER=local y déjelo local. Esta configuración envía el correo electrónico del producto a la vista previa local en lugar de a una bandeja de entrada real. No pegue líneas KEY=value en el terminal.
Para cada servicio que habilite, siga la guía de configuración de ese proveedor, reemplace solo los valores nombrados, guarde el archivo, detenga el servidor web con Ctrl + C y reinicie con el siguiente comando. Si la validación identifica una clave que falta, vuelva a abrir este archivo y compare esa clave con la guía del proveedor. Mantenga el archivo raíz .env sincronizado solo para los valores utilizados por las migraciones de bases de datos; copiarlo por sí solo no configura Next.js.
corepack pnpm --filter @supastack/web devEmpieza con el ejemplo de entorno
El archivo raíz .env.example es el inventario de configuración. La validación compartida está en packages/config. Revisa juntos el entorno de aplicación y los modos de proveedor seleccionados; una interfaz local no constituye una estrategia de credenciales de producción.
El modo de referencia sin credenciales requiere configuración de aplicación local/de prueba y proveedores fake/local. Seleccionar un proveedor de producción cambia los requisitos de runtime.
Mantén los secretos detrás de la API
Los secretos de autenticación, las credenciales de base de datos, las claves de proveedores, los secretos de Stripe y las credenciales de Trigger son solo del servidor. Nunca les añadas el prefijo NEXT_PUBLIC_ o EXPO_PUBLIC_. No los imprimas durante la configuración ni los incluyas en respuestas de error.
El navegador recibe configuración pública y alias de modelos permitidos. La propiedad del espacio de trabajo, las decisiones sobre derechos, los presupuestos y la selección de proveedores se aplican en el servidor.
Comprueba un cambio antes de usarlo
Valida la configuración mediante el paquete de configuración existente y ejecuta las pruebas deterministas pertinentes. Usa la prueba rápida de proveedores independiente y opcional cuando quieras verificar integraciones reales.
corepack pnpm test
corepack pnpm check
corepack pnpm buildConfiguración y ajustes
packages/config es el único lugar que parsea process.env: un esquema zod produce un ServerConfig y un PublicConfig tipados, y la selección de proveedor se expresa como kinds — providers.ai, providers.billing, providers.email, providers.jobs, providers.storage se resuelven cada uno a un adaptador nombrado más sus campos requeridos.
Habilitar un proveedor hace sus credenciales requeridas: activar un acceso social, el kind de storage s3 o el kind de email resend hace fallar el arranque nombrando la variable faltante, en lugar de una sorpresa en runtime más tarde.
STORAGE_PROVIDER=s3
STORAGE_BUCKET=kit
STORAGE_ENDPOINT=https://s3.example
STORAGE_PUBLIC_BASE_URL=https://cdn.example
# → config rejects the env if a required field is missingFlujo de implementación
Lee la config a través de parseServerConfig en el límite del servidor y pasa el valor tipado hacia adentro — no toques process.env dentro del código de funciones. La config pública es un objeto separado, deliberadamente pequeño, seguro de serializar al cliente.
El env específico del producto pertenece al esquema propio del producto consumidor. Resiste hacer crecer el esquema del kit para las necesidades de un solo producto.
Verificación y solución de problemas
Ejecuta los tests del paquete config tras cambiar el esquema, y comprueba que una variable requerida ausente se nombra a sí misma en el error. Un env que parsea localmente pero no en producción suele significar un campo requerido indocumentado.