Un dominio personalizado proporciona a tu app Coderblock una dirección de producción fácil de reconocer, sin tener que utilizar la URL de Coderblock asignada automáticamente al proyecto.

Puedes:

• conectar un dominio que ya tienes configurando los registros DNS mediante el asistente;
• comprar un dominio nuevo directamente en Coderblock y dejar que la plataforma gestione el DNS y el SSL.

En este tutorial veremos ambas opciones y cómo comprobar que todo funciona correctamente después de publicar la app.

Antes de conectar un dominio

Antes de configurar el dominio, asegúrate de que la app esté lista para publicarse.

Abre la vista previa de desarrollo en tiempo real en <app>.coderblock.dev y prueba los principales flujos de la app, entre ellos:

• navegación y diseño en dispositivos móviles;
• registro e inicio de sesión, si utilizas cuentas;
• formularios y funciones conectadas a la base de datos;
• proceso de pago de Stripe, si has habilitado los pagos;
• área de administración y otras secciones protegidas.

Si encuentras algo que debas corregir, solo tienes que pedírselo al agente de Coderblock utilizando lenguaje natural. Por ejemplo:

Haz que la navegación sea responsive y comprueba que el formulario de registro muestre mensajes de error de validación claros.

La app se actualizará en la vista previa en tiempo real en pocos segundos. El dominio personalizado no sustituye a la URL de desarrollo: simplemente añade una nueva dirección a la versión de producción publicada de la app.

Llegados a este punto, elige qué configuración quieres utilizar:

1. Conectar un dominio que ya tienes: tendrás que modificar sus registros DNS mediante el registrador o proveedor de DNS que gestione el dominio.
2. Comprar un dominio en Coderblock: completarás el pago directamente en la plataforma y Coderblock configurará automáticamente el DNS y el SSL.

---

Opción A: conecta un dominio que ya tienes

Esta es la opción adecuada si ya has comprado un dominio a otro proveedor y puedes modificar su configuración de DNS.

Paso 1: abre la configuración de dominios

Abre el proyecto de Coderblock y ve a Configuración → Dominios. Selecciona la opción para conectar un dominio existente. Introduce el dominio que quieres utilizar para tu app y comprueba detenidamente que esté escrito correctamente antes de continuar.

---

Paso 2: comprueba los registros DNS

Coderblock mostrará los registros DNS necesarios para conectar el dominio al proyecto. Mantén abierta esta página: la necesitarás para copiar los nombres, tipos y valores indicados en el panel de tu proveedor de DNS. Utiliza exactamente los registros que se muestran para tu proyecto. No los sustituyas por valores encontrados en otros tutoriales o configuraciones de servicios diferentes: el destino depende de la app específica que estés conectando.

---

Paso 3: abre el panel del proveedor de DNS

Abre una nueva pestaña del navegador e inicia sesión en el servicio que gestiona el DNS de tu dominio. Puede ser el registrador al que compraste el dominio o un proveedor de DNS independiente. Busca la sección dedicada a la gestión del DNS. Dependiendo del servicio, puede llamarse:

• DNS
• Registros DNS
• Editor de zona
• Gestionar DNS

---

Paso 4: añade los registros indicados por Coderblock

Crea o actualiza los registros DNS para que coincidan con los valores mostrados por Coderblock. Copia cada campo con cuidado y guarda los cambios. Antes de eliminar un registro existente, comprueba siempre para qué se utiliza. Un dominio puede emplear otros registros, por ejemplo, para el correo electrónico o para servicios distintos de la app web. Modifica únicamente los registros que entren en conflicto con la dirección que quieres conectar y deja sin cambios los que no estén relacionados. Si el proveedor añade automáticamente el nombre del dominio al campo del host, sigue sus indicaciones de formato. El objetivo es que el registro guardado represente el mismo host y el mismo destino indicados por Coderblock.

---

Paso 5: vuelve a Coderblock

Vuelve a Configuración → Dominios y continúa con el proceso de conexión. Ten en cuenta que las actualizaciones de DNS no siempre se hacen visibles en todas partes al mismo tiempo. Por este motivo, es posible que el dominio no esté disponible inmediatamente después de guardar los registros. Si la validación falla, vuelve a comparar cada campo con los valores mostrados por Coderblock. Comprueba sobre todo:

• posibles errores tipográficos;
• registros duplicados;
• registros anteriores que dirijan el mismo host a otro destino.

Publica y prueba la app en producción

Una vez completada la conexión, haz clic en Publicar para desplegar la versión de producción. Coderblock publicará la app en <app>.coderblock.app o en el dominio personalizado conectado, con SSL incluido.

Abre el dominio personalizado en una pestaña nueva y comprueba que:

• la página se cargue mediante https://;
• el navegador muestre el dominio correcto;
• los enlaces de navegación permanezcan en la dirección de producción;
• la autenticación y las páginas protegidas funcionen;
• los formularios lean y escriban correctamente los datos en la base de datos Postgres;
• los pagos utilicen el modo de Stripe previsto;
• las imágenes y los archivos se carguen correctamente desde el almacenamiento.

Si la app está destinada al público, haz algunas pruebas tanto en equipos de escritorio como en dispositivos móviles. El trabajo no termina al conectar el dominio: puedes seguir modificando la app mediante el chat, comprobar las actualizaciones en la vista previa en tiempo real y volver a publicarla cuando quieras llevarlas a producción.

Opción B: compra un dominio directamente en Coderblock

Si todavía no tienes un dominio adecuado, puedes comprarlo directamente desde la plataforma. Abre Configuración → Dominios y selecciona la opción para comprar un dominio nuevo. Elige el dominio que prefieras y completa el pago dentro de Coderblock.

En este caso, el DNS y el SSL se configuran automáticamente, por lo que no tendrás que copiar registros ni modificar manualmente el panel de DNS de un servicio externo. Una vez completadas la compra y la configuración, publica la app y realiza las mismas comprobaciones descritas en la sección anterior.

En particular, comprueba:

• la dirección HTTPS;
• el inicio de sesión y el registro;
• los formularios;
• los archivos y las imágenes;
• cualquier flujo de pago.

Si el dominio no carga

Si el dominio conectado no funciona como esperabas, empieza por esta lista de comprobación:

1. Comprueba el dominio. Verifica que el dominio introducido en Coderblock coincida exactamente con aquel cuyos registros DNS has modificado.
2. Vuelve a comprobar los registros DNS. Incluso un solo carácter incorrecto puede impedir que el dominio se conecte correctamente.
3. Busca posibles conflictos. Es posible que un registro antiguo siga dirigiendo el mismo host a otro servicio.
4. Espera a que se actualice el DNS. Los cambios pueden tardar un tiempo en propagarse.
5. Comprueba que hayas publicado la app. La vista previa de desarrollo y la versión de producción son entornos independientes.
6. Prueba la dirección HTTPS completa. Introduce directamente la URL con https://.
7. Prueba en una ventana privada. Esto permite descartar problemas relacionados con la caché, las redirecciones o versiones antiguas almacenadas por el navegador.

Un aspecto importante: no modifiques continuamente los registros DNS mientras la configuración se está actualizando. Si los valores coinciden con los indicados por Coderblock, hacer cambios innecesarios puede complicar aún más el proceso.

Lista de comprobación final

El dominio está configurado correctamente cuando:

• aparece en Configuración → Dominios dentro del proyecto;
• los registros DNS coinciden con la configuración indicada por Coderblock o se han configurado automáticamente después de una compra realizada en la plataforma;
• la app se ha publicado;
• el dominio personalizado se abre mediante HTTPS;
• los principales flujos de la app funcionan correctamente en producción.

Tu dominio está listo

Ahora tu app Coderblock tiene una dirección de producción personalizada y puede compartirse con clientes, usuarios y otras partes interesadas. A partir de aquí, puedes seguir desarrollándola con normalidad: chat → modificación → vista previa → publicación, manteniendo el dominio personalizado como punto de acceso a la versión en producción.