> ## Documentation Index
> Fetch the complete documentation index at: https://docs.puente.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Guía rápida

> Construye tu primer flujo end-to-end en 5 minutos.

Esta guía te lleva de cero a tener un flujo funcionando: una Database con datos, una App que los muestra y un Workflow que reacciona cuando algo cambia.

<Note>
  Para seguir esta guía necesitas una cuenta activa en Puente OS y haber sido invitado a un workspace. Si todavía no tienes acceso, escribe a [octavio@puente.xyz](mailto:octavio@puente.xyz).
</Note>

## Paso 1 — Crear un Project

<Steps>
  <Step title="Abre Puente Menu">
    Al iniciar sesión llegas a la vista **Home** del menú, donde se listan los Projects del Team.
  </Step>

  <Step title="Crea un Project nuevo">
    Haz click en **+ Nuevo Project**, asígnalo a un Team (ej. Operaciones), ponle un nombre claro como "Demo onboarding" y guarda.
  </Step>

  <Step title="Entra al Project">
    Click en la tarjeta del Project. Verás dos pestañas: **Tasks** (Kanban) y **Componentes** (Apps, Databases, Workflows, Agents).
  </Step>
</Steps>

<Tip>
  Cualquier Build que crees dentro de este Project va a quedar agrupado aquí. Puedes verlos después filtrando por Project desde el panel de Componentes.
</Tip>

***

## Paso 2 — Crear tu primera Database

<Steps>
  <Step title="Abre Tables">
    En el panel de Componentes del Project haz click en **+ Nuevo** y elige **Database**. El editor visual se llama Tables.
  </Step>

  <Step title="Define el schema">
    Ponle nombre (`pedidos`) y agrega 4 columnas:

    | Columna   | Tipo                                      |
    | --------- | ----------------------------------------- |
    | `cliente` | Texto                                     |
    | `monto`   | Número                                    |
    | `estado`  | Select (`pendiente`, `pagado`, `enviado`) |
    | `fecha`   | Fecha                                     |
  </Step>

  <Step title="Agrega filas">
    Haz click en **+ Fila** y agrega 3-5 pedidos de prueba. También puedes importar un CSV con el botón **Importar**.
  </Step>
</Steps>

<Card title="Más opciones en Databases" icon="table" href="/componentes/databases">
  Tipos de columna avanzados, filtros, ordenamiento y asistente IA.
</Card>

***

## Paso 3 — Construir una App conectada

<Steps>
  <Step title="Abre App Builder">
    En el panel de Componentes haz click en **+ Nuevo** y elige **App**.
  </Step>

  <Step title="Describe tu app">
    En el textarea escribe:

    > "Una vista de pedidos con tabla principal, filtros por estado y un panel lateral que muestre el detalle al hacer click en una fila."

    Click en el botón de enviar o presiona `Enter`.
  </Step>

  <Step title="Conecta la Database">
    En el panel **Datos**, selecciona la Database `pedidos` que creaste en el paso 2. La preview se actualiza con tus datos reales.
  </Step>

  <Step title="Publica">
    Click en **Compartir** y copia el link. Cualquiera con acceso al workspace ya puede usar la app.
  </Step>
</Steps>

***

## Paso 4 — Automatizar con un Workflow

<Steps>
  <Step title="Abre Workflows">
    Click en **+ Nuevo** > **Workflow** dentro del Project.
  </Step>

  <Step title="Define el trigger">
    Elige el trigger **"Fila modificada en Database"** y selecciona la Database `pedidos`. Filtra por `estado = pagado`.
  </Step>

  <Step title="Agrega un nodo de acción">
    Conecta un nodo **Email** que envíe una confirmación al cliente cuando el estado cambie a `pagado`. Usa variables como `{{ trigger.cliente }}` y `{{ trigger.monto }}` en el cuerpo.
  </Step>

  <Step title="Guarda y activa">
    Click en **Guardar** y luego en **Activar**. Cambia el estado de un pedido en la Database y revisa que llegue el email.
  </Step>
</Steps>

<Card title="Sintaxis de variables" icon="code" href="/componentes/workflows#sistema-de-variables">
  Todo lo que necesitas saber sobre el sistema `{{ }}` para pasar datos entre nodos.
</Card>

***

## Listo. ¿Qué sigue?

Ya construiste un flujo básico end-to-end. Algunas direcciones lógicas para profundizar:

<CardGroup cols={2}>
  <Card title="Agregar un Agent" icon="robot" href="/componentes/agents">
    Embebe un chatbot que responda dudas de los clientes sobre sus pedidos.
  </Card>

  <Card title="Tasks del Project" icon="list-check" href="/componentes/workspace">
    Crea Tasks en formato Kanban para coordinar al equipo dentro del mismo Project.
  </Card>

  <Card title="Conceptos básicos" icon="book" href="/essentials/conceptos">
    Si quieres entender el modelo mental detrás de Puente OS antes de seguir.
  </Card>

  <Card title="Glosario" icon="book" href="/essentials/glosario">
    Diccionario de los términos canónicos de Puente OS.
  </Card>
</CardGroup>