> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Comandos, archivos y configuración.

Aprenda dónde pegar comandos, cómo abrir la carpeta del proyecto correcta, editar archivos .env, detener un servidor e informar un error de configuración sin compartir secretos.

## Un comando va en la terminal.

Una terminal es la ventana donde escribe instrucciones para su computadora. En Visual Studio Code, primero abra su carpeta supastack usando Archivo → Abrir carpeta, luego seleccione Terminal → Nueva terminal. La nueva terminal comienza en esa carpeta. En Windows, elija PowerShell usando el menú al lado del botón + del terminal. Utilice bloques de macOS/Linux en una terminal macOS o Linux.

Pegue solo el contenido de un bloque de comando, un comando a la vez, y presione Entrar. No pegue las comillas invertidas de Markdown circundantes, un mensaje como PS C:\... o una salida de ejemplo. Las líneas que comienzan con # son explicaciones; no ejecutan nada. Espere a que finalice cada comando de instalación antes de ingresar el siguiente comando. Un comando del servidor continúa ejecutándose y no devuelve un mensaje nuevo hasta que lo detiene.


## Comprueba qué carpeta está usando el terminal

Raíz del repositorio significa la carpeta supastack de nivel superior que contiene package.json, pnpm-workspace.yaml, aplicaciones y paquetes. A menos que un paso indique lo contrario, ejecute los comandos allí. El siguiente comando imprime la carpeta actual; la lista de archivos debería mostrar package.json. En Windows PowerShell pwd y ls también funcionan.

Si el listado muestra solo el contenido de apps/web o apps/mobile, escriba cd ../.. y presione Enter para regresar a la raíz. Si muestra su carpeta de inicio, escriba cd seguido de un espacio y la ruta completa a su clon, entre comillas cuando contenga espacios. Abrir la carpeta del proyecto en el editor y crear una nueva terminal suele ser más fácil.

```
pwd
ls
```


## La configuración va en un archivo, no en la terminal.

Un bloque como AI_PROVIDER=fake es texto de configuración. Abra el archivo .env nombrado en el editor, busque la línea que comienza con AI_PROVIDER=, reemplace su valor y guárdelo con Ctrl + S (Comando + S en macOS). Cada configuración ocupa una línea en formato KEY=value. No agregue comillas invertidas de Markdown. Evite copias duplicadas de la misma clave en un archivo.

Utilice root .env para los comandos de migración de bases de datos, apps/web/.env.local para el servidor web Next.js y apps/mobile/.env.local para Expo. Next y Expo se ejecutan dentro de sus propias carpetas de aplicaciones y no cargan automáticamente el archivo .env raíz. Si cambia la conexión de una base de datos, actualice DATABASE_URL tanto en el .env raíz como en apps/web/.env.local para que las migraciones y el servidor utilicen la misma base de datos. Mantenga el archivo de ejemplo sin cambios para referencia futura.

Los archivos cuyos nombres comienzan con un punto pueden estar ocultos en su administrador de archivos; El Explorador del editor los muestra. Asegúrese de que el nombre del archivo sea exactamente .env.local, no .env.local.txt. Estos archivos locales pueden contener contraseñas y están excluidos de Git; no los cargue ni pegue su contenido en mensajes de soporte.

[Encuentre el significado de cada configuración](https://supastack.dev/es/docs/web/project-structure.md)


## Mantenga el servidor en funcionamiento; usar otra terminal para comandos

El servidor de desarrollo sirve su aplicación mientras trabaja. Deje su terminal abierta cuando un tutorial diga abrir localhost:3000. localhost significa esta computadora; :3000 es el puerto, como una puerta numerada utilizada por la aplicación. Coloque el URL en la barra de direcciones de su navegador, no en el terminal.

Para ejecutar otro comando mientras el servidor está activo, seleccione Terminal → Nueva Terminal en el editor. La nueva terminal es una ventana separada del mismo proyecto. Para detener el servidor, seleccione su terminal y presione Ctrl + C una vez. En Windows, si se le solicita Terminar el trabajo por lotes, escriba Y y presione Entrar. Espere el mensaje normal antes de iniciarlo nuevamente.

Después de editar la configuración del entorno web, detenga y reinicie el servidor web con el siguiente comando. Normalmente, guardar un archivo fuente actualiza la página automáticamente, pero los cambios de entorno requieren un reinicio. Después de editar la configuración de Expo, detenga Expo, luego ejecute corepack pnpm --filter @supastack/mobile start --clear para reiniciar y borrar su paquete almacenado en caché.

```
corepack pnpm --filter @supastack/web dev
```


## Leer un fallo y pedir ayuda útil

Si una instalación devuelve un texto de error rojo, deténgase en ese paso. Lea el primer error en lugar de continuar iniciando la aplicación. El comando no encontrado generalmente significa que falta una herramienta; no package.json normalmente significa la carpeta incorrecta; ECONNREFUSED generalmente significa que un servidor o base de datos requerido no se está ejecutando; EADDRINUSE significa que otro proceso ya utiliza el puerto.

Cuando solicite ayuda, incluya su sistema operativo, la guía URL y el número de paso, el comando exacto que ingresó y el primer mensaje de error. Elimine contraseñas, claves API, tokens y la parte de contraseña de cualquier base de datos URL. No envíe sus archivos .env. Una captura de pantalla del error puede ayudar, pero el texto copiable es más fácil de diagnosticar.

[Solucionar un error de configuración específico](https://supastack.dev/es/docs/web/troubleshooting.md)


## Siguiente

[Deja que un agente lo configure](https://supastack.dev/es/docs/web/agent-setup.md)