# Bloques

> Pantallas de interfaz de escritorio en Python listas para copiar: login, dashboard, ajustes, tabla de datos, chat, IDE, asistente de bienvenida, reproductor de música y kanban, con componentes de Pyzed.

Source: https://albakore.github.io/pyzed/es/blocks/

Los bloques son **pantallas completas** hechas con los [componentes](https://albakore.github.io/pyzed/es/library/) de Pyzed, en la
línea de los blocks de shadcn/ui: abre uno, ejecútalo, copia el código en tu app y cambia lo que necesites. Cada
bloque es un único archivo ejecutable en
[`examples/blocks/`](https://github.com/albakore/pyzed/tree/main/examples/blocks), probado en CI con tema claro y
oscuro, así que el código de estas páginas siempre funciona con el Pyzed actual.

## Cómo usar un bloque

1. Abre su página y mira la captura en claro y oscuro (cambia el tema del sitio).
2. Ejecútalo: `python examples/blocks/<nombre>.py`, o copia la sección **Código** en un archivo.
3. Quédate con lo que necesites. Los bloques son clases `pz.App` normales: sus piezas son métodos (`sidebar()`,
   `header()`...) que devuelven widgets, así que puedes llevar uno a tu app tal cual.

## Hazlos tuyos

- **Tema.** Pon `theme = "Gruvbox Dark"` (o cualquier [tema](https://albakore.github.io/pyzed/es/theming/themes/)) en la app, o crea uno con
  el color de tu marca: `pz.themes.get("One Dark").with_accent("#e11d48")`. Todos los bloques usan tokens del tema
  (`"accent"`, `"panel"`, `"text_muted"`...), nunca colores fijos para sus superficies.
- **Datos.** Los datos de ejemplo están al principio de cada archivo. Cámbialos por una consulta a la base de datos,
  una llamada HTTP o archivos; el trabajo lento va en una corrutina para que la ventana nunca se bloquee (mira
  [Async](https://albakore.github.io/pyzed/es/guides/async/)).
- **Componentes.** Cuando una pieza tenga estado propio, conviértela en un
  [`pz.Component`](https://albakore.github.io/pyzed/es/guides/components/) para que también aparezca en la caja de herramientas de Pyzed Design.
- **IA.** Con el [servidor MCP](https://albakore.github.io/pyzed/es/ai/mcp/) conectado, pide a tu agente: *"Parte del bloque de dashboard y
  haz que muestre nuestros issues de GitHub"*. Puede leer cada bloque con `read_example("blocks/dashboard")`.