Fundamentos
Glosario (sin tecnicismos)
Las palabras que vas a oír todo el curso, explicadas en simple.
Vas a ver estas palabras en todos lados. No necesitas memorizarlas: vuelve aquí cuando alguna te suene a chino. Cada una trae una analogía para que se te quede.
Regla de oro
Si en un tutorial aparece una palabra que no entiendes, búscala aquí. Si no está, pídesela a Cursor: “explícame qué es X como si nunca hubiera programado”. Y cuando en las docs veas una palabra con subrayado punteado — como este repo —, pásale el mouse encima: es un atajo a este glosario.
Lo básico
Repo (repositorio)
La carpeta con todo el código de tu producto. Analogía: la carpeta maestra de tu proyecto.
GitHub
Un sitio web donde vive tu repo en la nube. Analogía: Google Drive, pero para código.
Terminal
Una ventana donde escribes órdenes con texto. Analogía: mandarle instrucciones a la compu por escrito.
Comando
Una orden que escribes en la terminal. Analogía: “prende la luz”, pero para la compu.
Cursor
El editor donde construyes, con IA integrada. Analogía: tu mesa de trabajo con un asistente al lado.
CLI
Un programa que se maneja escribiendo comandos en la terminal (ej. Supabase CLI). Analogía: el control remoto por texto de un servicio.
Prompt
La instrucción que le escribes a la IA para que haga algo. Analogía: el brief que le das a un empleado nuevo.
Placeholder
Un texto de relleno que debes cambiar por tu valor real (ej. <tu-project-ref>). Analogía: el “Fulano de Tal” de un contrato de ejemplo.
localhost:3000
Tu proyecto corriendo en tu compu, aún no público. Analogía: un ensayo a puerta cerrada antes del estreno.
Dashboard
El panel de control web de un servicio (Supabase, Vercel, Stripe…), donde configuras todo con clicks. Analogía: el tablero del carro: todo a la vista y al alcance.
Guardar y publicar
Fork
Tu propia copia de un repo ajeno, para trabajarla sin tocar el original. Analogía: fotocopiar un libro para rayarlo sin dañar el original.
Commit
Un “punto de guardado” de tus cambios. Analogía: guardar partida en un videojuego.
Push
Subir tus cambios guardados a GitHub. Analogía: sincronizar tu Drive.
Rama (branch)
Una copia paralela para experimentar sin romper lo bueno. Analogía: un borrador aparte del documento final.
Deploy
Publicar tu proyecto para que el mundo lo vea. Analogía: estrenar la obra, ya con público.
Vercel
El servicio que publica tu web y le da una URL. Analogía: la sala de cine donde se estrena.
Dominio
El nombre de tu sitio en internet (ej. tuproducto.com). Analogía: la dirección de tu local en la ciudad.
DNS
El sistema que traduce tu dominio a la dirección real del servidor. Analogía: la agenda de contactos: del nombre al número de teléfono.
Las piezas del producto
Frontend
Lo que el usuario ve y toca (la pantalla). Analogía: el salón de un restaurante.
Backend
La lógica y los datos, detrás de cámaras. Analogía: la cocina del restaurante.
Base de datos
Donde se guarda la información (usuarios, items…). Analogía: un archivero ordenado.
Supabase
La base de datos + login que trae VibeFast. Analogía: el archivero + el portero.
Schema
El plano de tu base de datos: qué tablas hay y qué guarda cada una. Analogía: el plano de los cajones y etiquetas del archivero.
Migración (de base de datos)
Un archivo con instrucciones para crear o cambiar tablas de tu base de datos. Analogía: la lista de reformas para remodelar el archivero.
SQL
El idioma para pedirle cosas a una base de datos. Tu IA lo escribe por ti. Analogía: el idioma oficial del archivero.
CRUD
Las 4 operaciones básicas sobre datos: crear, leer, editar y borrar registros. Analogía: meter, consultar, corregir y tirar fichas del archivero.
RLS (Row Level Security)
Reglas de Supabase para que cada usuario solo vea y toque sus propios datos. Analogía: cada quien tiene llave solo de su casillero.
API
La forma en que dos programas se hablan. Analogía: el mesero que lleva pedidos entre salón y cocina.
Webhook
Un aviso automático que otro servicio le manda a tu app cuando pasa algo (ej. un pago). Analogía: el timbre: te avisan al momento, sin estar preguntando.
OAuth
Entrar con una cuenta que ya tienes (“Continuar con Google”) sin crear otra contraseña. Analogía: entrar a un club mostrando la credencial de otro club de confianza.
Provider (de login)
Cada servicio con el que tus usuarios pueden entrar a tu app (Google, GitHub…). Analogía: las credenciales que acepta la puerta del club.
Callback URL
La dirección de regreso: a dónde te devuelve un servicio cuando termina un proceso (ej. el login con Google). Analogía: la dirección de retorno escrita en el sobre.
Scope
Los permisos concretos que tu app le pide a un servicio en nombre del usuario (ej. “ver tu email”). Analogía: la lista de habitaciones a las que la visita puede pasar.
Checkout
La pantalla de pago donde el usuario pone su tarjeta (en el curso, esa pantalla la pone Stripe). Analogía: la caja del supermercado.
API key
Una contraseña secreta para usar un servicio (ej. OpenAI). Analogía: la llave de tu casa: no la regales.
Variable de entorno
Un dato secreto o de config que vive en .env.local. Analogía: la caja fuerte de las llaves.
Del código
Framework
Una base con piezas listas para construir más rápido. Analogía: un kit de casa prefabricada.
Next.js
El framework de web que usa VibeFast. Analogía: el kit específico que elegimos.
Paquete (dependencia)
Código de terceros que tu proyecto reutiliza. Analogía: un ingrediente comprado, no hecho a mano.
yarn install
El comando que baja todos esos ingredientes. Analogía: ir al súper por la lista de la receta.
Ruta
La dirección de una página dentro de tu app (ej. /dashboard); en Next.js, cada carpeta con page.js dentro de web/app es una. Analogía: el número de habitación dentro del edificio.
Endpoint
Una dirección del backend que hace algo (ej. /api/waitlist). Analogía: una ventanilla específica de un banco.
Monorepo
Un solo repo que contiene varias partes del proyecto (ej. web/ y firmware/). Analogía: un edificio con varios departamentos bajo el mismo techo.
SDK
El paquete oficial de un servicio para usarlo desde tu código (ej. el SDK de Stripe). Analogía: el kit de conexión oficial que te da la marca.
De la IA
MCP
Un estándar para conectar la IA con herramientas y datos externos. Analogía: el enchufe universal entre la IA y tus apps.
RAG
Técnica donde la IA primero busca en tus documentos y responde con esa información. Analogía: un examen a libro abierto en vez de contestar de memoria.
Embedding
Una lista de números que representa el significado de un texto, para buscar por parecido. Analogía: la huella digital del significado de una frase.
No tienes que saberlas todas hoy
Con entender repo, terminal, commit, push, deploy y API key ya arrancas. El resto se pega solo con la práctica.