الخطوات الأولى

Fulgeon es un catálogo público de aplicaciones: tú traes el archivo y aquí recibe ficha, versiones, descargas y un informe firmado que cualquiera puede comprobar. Esta página recorre la primera publicación entera, del registro al catálogo.

Publicar es gratuito y hoy no hay ningún cobro activo en la plataforma: todas las aplicaciones del catálogo se descargan sin pagar.

Antes de empezar#

No hace falta instalar nada para la primera publicación. Sí hacen falta cuatro cosas.

• Una cuenta, con el correo verificado antes de publicar. Se crea en registro con nombre público (2–60 caracteres), correo y una contraseña de ocho caracteres o más, con al menos una letra y un número. Entras directamente al panel y puedes dejarlo todo preparado sin verificar nada: la ficha, la versión, los archivos. Lo único que exige el correo verificado es el botón de publicar, porque esa dirección es por donde te avisamos si algún día hay que retirar algo tuyo. El enlace llega al registrarte y caduca a las 24 horas; si no lo encuentras o caducó, en el panel hay un botón para que te mandemos otro (y el anterior deja de valer).
• Las condiciones de la plataforma aceptadas. Al registrarte por la web ya las aceptas con la casilla, así que normalmente no hay nada que hacer. Pero la aceptación es por versión del texto: si las condiciones cambian, cualquier paso de escritura (crear la ficha, crear la versión, subir, publicar) vuelve a pedir aceptarlas. Una cuenta anterior a esta regla, o un CI, se topan con un 403 que trae la versión pendiente en la cabecera X-Fulgeon-Terms; se aceptan desde el panel o con POST /api/v1/terms/accept.
• El archivo que descargará la gente, de 500 MB como mucho, con una de estas extensiones: .dmg .pkg .zip .exe .msi .appimage .deb .rpm .tar.gz .tgz .jar .apk .vsix .gz .7z. Si tu aplicación se distribuye desde otro sitio —la App Store, la Chrome Web Store—, en vez del archivo vale un enlace https://.
• Unas notas de versión de al menos 10 caracteres. No es un capricho: una versión sin explicar es una versión que nadie sabe si le conviene.

1 · La ficha#

En tus aplicaciones → Nueva aplicación:

• Nombre (2–80 caracteres). De él sale el slug, y el slug es la URL.
• Frase de presentación (4–140 caracteres). Es lo que se lee en el listado.
• Qué es: app, game, tool, library, mod, plugin o theme. No es decorativo: decide qué categorías y qué destinos te ofrece después el formulario — un mod puede declarar cargador; una app de escritorio, no.
• Categoría, opcional. La lista depende del tipo que hayas elegido.
• Hecha con ayuda de IA, opcional. Si parte del código salió de una IA, márcalo. Aquí no penaliza: se declara y punto.

La ficha nace en borrador: sólo la ves tú.

2 · La versión#

Dentro de la ficha, Nueva versión: el número (1–40 caracteres, único dentro de tu aplicación), el canal y el changelog.

La versión también nace en borrador: editable e invisible.

3 · El archivo#

En la versión en borrador, despliega + Añadir artefacto. Subes el archivo —o pones el enlace— y dices dónde corre: sistema, cargador si el tipo lo admite, arquitectura y versión mínima. Puedes añadir tantos como haga falta: una versión son todos sus archivos.

Fulgeon calcula el SHA-256 mientras recibe el archivo y firma con él un informe de identidad: qué archivo es, cuánto ocupa, qué hash tiene y cuándo se registró. Es automático y no tienes que hacer nada.

4 · Publicar#

Son dos botones, y en este orden.

1. Publicar la versión. Exige al menos un archivo o enlace principal. A partir de ahí la versión es inmutable.
2. Publicar la ficha. Exige al menos una versión ya publicada: el catálogo enseña cosas que se pueden descargar, no promesas.

Los dos botones exigen además el correo verificado. Es el único requisito que puedes dejar para el final: crear la ficha, la versión y subir archivos no lo piden; publicar, sí. Las condiciones de la plataforma, en cambio, se exigen en cada paso de escritura, así que a esta altura ya están aceptadas. Si falta cualquiera de las dos cosas, la respuesta es un 403 que dice cuál.

Publicar la versión no publica la ficha. Si te dejas ese segundo botón, la versión existe, es inmutable y no la ve nadie.

Inmutable quiere decir que esa versión no se toca más: ni el archivo, ni su hash. Si algo salió mal, se retira y se publica otra, y así el hash que alguien apuntó ayer sigue significando lo mismo hoy. Las notas tampoco las puedes tocar tú; Fulgeon sí puede sustituirlas si incumplen la política de notas, dejando constancia de la intervención. El archivo y su hash no los toca nadie.

Hecho: tu aplicación ya tiene ficha pública en /apps/app/tu-slug.

Cuando la publicación se repite#

A la tercera vez, arrastrar archivos cansa. Con una clave de API de claves de API y Node 20 o superior, lo de arriba cabe en un comando: el CLI está publicado en npm desde el 16 de agosto de 2026.

npm install -g @fulgeon/cli

fulgeon login                    # pega la clave una vez
fulgeon apps                     # tus fichas, con sus slugs

fulgeon publish --app mi-app --version 1.2.0 \
  --changelog @CHANGELOG.md \
  --file 'dist/*.dmg' --file 'dist/*.exe'

El mismo comando vale dentro de tu CI. La clave se puede atar a una sola aplicación y ponerle fecha de caducidad: si se filtra, el destrozo es pequeño.

Y ahora qué#

• Publicar desde el CLI — el comando entero, bandera a bandera.
• Claves de API — cómo se crean, qué pueden y dónde se guardan.
• Versiones, canales e informes firmados — qué se firma exactamente y cómo lo comprueba cualquiera, sin fiarse de nosotros, desde verificar informe.