Empieza aquí
Prepara tu compu (Mac / Windows)
Lo que necesitas instalar según tu equipo, antes de tocar el repo.
Antes de clonar VibeFast necesitas 5 programas en tu compu. Los pasos cambian entre Mac y Windows — ve directo a tu sección. Al final los dos caminos se juntan.
Los 5 programas (en ambos)
- Node (motor que corre el proyecto) · 2. yarn (baja las dependencias) · 3. Git (guarda y publica) · 4. Supabase CLI (sube tu base de datos) · 5. Cursor (el editor con IA). El navegador Chrome también ayuda.
🍎 En Mac
1. La terminal (ya la tienes)
Búscala con Cmd + Espacio, escribe Terminal y Enter. Es la app negra de comandos.
2. Homebrew (el gestor de paquetes de Mac)
Homebrew instala programas desde la terminal con un solo comando. Pega esto y sigue las instrucciones (te va a pedir tu contraseña de Mac):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"Al terminar, si te dice "add Homebrew to your PATH" con unos comandos, cópialos y córrelos tal cual. Verifica con brew --version.
¿No quieres usar Homebrew?
Puedes instalar Node con el instalador LTS de nodejs.org (.pkg) y saltarte este paso. Pero Homebrew te facilita instalar (y actualizar) todo lo demás.
3. Node
Con Homebrew:
brew install node(O el instalador LTS de nodejs.org si no usas brew.) Verifica con node -v.
4. yarn
npm install -g yarn¿Dice 'permission denied' / EACCES?
Es por permisos. Reintenta con sudo:
sudo npm install -g yarnTe va a pedir la contraseña de tu Mac. No se ve nada mientras la escribes (ni puntitos) — es normal por seguridad. Escríbela completa y dale Enter. (Alternativa sin sudo: brew install yarn.)
5. Git
Con Homebrew: brew install git. (Mac también lo ofrece vía Command Line Tools: corre git --version y acepta el botón que aparece, o xcode-select --install.)
6. Supabase CLI
Es la herramienta que sube tu base de datos a Supabase desde la terminal:
npm install -g supabase(Alternativa con Homebrew: brew install supabase/tap/supabase.) Verifica con supabase --version.
7. Cursor
Descarga desde cursor.com, abre el .dmg y arrastra Cursor a Aplicaciones.
🪟 En Windows
1. La terminal
Abre el menú Inicio, escribe Terminal (o PowerShell) y ábrelo. Es la ventana de comandos.
2. Node (versión LTS)
Descarga el instalador LTS desde nodejs.org (archivo .msi), ábrelo y dale siguiente. Deja marcada la casilla que dice "Add to PATH" (viene marcada por defecto).
Reinicia la terminal
En Windows, después de instalar algo, cierra y vuelve a abrir la terminal para que reconozca el comando nuevo.
3. yarn
En PowerShell:
npm install -g yarn¿PowerShell no deja ejecutar scripts?
Si al correr yarn (o npm) sale algo como "running scripts is disabled on this system" / "no se puede cargar el archivo yarn.ps1", corre una vez esto en PowerShell y responde S (o Y):
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSignedLuego cierra y reabre la terminal y reintenta.
4. Git
Descarga desde git-scm.com, abre el instalador y acepta todas las opciones por defecto (dale siguiente hasta el final). Esto también instala Git Bash, otra terminal útil.
5. Supabase CLI
Es la herramienta que sube tu base de datos a Supabase desde la terminal. En PowerShell:
npm install -g supabaseVerifica con supabase --version (recuerda: cierra y reabre la terminal si no lo reconoce).
6. Cursor
Descarga el .exe desde cursor.com y ejecútalo. Sigue el instalador.
🪪 Configura tu identidad de Git (Mac y Windows)
Ya con Git instalado, dile quién eres — cada guardado (commit) queda firmado con tu nombre y correo, y sin esto el primer commit falla. Se hace una sola vez. Corre estos dos comandos cambiando el nombre y el correo por los tuyos:
git config --global user.name "Tu Nombre"
git config --global user.email "tu-correo@ejemplo.com"Usa el MISMO correo que en GitHub
Si el correo no coincide con el de tu cuenta de GitHub, tus commits no se te acreditan (no aparecen con tu foto en el historial). Usa el correo con el que entras a GitHub.
Verifica que quedó — debe mostrar tu nombre y correo:
git config --global --list¿Y las llaves SSH? No las necesitas
Quizá leíste por ahí que hay que configurar SSH para GitHub. Para este curso no hace falta: clonas por HTTPS y Cursor te pedirá iniciar sesión con GitHub una sola vez al publicar. Con tu nombre y correo configurados, ya estás.
✅ Verifica (Mac y Windows)
Cierra y abre la terminal, y corre estos cuatro. Deberías ver un número de versión en cada uno:
node --version
yarn --version
git --version
supabase --versionSi un comando dice 'command not found' / 'no se reconoce'
Significa que ese programa no quedó instalado o la terminal no lo ve. En Windows, casi siempre se arregla cerrando y reabriendo la terminal. Si sigue, reinstala ese programa (en Windows, verifica "Add to PATH"). O pega el error en Cursor y pide ayuda — ver Leer errores sin pánico.
✅ Tienes Node, yarn, Git, Supabase CLI y Cursor instalados.
✅ Los cuatro --version responden con un número.
✅ git config --global --list muestra tu nombre y tu correo (el mismo de GitHub).
✅ Sabes abrir tu terminal (Terminal en Mac, Terminal/PowerShell en Windows).
Ya con tu compu lista, sigue en orden: crea tus cuentas → deja tu proyecto de Supabase listo → y arranca el proyecto con el Quick start.