QvaPay
Sistema de diseño
Los colores, tamaños y componentes con los que se construye cada pantalla. Todo lo que ves aquí es el componente real, en el tema que tengas activo.
Qué usar
Antes de escribir clases a mano, busca aquí. Si lo que necesitas no está y lo vas a repetir, se convierte en componente.
- Una acción con texto
QPButtonGuardar, Continuar, Cancelar. Colores de relleno para la acción; suaves para un estado. - Una acción de solo icono
IconButtonCerrar, copiar, borrar una fila. Relleno, sobre imagen o flotante según dónde vaya. - Una acción con aspecto de enlace
TextButtonVer todo, Cambiar, Reenviar código, dentro de una frase o al final de una fila. - Elegir entre 2 a 4 opciones
SegmentedPIN / OTP, Comprar / Vender, 7D / 30D / 90D. - Elegir una opción que ocupa una caja
OptionCardMétodo de pago, plan, dirección de envío. - Filtros que se encienden
ChipEstados de una lista, montos rápidos, valores de una variante. - Secciones de una página
TabsResumen / Movimientos / Ganancias. - Una fila entera que se pulsa
RowButtonUn contacto, una sugerencia, una sesión. - Una opción de un menú
MenuOptionReportar, bloquear, un criterio de orden. - Añadir otro elemento a una lista
AddButtonOtra zona de envío, otra categoría. - Ordenar una tabla
SortHeaderLa cabecera de cada columna. - Abrir y cerrar un bloque
DisclosureButtonLa fila de una categoría o de una zona de envío. - Los pasos de un asistente
StepBarRegistro de empresas. - Las diapositivas de un carrusel
CarouselDotsOfertas tras una compra. - Código para copiar
CodeBlockUn comando o una clave en el panel de desarrollo. - Una miniatura que se pulsa
ThumbButtonStickers, fotos de una galería. - Subir un archivo nuevo
UploadZoneImagen de un producto, otra foto de la galería. - Elegir una moneda
QPCoinRowDepósito, retiro y puesto promocionado. - Cambiar una imagen
UploadVeilAvatar, logo de una app. - Un monto de dinero que se escribe
AmountInputEnviar, depositar, retirar, crear una oferta. - Un PIN o un código
PinInput / PinBoxSegundo factor, verificación de teléfono. - Escribir en un chat o un hilo
ComposerChat P2P, moderación, comentarios de una transacción. - Un campo de texto
Field + QPInputCon etiqueta, ayuda y error. PasswordInput para contraseñas. - Una confirmación o un formulario corto con color de aviso
CalloutCancelar un retiro, confirmar una acción de moderación. - Un mensaje que hay que leer
NoticeError de un formulario, advertencia, confirmación. - Un estado
StatusBadgePagado, pendiente, cancelado: color y texto de una sola tabla. - Una valoración
Stars / StarInputMostrar y elegir estrellas. - Un mensaje de chat
ChatBubbleP2P, moderación y asistentes. - Una ventana encima de la página
ModalAtrapa el foco y se cierra con Escape. - Una cifra de dinero
Money / formatUsdSiempre $1,234.50.
Marca
El logo, la paleta y la guía de uso para prensa y partners viven en la página de marca. Aquí está cómo se construye la interfaz con ellos.

Logo principal
A color, sobre fondos claros

Logo blanco
Sobre fondos oscuros, fotos y video
Logos en alta resolución, paleta, tipografía y normas de uso.
Ir a Marca y prensa/brandColor
El morado de marca rellena botones y marca lo activo. El texto de color usa una variante propia que cambia con el tema para llegar siempre a 4,5:1.
Marca
bg-primary
Marca en texto
text-primary
Éxito
bg-success
Aviso
bg-warning
Peligro
bg-danger
Oro
GOLD
Fondo claro
bg-white
Fondo de página
bg-gray-50
Fondo oscuro
dark-background
Superficie oscura
dark-surface
Elevación oscura
dark-elevation
Línea
border-line
Línea de campo
border-line-strong
Texto
Rubik en seis tamaños. Un solo título por página, sin dos puntos al final; la negrita queda para los titulares de las páginas públicas.
Transacciones
Título de página · 24 px · text-2xl font-semibold tracking-tight
Actividad reciente
Título de sección · 14 px · text-sm font-semibold
El retiro llega a tu cuenta en menos de una hora.
Cuerpo · 14 px · text-sm
Hace 5 minutos · USDT TRC20
Meta · 12 px · text-xs
Comisión incluida
Pequeño · 11 px · text-2xs
CONTADOR
Mínimo · 10 px · text-3xs
$12,345.60 · -$80.00 · $0.50
Dinero · Money / formatUsd · cifras alineadas
Radios y líneas
Cuatro radios, uno por nivel. Un botón y el campo de al lado comparten radio y altura.
Insignia · 6 px
rounded-badge
Control · 8 px
rounded-control
Tarjeta · 12 px
rounded-card
Modal · 16 px
rounded-modal
xs 28 · sm 32 · md 40 · lg 48Sombras
Lo que está apoyado en la página lleva línea y ninguna sombra. Lo que flota lleva sombra y no lleva borde.
border border-line
shadow-pop
shadow-modal
Iconos
Una sola variante, la de línea. El estado se marca con color o con otro icono, nunca cambiando a una variante rellena; la única excepción es la estrella llena de una valoración.
…Outlined · size-5size-4 · size-5 · size-6 · text-primary174 de 174 iconos en uso
Botones
Un botón principal por pantalla. El secundario acompaña; el de peligro, solo para lo que no se puede deshacer.
<QPButton color="…" />color="soft | danger-soft | success-soft | warning-soft | ghost"color='overlay' · color={activo ? 'success-soft' : 'secondary'}color="light | glass"size: xs · sm · md · lg · xlicon · loading · disabled · kbd · shape<QPButton href="…">…</QPButton>Otras acciones
Lo que se pulsa y no es un botón con texto: iconos, acciones con aspecto de enlace, conmutadores y chips que se encienden.
<IconButton label="…" size="bare | sm | md | lg" tone="…" /><IconButton variant="solid | overlay" round /><IconButton variant="soft" tone="primary | danger | success | warning" /><IconButton variant="float" round /> · <IconButton active tone /><TextButton tone="primary | danger | success | muted | inherit" size="xs | sm | base | inherit" /><Segmented value onChange options={[…]} size="sm | md" /><OptionCard selected size="sm | md" as="button | label" /><RowButton active /><AddButton size="sm | md | lg" /><MenuOption icon tone="neutral | danger | success" active /><SortHeader active direction /><Stars value /> · <StarInput value onChange /><UploadVeil shape="round | control | card" busy /><DisclosureButton open onClick /><StepBar steps current onStep /><CarouselDots count current onSelect /><UploadZone label onClick onDrop active />USDT
TRC20
$1.00
Precio
Bitcoin
BTC
$97250.40
Precio
<RadioGroup value onChange><QPCoinRow coin mode="topup | withdraw | promo" /></RadioGroup>curl -N https://api.qvapay.com/v2/p2p/stream -H "app-id: …"
<CodeBlock code copiedText /><ThumbButton selected outlined /><Chip active tone="soft | primary | danger" size="xs | sm | md" />Campos
La etiqueta va arriba, la ayuda debajo y el error sustituye a la ayuda. En móvil el texto es de 16 px para que el teléfono no haga zoom.
Te escribiremos aquí.
El monto mínimo es $10.
<PasswordInput /><QPInput size="sm | md | lg" />QPSearchbar · PinInputSwitch · input[type=checkbox]<AmountInput size="md | lg | xl" align="left | center | right" /><PinBox /> · el grupo completo es <PinInput /><Composer tone="default | brand | moderator"><ComposerInput /></Composer>Insignias
Cada estado tiene un solo color en todo el sitio. Sale de una única tabla, así «Procesando» nunca es azul en una pantalla y naranja en otra.
<StatusBadge status="…" /><Badge tone="…" size="sm | md" />Avisos
Un mensaje dentro de la página que hay que leer antes de seguir. Cuatro tonos; el de peligro se anuncia solo a los lectores de pantalla.
Tu retiro está en camino
Correo verificado
Revisa la red antes de enviar
<Notice tone="info | success | warning | danger" title action />
¿Cancelar este retiro? Se devuelve el monto al saldo y no se puede deshacer.
<Callout tone="info | success | warning | danger" as="form" />Tarjetas y datos
La tarjeta agrupa una sola cosa. Dentro, 24 px de relleno; entre tarjetas, 24 px.
Detalles del retiro
Tarjeta con cabecera, icono y estado
- Monto
- $1,250.00
- Recibes
- $1,237.50
- Método
- USDT TRC20
- Dirección
- TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE
Actividad reciente
| Concepto | Fecha | Estado | Monto |
|---|---|---|---|
| Recarga ETECSA | Hoy, 10:42 | Pagado | -$14.49 |
| Depósito USDT | Hoy, 09:15 | Procesando | $250.00 |
| Retiro a tarjeta | Ayer, 18:03 | Pendiente | -$80.00 |
| Oferta P2P | Ayer, 12:30 | Cancelado | -$35.50 |
Lista vacía
Sin transacciones
Cuando envíes, recibas o deposites, lo verás aquí.
Chat
Una sola burbuja para el chat P2P, el de moderación y los asistentes. Las mías van a la derecha en color de marca; las seguidas del mismo autor se pegan por su lado.
<ChatBubble side="in | out" group time /><ChatBubble tail width="full" />Modal
Atrapa el foco, se cierra con Escape y devuelve el foco al botón que lo abrió.
<Modal open onClose title icon footer />Visor de imágenes
Una miniatura se abre a pantalla completa sin salir de la página, y se pasa por todas las de su grupo con las flechas o deslizando. Es el de los adjuntos de soporte, las fotos del chat P2P y los comprobantes.
Páginas públicas
Las landings usan botones más grandes y cifras a gran tamaño; el resto de la escala es la misma.
- Cifra de ejemplo
- 1.234
- Otra cifraCon una línea de detalle.
- $56K
- Tercera cifra
- 78+
Reglas
Lo que no es un componente pero decide cómo se ve una pantalla.
- Un título por página
- Cada pantalla tiene un solo h1, de 24 px en el panel. Sin dos puntos al final, ni en títulos ni en etiquetas.
- Esquinas
- El squircle es solo de botones. Tarjetas, cajas e insignias llevan la esquina circular de su radio.
- Línea o sombra
- Lo apoyado en la página lleva línea y ninguna sombra. Lo que flota lleva sombra y no lleva borde.
- Alturas
- Botones, campos y selectores miden 28, 32, 40 o 48 px. Un botón y el campo de al lado comparten altura y radio.
- Cifras
- El dinero se escribe $1,234.50 y los conteos 1,234. Nunca dos formatos en la misma pantalla.
- Estados
- Cada estado tiene un color y un texto, de una sola tabla. Un estado nunca se enseña con su nombre técnico.
- Iconos
- Una sola variante, la de línea. No se usan emojis ni flechas de texto como icono.
- Color
- El morado marca la acción principal y lo activo. Sin degradados ni elementos que se levanten al pasar el cursor.
- Nada a mano
- Todo lo que se pulsa sale de un componente de esta página. Un patrón que aparece más de dos veces se convierte en componente antes de copiarlo.
- Una forma de elegir
- Entre dos y cuatro opciones excluyentes: conmutador. Una opción que ocupa una caja: tarjeta de opción. Filtros que se encienden: chip. Secciones de una página: pestañas.
- Color por estado
- Un botón que cambia según un estado recibe otro color del componente, nunca clases distintas. El relleno es para la acción; las variantes suaves, para un estado encendido.
- Chat
- Una sola burbuja en todos los chats: las mías a la derecha en color de marca, las de la otra parte en blanco con línea, el moderador en ámbar. La hora, pequeña y atenuada.
- Nombre accesible
- Un botón de solo icono lleva siempre su etiqueta. El foco con teclado se ve en todo lo que se pulsa.
- Excepciones
- Solo queda fuera el botón de compartir una oferta, que lleva el color de cada red. El simulador de mini-apps usa los mismos componentes, con los colores de la mini-app.


