> ## 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.

# Primeros pasos

> Instala el CLI, obtén tu token de acceso y levanta un tema sobre una tienda de desarrollo.

<Steps>
  <Step title="Instala el CLI">
    Descarga el binario `riqra-theme` para tu sistema desde los [GitHub Releases de riqra/theme-cli](https://github.com/riqra/theme-cli/releases) y colócalo en tu `PATH`.

    ```bash theme={null}
    riqra-theme --version
    ```
  </Step>

  <Step title="Pide una tienda de desarrollo y un token">
    Tu contacto en Riqra crea una tienda de desarrollo para el proyecto y emite un **token de acceso de tema** (empieza con `riqthm_`). El token queda ligado a esa tienda: define contra qué tienda trabajan `dev`, `push` y `pull`.

    El secreto se muestra una sola vez al emitirse — guárdalo en un gestor de secretos. Si se pierde o se filtra, Riqra lo revoca y emite uno nuevo.
  </Step>

  <Step title="Inicia sesión">
    ```bash theme={null}
    riqra-theme login
    ```

    Valida el token contra la API y lo guarda en `~/.riqra/credentials.json`. En CI puedes omitir `login` y exportar `RIQRA_THEME_TOKEN` en su lugar.

    ```text theme={null}
    Logged in to https://api.riqra.com
      Organization: Acme Foods
      Storefront:   acme.riqra.site
      Token:        Agencia Acme (expires never)
    ```
  </Step>

  <Step title="Crea el tema">
    ```bash theme={null}
    riqra-theme init mi-tema
    cd mi-tema
    ```

    Genera un tema funcional a partir del esqueleto de Origin (el tema base de Riqra). Funciona sin conexión. Valídalo de inmediato:

    ```bash theme={null}
    riqra-theme check
    ```
  </Step>

  <Step title="Desarrolla en vivo">
    ```bash theme={null}
    riqra-theme dev
    ```

    Sube un borrador a tu tienda de desarrollo, imprime la URL de vista previa y re-sube en cada guardado; la página de vista previa se recarga sola. Ctrl-C para salir.
  </Step>
</Steps>

## Siguientes pasos

* [Ciclo de desarrollo](/temas/ciclo-de-desarrollo) — `dev`, `push`, `riqra.theme.json` y la entrega a producción.
* [Referencia del CLI](/temas/referencia-cli) — todos los comandos y sus opciones.