---
title: Crear un proyecto
description: Crea un proyecto de Jamdesk desde una plantilla o conecta un repositorio de GitHub existente. Tu sitio estará en yourproject.jamdesk.app en minutos.
---

Antes de escribir cualquier documentación necesitas un proyecto. Puedes comenzar desde una plantilla (Jamdesk crea el repositorio de GitHub por ti) o conectar un repositorio existente que ya tenga un `docs.json`. De cualquier manera, tendrás un sitio en funcionamiento en pocos minutos.

## Crear un nuevo proyecto

<Steps>
  <Step title="Inicia sesión en Jamdesk">
    Ve a [dashboard.jamdesk.com](https://dashboard.jamdesk.com) e inicia sesión con tu cuenta de GitHub.

    Los usuarios que acceden por primera vez serán solicitados a autorizar la aplicación de GitHub de Jamdesk.
  </Step>

  <Step title="Haz clic en Nuevo proyecto">
    Desde el dashboard, haz clic en **Nuevo proyecto** en la esquina superior derecha.
  </Step>

  <Step title="Elige un punto de partida">
    <Tabs>
      <Tab title="Desde plantilla">
        Comienza con una plantilla prediseñada. Jamdesk crea un nuevo repositorio de GitHub para ti con contenido de muestra, navegación y componentes ya configurados.

        La [Starter Template](https://github.com/jamdesk/starter-docs) predeterminada incluye páginas de muestra, una especificación OpenAPI y ejemplos de cada componente — reemplaza el contenido con el tuyo y listo.
      </Tab>
      <Tab title="Desde repositorio">
        Conecta un repositorio de GitHub existente:

        1. Selecciona el repositorio del menú desplegable
        2. Elige la rama a desplegar (normalmente `main`)
        3. Especifica la ruta a `docs.json` si no está en la raíz
      </Tab>
    </Tabs>
  </Step>

  <Step title="Configura los ajustes del proyecto">
    Define la información básica de tu proyecto:

    | Campo | Descripción |
    |-------|-------------|
    | **Nombre** | Nombre de visualización que aparece en el dashboard |
    | **Slug** | Identificador compatible con URL (p. ej., `my-docs`) |
    | **Dominio** | Tu subdominio `*.jamdesk.app` |
  </Step>
</Steps>

## Estructura mínima del repositorio

Un proyecto de Jamdesk solo necesita un `docs.json` y al menos una página:

```bash
my-docs/
├── docs.json
└── introduction.mdx
```

Ejemplo de `docs.json`:

```json docs.json
{
  "$schema": "https://jamdesk.com/docs.json",
  "name": "My Docs",
  "theme": "jam",
  "navigation": {
    "groups": [
      {
        "group": "Getting Started",
        "pages": ["introduction"]
      }
    ]
  }
}
```

## Ajustes del proyecto

Después de la creación, configura tu proyecto en **Ajustes**:

### General

- **Nombre** - Actualiza el nombre de visualización
- **Slug** - Cambia el identificador del proyecto
- **Eliminar proyecto** - Elimina el proyecto de forma permanente

### Repositorio

- **Rama** - Qué rama activa los despliegues
- **Ruta de documentación** - Ubicación de `docs.json` para monorepos

### Dominio

- **Subdominio** - Tu URL `*.jamdesk.app`
- **Dominio personalizado** - Añade tu propio dominio
- **Servir en /docs** - Sirve la documentación en la ruta `/docs` en lugar de la raíz

### Build

- **Mostrar marca Jamdesk** - Muestra el enlace "Powered by Jamdesk" en tu pie de página (habilitado por defecto)
- **Reconstruir** - Activa manualmente un nuevo build

<Note>
Los cambios en los ajustes de build requieren un nuevo build para que tengan efecto.
</Note>

## Límites de proyectos

| Plan | Proyectos | Builds/mes |
|------|-----------|------------|
| Free | 1 | 100 |
| Pro | 10 | Ilimitado |
| Team | Ilimitado | Ilimitado |

## ¿Qué sigue?

<Columns cols={2}>
  <Card title="Conectar GitHub" icon="github" href="/es/setup/connecting-github">
    Vincula tu repositorio para builds automáticos
  </Card>
  <Card title="Estructura de directorios" icon="folder-tree" href="/es/setup/directory-structure">
    Organiza tu documentación para escalar
  </Card>
  <Card title="Configuración de monorepo" icon="folders" href="/es/setup/monorepo-support">
    Configura la ruta de documentación para monorepos
  </Card>
  <Card title="Tutorial completo" icon="route" href="/es/end-to-end-tutorial">
    Sigue el flujo de trabajo completo de Jamdesk
  </Card>
</Columns>