tutorial· 10 min read

Cómo Construir una App React desde un Único Prompt

Aprende a ir de la idea a una app React desplegada usando VULK. Cubre la escritura de prompts, la estructura del proyecto generado, la vista previa en vivo, la iteración y el despliegue con un clic — con datos reales de la plataforma sobre lo que funciona.

João CastroJoão Castro
Cómo Construir una App React desde un Único Prompt

Actualizado el 17 de julio de 2026 — renovado con datos verificados de la plataforma y la alineación de modelos actual.

¿Cómo se construye una app React desde un único prompt?

La respuesta completa: escribe en VULK una descripción específica de la app — layout, páginas, funcionalidades, forma de los datos, colores. El prompt va a uno de los 16+ modelos de IA (Claude Sonnet 5 es el predeterminado; puedes cambiarlo), envuelto en un system prompt de ingeniería que impone una estructura de proyecto React correcta. El modelo transmite un plan y luego genera los archivos uno a uno: un proyecto Vite + React + TypeScript + Tailwind con enrutado, componentes, estado y datos de ejemplo realistas. La app compila server-side y se renderiza en una vista previa en vivo con hot reload en 30–90 segundos. Iteras con prompts de seguimiento y luego haces clic en Deploy para obtener una URL en vivo de Cloudflare Pages.

No tienes que creerte lo de "rápido" por fe: en 11.355 proyectos generados, el tiempo mediano del registro a la primera app funcional es de 47 segundos, el prompt mediano tiene solo 364 caracteres (unas 60 palabras) y la conversación mediana de construcción es de 4 mensajes (datos de la plataforma VULK, julio de 2026). React + Vite es lo que usa el 80,5% de todas las apps de la plataforma. Esta guía cubre cómo hacer que esos 4 mensajes cuenten.

¿Qué ocurre realmente cuando escribes un prompt?

Si nunca has usado un constructor de código con IA, todo esto puede parecer magia o un disparate, según tus expectativas. Déjame desmitificarlo.

Escribes una descripción de la app que quieres. VULK la envía a uno de los 16+ modelos de IA (tú eliges cuál), envuelta en un system prompt cuidadosamente diseñado que enseña al modelo cómo estructurar un proyecto React correcto. El modelo devuelve un plan en streaming y luego genera los archivos uno a uno. VULK compila esos archivos en un servidor remoto y renderiza la app en ejecución en un iframe de vista previa. Todo el proceso tarda de 30 a 90 segundos según la complejidad.

El resultado no es scaffolding. No es boilerplate. Es un proyecto completo con enrutado, componentes, gestión de estado, estilos con Tailwind CSS y datos de ejemplo realistas — listo para previsualizar, iterar y desplegar.

¿Qué hace diferente la salida React de VULK?

Antes de entrar en los prompts, quiero explicar las decisiones técnicas que tomé para la generación React de VULK, porque importan.

Vite, no Create React App. CRA está efectivamente abandonado. Vite es el estándar moderno — builds más rápidos, mejor tree-shaking, soporte nativo de ESM y un build de producción que de verdad optimiza tu código. Todos los proyectos React generados en VULK usan Vite como sistema de build.

TypeScript por defecto. Dos tercios de todo lo generado en la plataforma está tipado: el 65% de los 124.755 archivos de código generados son TypeScript/TSX (datos de la plataforma VULK, julio de 2026). La salida tipada atrapa toda una clase de errores de generación con IA en tiempo de compilación en vez de en runtime.

Tailwind CSS por defecto. CSS utility-first significa que el código generado es portable, personalizable y no depende del sistema de diseño de una biblioteca de componentes. Puedes cambiar cualquier aspecto visual con un prompt de seguimiento.

Estructura de proyecto correcta. VULK no lo vuelca todo en App.tsx. Recibes src/pages/ para los componentes de ruta, src/components/ para UI reutilizable, src/data/ para datos de ejemplo y un tailwind.config.js con el esquema de colores que pediste. El proyecto generado promedio tiene 20,7 archivos y unas 1.500 líneas de código — muchos archivos pequeños y enfocados, no un monolito (datos de la plataforma VULK, julio de 2026).

Dependencias de nivel de producción. React Router para el enrutado, Recharts para gráficos, Lucide React para iconos. No son bibliotecas de juguete. Son lo que los desarrolladores React profesionales usan de verdad.

¿Cómo se escribe un prompt que funcione?

La calidad de tu prompt determina directamente la calidad de la salida. A estas alturas he visto miles de proyectos generados, y el patrón es claro: los prompts específicos producen buenas apps, los vagos producen apps genéricas.

Prompt malo:

Constrúyeme un gestor de tareas.

Esto le da al modelo casi nada con que trabajar. Recibirás una lista de tareas genérica con colores predeterminados.

Prompt bueno:

Construye una app de gestión de tareas con navegación lateral oscura, una vista de tablero Kanban con columnas drag-and-drop (Por Hacer, En Progreso, Hecho), tarjetas de tarea con título, avatar del asignado, badge de prioridad y fecha límite. Usa un tema oscuro con acentos morados. Incluye una barra de búsqueda superior y un modal "Nueva Tarea".

Esto especifica el layout (sidebar + contenido principal), la funcionalidad principal (tablero Kanban), la forma de los datos (título, asignado, prioridad, fecha límite), los patrones de interacción (drag-and-drop, modal) y el estilo visual (tema oscuro, morado).

Prompt avanzado:

Construye un tracker de finanzas personales con tres páginas: Dashboard, Transacciones y Ajustes. El Dashboard muestra el saldo total, un gráfico de barras de ingresos vs gastos (usa Recharts) y las transacciones recientes. La página de Transacciones tiene una tabla de datos filtrable con columnas para fecha, descripción, categoría, importe y tipo. Incluye un modal "Añadir Transacción". Ajustes tiene un formulario de perfil y gestión de categorías. Tema blanco con verde para ingresos y rojo para gastos. Navegación lateral con iconos.

Esto define la estructura de páginas, la biblioteca de gráficos, el esquema de datos y la semántica de colores. VULK genera una app React Router multipágina con todo conectado.

Una calibración útil: el prompt mediano exitoso en la plataforma tiene ~60 palabras — un párrafo corto y específico, no un documento de especificación (datos de la plataforma VULK, julio de 2026). Cubre layout, funcionalidades, datos y estilo, y para.

¿Cómo es el proceso de generación?

Cuando envías tu prompt, esto es lo que ves:

Primero aparece un plan — una lista numerada de los pasos que la IA ejecutará. No es solo decorativo. El plan mantiene la generación organizada y evita que el modelo pierda el hilo de la arquitectura a mitad de camino.

Luego los archivos empiezan a generarse uno a uno. Puedes verlos aparecer en tiempo real en el árbol de archivos del lado izquierdo del editor.

Un proyecto típico incluye:

  • index.html — Punto de entrada con meta tags e imports de fuentes
  • src/main.tsx — Raíz React con StrictMode y BrowserRouter
  • src/App.tsx — Componente superior con las definiciones de rutas
  • src/pages/ — Un componente por página
  • src/components/ — Componentes de UI reutilizables
  • src/data/ — Datos de ejemplo con contenido realista
  • tailwind.config.js — Tema personalizado según los colores pedidos
  • package.json — Dependencias

¿Cómo funciona la vista previa en vivo?

A medida que los archivos se generan, el panel de vista previa se actualiza automáticamente. No necesitas esperar a que termine la generación. La vista previa corre server-side en una micro-VM aislada — es la aplicación compilada real con hot reload, no una captura o maqueta. Como la compilación ocurre en el servidor, funciona en todos los navegadores y dispositivos, incluyendo Safari y móvil.

La vista previa es totalmente interactiva. Haz clic en botones, navega entre páginas, rellena formularios, prueba el comportamiento responsivo. Úsala para identificar qué necesita cambiar antes de escribir tu siguiente prompt.

¿Cómo se itera con prompts de seguimiento?

La primera generación rara vez es perfecta, y eso es intencionado. VULK está construido para el refinamiento iterativo. Tras revisar la vista previa, envía mensajes de seguimiento dirigidos:

Añade un interruptor de modo oscuro a la página de Ajustes. Persiste la preferencia en localStorage.

Sustituye el gráfico de barras del Dashboard por uno de líneas. Añade un selector de rango de fechas con opciones de 7, 30 y 90 días.

La sidebar debe colapsar a solo iconos en pantallas por debajo de 768px. Añade un botón de menú hamburguesa.

Cada seguimiento genera solo los archivos que necesitan cambiar. VULK hace ediciones quirúrgicas, preservando todo lo demás. Esto es importante — no estás regenerando el proyecto entero con cada mensaje.

También puedes arreglar bugs:

El modal no se cierra cuando hago clic fuera de él. Añade un handler de clic en el overlay.

O pedir funcionalidades nuevas:

Añade exportación CSV a la página de Transacciones. Descarga todas las filas visibles como archivo .csv.

La mitad de todas las apps de la plataforma son esencialmente "un disparo más un retoque" (mediana de 4 mensajes), pero los proyectos en los que la gente invierte superan los 25 mensajes — el bucle de iteración es donde se hacen las buenas apps (datos de la plataforma VULK, julio de 2026).

¿Puedes editar el código directamente?

La barra lateral izquierda muestra todos los archivos de tu proyecto. Haz clic en cualquier archivo para ver y editar su código fuente directamente. Este enfoque híbrido — generación con IA más retoques manuales — suele ser la forma más rápida de conseguir exactamente lo que quieres.

Construí VULK así intencionadamente. No es una caja negra. El código es React estándar, TypeScript estándar, Tailwind estándar. Si sabes React, puedes leer, entender y modificar todo lo que la IA produce. Y si aún no sabes React, el código generado es un recurso de aprendizaje genuinamente útil porque sigue patrones del mundo real.

¿Cómo se despliega a producción?

Cuando tu app se vea bien, desplegar lleva un clic. Pulsa el botón Deploy en la barra de herramientas. VULK compila tu app vía Vite, sube la salida estática a Cloudflare Pages y te da una URL en vivo.

La app desplegada corre en la CDN global de Cloudflare — más de 300 ubicaciones edge. El formato de la URL es nombre-de-tu-proyecto.pages.dev, y puedes conectar un dominio personalizado más adelante (Pro+).

El redespliegue funciona igual. Haces cambios, clicas en Deploy, la nueva versión está en vivo en segundos.

Una estadística honesta de toda la plataforma: solo el 3,7% de las apps generadas se despliegan a una URL pública (datos de la plataforma VULK, julio de 2026). Generar ya no es la parte difícil — terminar lo es. Si tu app funciona en la vista previa, haz clic en Deploy; solo con eso estarás en el pequeño porcentaje superior de constructores.

¿Qué patrones de prompt funcionan de forma consistente?

Tras observar miles de generaciones, ciertos patrones siempre producen mejores resultados:

Especifica la estructura del layout. "Navegación lateral a la izquierda, contenido principal a la derecha" le da al modelo un marco claro.

Nombra tus páginas explícitamente. "Tres páginas: Inicio, Productos y Carrito" se convierte en definiciones de rutas y elementos de navegación.

Describe la forma de los datos. "Cada producto tiene nombre, precio, URL de imagen, categoría y stock" le dice al modelo exactamente qué campos incluir en componentes y formularios.

Referencia bibliotecas específicas. "Usa Recharts para los gráficos" o "Usa Framer Motion para las transiciones de página" controla las elecciones de dependencias.

Indica el esquema de colores. "Tema oscuro con acentos cian" evita los temas azules predeterminados que de todas formas querrás cambiar.

¿Qué no puedes hacer (todavía)?

Si tu app necesita un backend real con base de datos, puedes activar el Backend Mode, que genera una API respaldada por PostgreSQL junto a tu frontend — el 62% de todas las apps generadas incluye un esquema SQL, y el 27% corre un backend aprovisionado (datos de la plataforma VULK, julio de 2026). El backend corre en la infraestructura de VULK — aún no puedes desplegarlo en tu propio servidor. La autenticación usa el sistema de auth integrado de VULK. Los proveedores de auth externos (Firebase, Auth0, Supabase) no se generan por defecto — aunque en Pro+ puedes optar por conectar tu propio Supabase vía el sistema de integraciones.

Estas son limitaciones reales y quiero ser franco con ellas. Estamos trabajando en el despliegue de backend autoalojado, pero no está listo.


FAQ

¿Cuánto tarda construir una app React con VULK?

La generación tarda 30–90 segundos; el usuario mediano va del registro a la primera app funcional en 47 segundos, y la mitad de todas las apps se terminan en una conversación de 4 mensajes (datos de la plataforma VULK, julio de 2026). Presupuesta una sesión de trabajo para ir de la idea a una app iterada y desplegada.

¿Qué modelo de IA debería elegir para la generación React?

El predeterminado (Claude Sonnet 5) es el mejor todoterreno para React. Usa un modelo fuerte en razonamiento para lógica de backend compleja y uno rápido para pequeños retoques de UI. Puedes cambiar de modelo por mensaje — y en Pro+ puedes traer tus propias claves de API (BYOM).

¿El código generado es realmente mío?

Sí. Es un proyecto Vite + React + TypeScript + Tailwind estándar sin dependencias propietarias. Descarga el ZIP completo (Builder+) o súbelo a GitHub (Pro+), ejecuta npm install && npm run dev, y funciona en cualquier sitio. Las apps solo de frontend son totalmente portables; las que usan el backend de VULK siguen llamándolo por HTTPS.

¿Necesito saber React para usar VULK?

No — el prompt es lenguaje llano y la vista previa te muestra la app corriendo. Saber React te ayuda a hacer retoques manuales y revisar la salida, pero el código generado sigue patrones estándar de todos modos.

¿VULK tiene free tier?

No. VULK es solo de pago: Builder $19.99/mes, Pro $39.99/mes, Max $199/mes, con un intro de 3 días de acceso completo desde $3.99 que se acredita a tu primer mes si continúas. Todos los planes incluyen los 16+ modelos.

¿El mismo flujo de prompts construye apps móviles o PHP?

Sí — VULK enruta según el prompt. Los prompts con lenguaje móvil generan Flutter (con vista previa de build en vivo y exportación APK/AAB), los prompts PHP/Laravel reciben una vista previa en vivo real con PHP 8.3, y los backends Python corren en su propio runtime de vista previa. React + Vite sigue siendo el predeterminado y el camino más pulido (80,5% de todas las apps).


El ciclo es simple: escribe un prompt específico, revisa la vista previa, itera con seguimientos, despliega. Cuanto más específico sea tu prompt inicial, menos iteraciones necesitas. Empieza en vulk.dev.

Publicado por João Castro · 10 min read

Soporte VULK

En línea

¡Hola! ¿Cómo puedo ayudarte hoy?

Temas populares

Soporte con IA • support.vulk.dev

Cómo Construir una App React desde un Único Prompt — Blog | VULK