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

# Introducción

> Qué es un tema de Riqra y cómo se reparte el trabajo entre la agencia, Riqra y el comerciante.

Un tema define la cara de una tienda online de Riqra: un árbol de archivos Liquid + JSON que la plataforma valida al subirse, almacena e interpreta en el servidor en cada request. No compilas ni despliegas código — el tema es datos subidos y la plataforma es quien lo ejecuta.

Si vienes de Shopify, la gramática te va a resultar familiar a propósito: secciones OS 2.0 con `{% schema %}`, plantillas JSON, `settings_schema.json`, snippets con `{% render %}`. Las diferencias deliberadas están documentadas en [Viniendo de Shopify](/temas/viniendo-de-shopify).

## El modelo

1. La agencia escribe el tema: secciones (`sections/*.liquid`), snippets, plantillas JSON, configuración y assets. [Anatomía de un tema](/temas/anatomia-de-un-tema) describe el árbol completo.
2. Lo valida localmente (`riqra-theme check`) y lo sube (`riqra-theme push`) con el CLI, autenticada con un token de acceso.
3. La plataforma ejecuta la misma validación en el servidor, guarda los archivos e interpreta el Liquid en cada visita.
4. El comerciante personaliza el tema desde el personalizador del panel: settings globales y secciones por página. Esa personalización vive en la base de datos — una re-subida del tema nunca la pisa.

## Estados de un tema en una tienda

Una tienda puede tener varios temas instalados, con exactamente uno publicado:

| Estado           | Qué significa                                                                                                                           |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Publicado**    | El tema en vivo: lo ven los compradores y es el que edita el personalizador.                                                            |
| **No publicado** | Instalado en la biblioteca de la tienda con su propia personalización guardada. Activarlo lo vuelve el publicado (intercambio atómico). |
| **Desarrollo**   | Borrador temporal creado por `riqra-theme dev`, visible solo con su URL de vista previa. Expira a los 7 días.                           |

## Quién hace qué

| Rol               | Responsabilidad                                                                                                  |
| ----------------- | ---------------------------------------------------------------------------------------------------------------- |
| **Agencia**       | Desarrolla el tema, lo valida, lo sube y lo itera con el CLI.                                                    |
| **Riqra (staff)** | Emite y revoca los tokens de acceso, prepara la tienda de desarrollo e instala el tema en la tienda del cliente. |
| **Comerciante**   | Personaliza el tema instalado y lo publica.                                                                      |

Subir un tema nunca cambia lo que ven los compradores: la activación es siempre un acto humano en el panel. El detalle del flujo está en [Ciclo de desarrollo](/temas/ciclo-de-desarrollo).

## Siguientes pasos

* [Primeros pasos](/temas/primeros-pasos) — instala el CLI y levanta tu primer tema.
* [Secciones y schema](/temas/secciones-y-schema) — la gramática de `{% schema %}` completa.