ArctonArcton
Configuración

Entorno

Qué hace la opción env y cómo leer variables de entorno en cada runtime.

Qué hace env

app.listen() recibe una opción env que por defecto vale process.env.NODE_ENV ?? 'development'. Se usa para exactamente una cosa: la etiqueta que se imprime en el banner de inicio.

import { Arcton } from '@arcton/core'

const app = Arcton()

app.get('/', () => 'Hello, Arcton!')

app.listen({ env: 'staging' })

El banner imprime entonces Environment staging en vez del valor por defecto. Consulta Opciones de Listen para el resto de lo que listen() imprime y devuelve.

Leer variables de entorno

Más allá de esa única etiqueta, las variables de entorno se leen de la forma normal para el runtime que esté sirviendo la app — no hay ninguna capa de configuración propia de Arcton de por medio.

En Bun, los archivos .env se cargan automáticamente, así que process.env ya tiene lo que sea que defina un archivo .env para cuando corre tu código:

import { Arcton } from '@arcton/core'

const app = Arcton()

const databaseUrl = process.env.DATABASE_URL

app.get('/health', () => ({ ok: databaseUrl !== undefined }))

app.listen()

En Node.js, lee process.env de la misma manera. Carga un archivo .env primero si usas uno — por ejemplo con la propia flag --env-file de Node al arrancar el proceso:

node --env-file=.env dist/index.js
import { nodeAdapter } from '@arcton/adapter-node'
import { Arcton } from '@arcton/core'

const app = Arcton()

const databaseUrl = process.env.DATABASE_URL

app.get('/health', () => ({ ok: databaseUrl !== undefined }))

app.listen({ adapter: nodeAdapter })

NODE_ENV no se lee para nada más que ese valor por defecto de env — si tu propio código toma decisiones según esa variable (feature flags, nivel de logging, etc.), lee process.env.NODE_ENV directamente, igual que hace app.listen().

En esta página