---
title: Comenzando con Thally
description: Configura Thally y crea tu primera página de documentación en menos de cinco minutos.
url: https://docs.thally.io/es/guides/getting-started
---

# Comenzando con Thally

Configura Thally y crea tu primera página de documentación en menos de cinco minutos.

## Requisitos previos

- **Node.js 22+** y npm (o pnpm/yarn)
- Una terminal y un editor de código
- Una especificación OpenAPI (opcional — se incluye un ejemplo de JSONPlaceholder)

![Horizonte de la ciudad de noche](/images/image3.jpg)

#### Crea tu proyecto

Usa la CLI (recomendado):

```bash
npx create-thally-docs my-docs
```

La CLI te guía a través de una configuración interactiva:

- **Nombre del proyecto** — se muestra en el encabezado y los metadatos
- **Descripción** — se usa para SEO y etiquetas OpenGraph
- **Preset de marca** — `primary` (verde) o `secondary` (morado)
- **URL del repositorio de GitHub** — conecta automáticamente los enlaces de Soporte y GitHub
- **Instalar dependencias** — ejecuta `npm install` por ti

También puedes omitir las preguntas y aceptar todos los valores predeterminados:

```bash
npx create-thally-docs my-docs --yes
```

La CLI descarga la versión inicial inmutable que también utiliza Thally Cloud.
No clones `thallylabs/thally` como plantilla: ese repositorio contiene el
runtime público, no el proyecto completo destinado al cliente.

#### Inicia el servidor de desarrollo

```bash
cd my-docs
npm run dev
```

Abre [http://localhost:3040](http://localhost:3040) para ver el sitio de documentación predeterminado.

#### Crea tu primera página

Crea un nuevo archivo en `src/content/my-first-page.mdx`:

```mdx
---
title: My First Page
description: A quick test page to verify everything works.
---

Welcome to my documentation! This page was created with Thally.

## Next steps

- Edit `docs.json` to add this page to the sidebar.
- Replace the example content with your own.
```

#### Agrégala a la navegación

Abre `docs.json` y añade tu página a un grupo:

```json
{
  "group": "Getting Started",
  "pages": ["introduction", "quickstart", "my-first-page"]
}
```

Guarda el archivo y la barra lateral se actualiza automáticamente — no se requiere reinicio.

#### Despliega

```bash
npm run build:cloudflare
npm run smoke:cloudflare
```

Despliega el Worker verificado con `npm run deploy:cloudflare`. Para un
despliegue Node tradicional, usa `npm run build && npm start`.