Documentación

Guía del Design System

Variables, clases, convenciones, estructura del proyecto y cómo extender el sistema sin romper nada.

30+ Variables CSS
2K+ Componentes Galaxy
5 Secciones en /ui/
v3.0
Design System

Variables CSS

Todas las variables viven en /_astro/main.min.css (el ?v= de la URL real es un hash de contenido, se recalcula solo con bump_cache_version.py). Nunca uses valores hardcoded — si ese archivo no carga, styles.css tiene un fallback idéntico en :root.

Fondos
--bg#060810
--bg-2#0a0e1a
--surface#0d1121
--surface-2#111827
--cardrgba(…)
Texto
Aa--text#f1f5f9
Aa--text-2#e2e8f0
Aa--text-3#cbd5e1
Aa--text-4#94a3b8
Aa--text-5#64748b
Acentos
--indigo#6366f1
--indigo-l#818cf8
--indigo-d#4f46e5
--purple#a855f7
--purple-l#c084fc
--green#22c55e
Bordes
--borderrgba(…45%)
--border-lrgba(…70%)
--border-hiindigo 50%
Regla de oro: si necesitás un color que no existe como variable, no lo hardcodees — agregalo a /_astro/main.min.css y al fallback de styles.css.

Paleta de colores

CostaCraft UI usa una paleta oscura (dark-first) construida sobre azul índigo + violeta como acentos, con verde solo para estados de éxito. Todos los valores ya están como variables.

bg
bg-2
surface
surface-2
card hover
indigo-d
indigo
indigo-l
purple
purple-l
green
Indigo / Índigo
Botones primarios, links activos, bordes de foco, badges.
Purple / Violeta
Gradientes, text-gradient, acentos decorativos secundarios.
Green / Verde
Solo estados de éxito, código de terminal, online/activo.
Amber / Ámbar
Solo advertencias. No disponible como variable — usar inline en callout.warn.
Red / Rojo
Solo errores y destructivos. No disponible como variable — usar inline.

Tipografía

El sistema usa dos familias tipográficas. Nunca uses font-family hardcoded.

Display — --font-display
Plus Jakarta Sans
Plus Jakarta Sans · Inter (fallback) · system-ui

Usado en headings (h1–h3), nombres de componentes, números grandes y cualquier texto que necesite personalidad fuerte. Weights: 700, 800, 900.

Body — --font-body
Texto de cuerpo, descripciones y UI general.
Inter · system-ui · sans-serif

Párrafos, labels, descripciones, UI pequeño. Weights: 400, 500, 600. Tamaños: 0.75rem → 1rem.

Mono — inline en código
const ui = 'costacraft';
JetBrains Mono · Fira Code · Cascadia Code

Bloques pre, code inline, .docs-code, .kb-cmd. No disponible como variable — se usa directamente con font-family: monospace stack.

Escala tipográfica

clamp(1.4–1.9rem)Panel Title.ui-panel-title
1.2rem / 800Section Title.docs-section-title
0.92rem / 400Párrafo normal — descripción de panel..docs-p
0.84rem / 500UI label, nav item, texto compacto.ui-nav-item
0.78rem / 600Subnav button, search count.ui-subnav-btn
0.67rem / 700 uppercaseLABEL DE CATEGORÍA.ui-sidebar-label

Espaciado & Radios de borde

Los radios de borde están todos en variables. El espaciado no tiene variables propias — seguí las convenciones por contexto.

--r-sm 6px
--r-md 10px
--r-lg 14px
--r-xl 18px
--r-2xl 24px
--r-full 9999px

Convenciones de espaciado

ContextoPaddingGap
Panel header principal36px 44px 28px—
Panel body28px 44px 60px—
Subnav12px 44px4px entre tabs
Card de componente12–14px interior16px entre cards
KB card20px14px entre cards
Sidebar nav item8px 10px2px entre items
Responsive ≤1023px24px 20pxreducido

Sombras

--shadow-md

0 4px 24px rgba(0,0,0,.35) — hover de cards, modales pequeños

--shadow-lg

0 12px 48px rgba(0,0,0,.5) — drawers, panels flotantes

Iconografía

Todo el sitio usa SVG inline, nunca una librería de íconos ni una fuente de íconos (Font Awesome, etc.) ni archivos .svg externos. Cada ícono es un <svg> pegado directo en el HTML, con un patrón de atributos casi siempre idéntico:

<svg width="14" height="14" fill="none" stroke="currentColor" stroke-width="2.5" viewBox="0 0 24 24"> <path stroke-linecap="round" stroke-linejoin="round" d="..."/> </svg>

Los cuatro atributos fill="none" stroke="currentColor" stroke-width="2.5" viewBox="0 0 24 24" son fijos en casi todo el sitio — stroke="currentColor" es lo que permite que el ícono herede el color del texto/link que lo rodea sin tocar nada del SVG. Lo único que cambia por contexto es el tamaño (width/height) y, en menor medida, el grosor del trazo.

Tamaños por contexto

TamañoDónde se usastroke-width
10pxChevrons de breadcrumb, flechas "volver"2.5
12pxÍconos dentro de botones chicos (Copiar, Editar)2.2 – 2.5
14pxÍconos de título de sección (.docs-section-title-icon), la mayoría de los íconos del sitio2 – 2.5
16pxBullets de Do/Don't (.docs-best-practice)2.5
¿De dónde salen los paths? Son los mismos que Feather Icons (set de código abierto, stroke-based) — no hace falta instalar el paquete ni importar nada: se copia el <path> del ícono que haga falta y se pega con el mismo wrapper de arriba.

No agregar una librería de íconos (Font Awesome, Lucide como paquete, etc.) — cada ícono nuevo se agrega como SVG inline, siguiendo el mismo patrón de esta sección.

Animaciones & transiciones

Las duraciones de transición no están en variables (a diferencia de colores y radios) — se repiten por convención directamente en cada regla. Estos son los valores reales que ya usa el sitio, agrupados por qué tan "grande" es el cambio visual:

DuraciónUso típico
0.15s – 0.16sCambios chicos: color de texto/borde en hover, opacity de un ícono
0.18s – 0.22sCambios medianos: transform (levantar una card), box-shadow al hacer hover
0.4s – 0.5sCambios grandes: aparecer/desaparecer un overlay, glow que se prende con opacity

Para transiciones de transform (las que más se "sienten" si el easing es lineal), el sitio usa una curva propia en vez de ease:

/* En :root, main.min.css */ --ease-out: cubic-bezier(0.22, 1, 0.36, 1); /* Uso típico */ transition: transform .22s var(--ease-out), box-shadow .22s;

Glow que sigue el mouse

Varias cajas del sitio (el hero de ia-negocio, la caja de preview de component-view.html) tienen un glow radial que se mueve con el cursor. No es una clase reusable todavía — es la misma técnica repetida a mano en cada lugar que la necesita:

  1. Un listener de mousemove en el contenedor actualiza dos custom properties, --mx/--my, con la posición del cursor relativa a la caja.
  2. Un pseudo-elemento ::after con background: radial-gradient(260px circle at var(--mx,50%) var(--my,0%), ...) lee esas variables — el navegador repinta el gradiente en cada frame sin JS adicional.
  3. opacity:0 por defecto y opacity:1 en :hover, con su propia transición — así el glow aparece/desaparece suave en vez de "saltar".
Accesibilidad: @media (prefers-reduced-motion: reduce) ya está implementado en styles.css — apaga las animaciones puramente decorativas (orbes del hero, loaders, dots de estado). Si agregás una animación nueva que sea decorativa (no comunica estado ni feedback de una acción), sumala a esa misma regla.

Componentes — clases semánticas

Los componentes se activan con clases semánticas definidas en /_astro/main.min.css. No copies estilos inline — usá las clases.

<a href="#" class="btn btn-primary">Comenzar</a>
<a href="#" class="btn btn-secondary">Secundario</a>
Soy una card
<div class="card">Contenido</div>
CostaCraft
<span class="text-gradient">CostaCraft</span>

Clases utilitarias de /ui/

Estas clases son exclusivas de /ui/styles.css y no están disponibles en el resto del sitio:

ClaseQué haceContexto
.ui-layoutGrid 248px sidebar + 1fr mainWrapper raíz
.ui-sidebarSidebar sticky con scroll propioSidebar
.ui-nav-itemLink de nav con estado activo y hoverSidebar
.ui-sectionSección oculta — .active la muestraMain
.ui-panel-headerHeader de panel con grid de fondoCada sección
.ui-subnavTabs de subcategoría con scroll horizontalGalaxy / KB
.comp-gridGrid de componentes tipo UIverseGalaxy
.comp-cardCard de componente con preview + códigoGalaxy
.kb-grid / .kb-cardGrid de artículos de KBKB sections
.docs-sectionSección de documentación con separadoresGuía
.docs-calloutBloque de aviso (+ .warn, .success)Guía
.docs-codeBloque de código con mono + highlightGuía
.docs-best-practiceDo/Don't visual (+ .do, .dont)Guía

Buenas prácticas

Siempre variables CSS — nunca colores, tamaños o fuentes hardcodeados en ningún archivo nuevo.

No Bootstrap, no Tailwind — el design system es autocontenido. Agregar frameworks externos rompe la consistencia visual.

Mobile-first — estilos base para móvil, @media (min-width: 640px) y @media (min-width: 1024px) para desktop. Nunca max-width primero.

Respetar el orden de carga de scripts — data → renderers → nav.js. Si movés nav.js arriba, la navegación se rompe.

No editar galaxy/_bundles/ a mano — son archivos generados. Siempre editá en galaxy/<Categoría>/ y corré el build.

content-visibility: auto en grids grandes — ya está en .comp-card. Si creás nuevas grillas de renderizado masivo, aplicá el mismo patrón para mantener el rendimiento.

No mezclar estilos de /ui/styles.css en el sitio principal — la carpeta /ui/ es completamente autocontenida. Sus clases no deben usarse fuera de ella.

Correr bump_cache_version.py --apply después de tocar cualquier .css/.js — ver Cache-busting. Sin esto, el navegador de un visitante puede seguir sirviendo la versión vieja desde caché.

No usar Node.js para verificar cambios — este proyecto se valida con Python o directamente en el navegador. build-galaxy-bundles.js es la única pieza que requiere Node, y solo corre en local, nunca como parte de la verificación de un cambio.

Estructura del proyecto

Así está organizado el repositorio. Todo lo relacionado a /ui/ vive de forma autocontenida — no toca nada de /_astro/ salvo leer las variables.

/ ├── _astro/ │ ├── main.min.css # Design system global (variables, componentes base) │ └── api_py/ # Backend real (Python/CGI) — motor de IA basado en reglas, sin LLM externo │ ├── es/ en/ fr/ pt/ # Sitio principal, multi-idioma │ └── ui/ ├── index.html # Guía, Componentes, Plantillas, Fondos de Video, KB ├── component-view.html # Un componente Galaxy en pestaña completa (preview + código) ├── styles.css # Estilos exclusivos de /ui/ ├── build-galaxy-bundles.js # Script build Galaxy (Node, correr en local) ├── fix_scoped_css.py # Corrige scopedCss ya generado sin correr el build (Python) │ ├── data/ │ ├── kb-minecraft.js # KB_MINECRAFT — artículos KB Minecraft │ ├── kb-web.js # KB_WEB — artículos KB Hosting Web │ ├── video-backgrounds.js # VIDEO_BACKGROUNDS — catálogo de Fondos de Video │ └── templates-catalog.js # TEMPLATES_CATALOG + TEMPLATES_CATEGORIES │ ├── js/ │ ├── code-highlight.js # Resaltador HTML/CSS compartido — usado por galaxy-renderer.js y component-view.html │ ├── galaxy-renderer.js # Motor de Galaxy Componentes — no tocar │ ├── kb-renderer.js # Motor de Knowledge Base — no tocar │ ├── templates-renderer.js # Motor de Galaxy Plantillas — no tocar │ ├── video-bg-renderer.js # Motor de Fondos de Video — no tocar │ └── nav.js # Navegación central — siempre ÚLTIMO │ └── galaxy/ ├── Buttons/ # Componentes fuente (.html individuales) ├── Cards/ ├── Inputs/ ├── ... └── _bundles/ # ⚠️ Generados — NO editar a mano ├── Buttons.json ├── manifest.json # Conteo por categoría (sidebar badges) └── ...
⚠️ La carpeta galaxy/_bundles/ es generada por build-galaxy-bundles.js. Si la editás a mano, el próximo build la sobreescribe. Editá siempre el .html fuente.

Cache-busting (?v=)

Todo .css y .js se referencia en el HTML con un ?v=<hash> al final — por ejemplo styles.css?v=5bf61a60. Ese hash no se escribe a mano: es sha256(contenido del archivo)[:8], calculado por un script.

1
Editás un .css o .js
El contenido del archivo cambió, así que su hash también cambió — pero el ?v= en el HTML todavía apunta al hash viejo.
→
2
Corrés el script
python bump_cache_version.py escanea TODOS los .html del proyecto buscando referencias a ese asset (por ruta absoluta o relativa).
→
3
Reescribe el ?v=
Con --apply reemplaza el hash viejo por el nuevo en cada referencia. Sin --apply solo informa qué CAMBIARÍA (dry-run).
→
4
El navegador ve una URL nueva
Como la URL completa (incluyendo ?v=) cambió, el navegador la trata como un recurso distinto y la vuelve a descargar — nunca sirve la copia vieja desde caché.
# Reporta qué archivos quedaron desactualizados (no escribe nada) python bump_cache_version.py # Aplica los cambios de verdad python bump_cache_version.py --apply
⚠️ Este proyecto no tiene repositorio git — por eso el script corre en dry-run por defecto como red de seguridad. Siempre revisá el reporte ("HTML con referencias desactualizadas") antes de agregar --apply.
¿Cuándo hace falta correrlo? Solo después de editar un .css o .js que ya esté referenciado con ?v= en algún HTML. Editar solo HTML (como esta misma Guía) nunca lo necesita.

Breakpoints responsive

Como ya dice Buenas prácticas, el sitio es mobile-first: los estilos base son para pantallas chicas y los @media agregan/ajustan para pantallas más grandes. Estos son los breakpoints reales que ya existen (no hay más que estos tres a nivel de /ui/styles.css):

BreakpointQué cambiaDónde
max-width: 639pxLayout mobile: sidebar se convierte en tabs horizontales arriba, se ocultan elementos secundarios (brand, footer)styles.css
max-width: 1023pxPadding reducido de panels (36px 44px → 24px 20px), grillas pasan a menos columnasstyles.css
max-width: 900pxEl layout de dos columnas (preview + código) colapsa a una sola columna apiladacomponent-view.html — propio de esa página, no está en styles.css
⚠️ Los tres son max-width, no min-width — la convención de este proyecto es escribir el estilo base pensando en mobile y usar max-width para las excepciones de pantalla chica cuando el layout de escritorio ya está resuelto con grid/flex fluido. Si necesitás agregar un breakpoint nuevo, seguí el mismo criterio en vez de mezclar min-width y max-width en el mismo archivo.

Galaxy: cómo funciona el sistema

Galaxy es la sección de Complementos y Plantillas. Por el volumen de archivos (miles de snippets), el navegador nunca lee la carpeta fuente directamente.

1
Archivos fuente
Cada componente vive en galaxy/<Categoría>/nombre.html como un snippet HTML/CSS autocontenido.
→
2
Build
Corrés node build-galaxy-bundles.js en local. Lee los _index.json de cada categoría y empaqueta todos los .html en un _bundles/Categoría.json.
→
3
Carga en el navegador
El navegador pide solo el bundle de la categoría activa — nunca los 11 juntos. Las cards se renderizan de a 24 con scroll infinito.
→
4
Manifest
_bundles/manifest.json tiene el conteo por categoría — de ahí salen los números del sidebar (ej. "Botones 1231").

Agregar un componente nuevo a Galaxy

# 1. Creá el archivo en la carpeta de la categoría galaxy/Buttons/mi-boton-nuevo.html # 2. Agregá el nombre al array "files" de _index.json galaxy/Buttons/_index.json → { "files": [..., "mi-boton-nuevo"] } # 3. Regenerá los bundles (en local, no en producción) node build-galaxy-bundles.js # 4. Subí solo la carpeta actualizada galaxy/_bundles/
Rendimiento: los bundles se sirven comprimidos (gzip/brotli según tu hosting). Con compresión, los JSON de varios MB quedan en cientos de KB. El scroll infinito (24 cards a la vez) garantiza que DOM nunca tenga miles de nodos simultáneos.

Auto-escalado del preview

Cada componente puede traer cualquier tamaño natural — un modal gigante o un ícono chiquito — pero la caja de preview siempre mide lo mismo. Por eso cada preview se auto-escala para entrar sin recortarse:

  1. measureNaturalExtent() mide el tamaño real del componente: no solo su wrapper, sino la unión del bounding rect de todos sus descendientes (varios componentes se dibujan con hijos en position:absolute, así que el wrapper solo no alcanza).
  2. scaleToFit() aplica un transform: scale() que achica el componente si no entra — nunca lo agranda si ya entra de sobra.
  3. Para componentes con el tag Tailwind, se vuelve a medir 150ms después: el CDN de Tailwind aplica sus clases de forma asíncrona (su propio MutationObserver), así que medir una sola vez de inmediato puede dar un tamaño incorrecto.
Esta lógica está duplicada a propósito en galaxy-renderer.js (como measureAndScale()/fitPreviews(), para la grilla) y en component-view.html (copia local más chica, para la vista de un solo componente) — esa página no carga el renderer completo porque asume una estructura de sidebar/subnav que ahí no existe.

Editor de código en vivo

En la vista de un solo componente (component-view.html, el botón "Ver completo" de cualquier card) hay un botón "Editar" junto a "Copiar": convierte el HTML y el CSS en <textarea> editables, y cada tecleo (con un debounce de 200ms) vuelve a renderizar el preview con el código actual.

Nada se guarda — es 100% en memoria del navegador. Recargar la página siempre vuelve al código original del componente. Es un sandbox visual, no un editor con persistencia.

Por qué el CSS editado necesita escoparse

Si el CSS que escribe un visitante se inyectara tal cual en un <style>, un selector como body { background: red } afectaría toda la página, no solo su caja de preview. Por eso, antes de inyectarlo, se le aplica el mismo mecanismo de escopado que ya usa el build de Galaxy:

// Lo que el visitante escribe: button { color: red; } // Lo que se inyecta de verdad en el preview: [data-comp-scope="gscope-Buttons-1"] button { color: red; }

La caja de preview (.comp-preview-inner) tiene ese mismo atributo data-comp-scope="gscope-<id>", así que el selector escopado solo puede matchear elementos dentro de esa caja — nunca el <body> real ni el resto de la página, sin importar qué escriba el visitante.

La función scopeCSS() en component-view.html es un puerto directo a JavaScript de scope_css() en fix_scoped_css.py (mismo regex, mismo criterio para no tocar selectores dentro de comentarios o de bloques @keyframes). Si en algún momento se agrega otro preview editable en /ui/, reusá esta misma función en vez de reinventarla.

Cómo se arma un artículo de KB

Los artículos de las 5 secciones de Knowledge Base (Minecraft, Hosting Web, Panel Pterodactyl, Email&SMTP, Desarrollo) no son Markdown ni HTML — son texto plano con un formato propio que kb-renderer.js convierte a HTML en el navegador. Cada artículo vive como un objeto dentro de un array (ej. window.KB_MINECRAFT en data/kb-minecraft.js):

{ id: "mc-13", navLabel: "Datapacks", // texto corto del tab title: "Minecraft — Datapacks", desc: "Descripción de una línea...", sections: [{"title": "...", "anchor": "..."}], // TOC lateral content: `el texto del artículo, ver abajo`, }

Dentro de content, un parser de texto plano (no un parser de Markdown) busca patrones exactos línea por línea. Estas son las reglas, en el orden en que las busca:

1. Banner superior (decorativo, se ignora)

Todo lo que esté entre la primera y la segunda línea de 12+ caracteres ━ se descarta por completo al renderizar — es solo para que quien lea el archivo fuente vea de un vistazo de qué trata el artículo.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ MINECRAFT — DATAPACKS Subtítulo corto acá ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

2. Secciones (se vuelven <h2>)

Un "sándwich" de 3 líneas: separador liviano (12+ caracteres ═), el título, y otro separador liviano. Cada uno de estos se vuelve un <h2> con un id calculado a partir del título:

════════════════════════════════════════ ESTRUCTURA DE CARPETAS ════════════════════════════════════════
⚠️ Por cada sección así, tenés que agregar una entrada IDÉNTICA al array sections del objeto (mismo title, y anchor calculado con esta función exacta — no es un slugify estándar):
function slugify(s) { return s.toLowerCase() .replace(/[^a-z0-9]+/g, '-') .replace(/^-|-$/g, ''); }
Ojo con los acentos: no están en [a-z0-9], así que se "comen" en el guion — "INFORMACIÓN DEL SERVIDOR" da "informaci-n-del-servidor", no "informacion-del-servidor". Si el anchor no coincide exactamente con lo que produce esa función, el link del TOC lateral no salta a ningún lado.

3. Callouts

Cualquier línea que empiece con NOTA:, IMPORTANTE:, ADVERTENCIA:, WARNING:, CRÍTICO: o ATENCIÓN: (sin importar mayúsculas/minúsculas) se convierte en un cuadro de aviso destacado.

4. Bloques de código

Cualquier línea que empiece con 2+ espacios o un tab se trata como código — queda en monoespaciada con su propio botón "Copiar". Así se muestran todos los comandos/config de ejemplo en los artículos existentes.

5. Párrafos

Cualquier otra línea (no vacía, no separador, no callout, no indentada) es texto normal — líneas consecutivas se unen en un mismo párrafo. Una línea en blanco corta el párrafo.

Antes de escribir un artículo nuevo: mirá 1-2 artículos existentes de la misma sección para copiar el tono (directo, con voseo, ejemplos de comando reales) y el nivel de profundidad — no es un resumen corto, son guías completas de varios KB de texto cada una.

Nameservers de CostaCraft

Cuando conectes un dominio a los servicios de CostaCraft, usá estos nameservers:

Nameserver 1
ns1.costacraft.net
Nameserver 2
ns2.costacraft.net
La propagación de DNS puede tardar entre 15 minutos y 48 horas dependiendo del registrar. En la mayoría de los casos con CostaCraft los cambios propagan en menos de 2 horas.

Glosario de términos

Términos propios de este proyecto que aparecen en varias secciones de la Guía sin repetir la definición cada vez:

TérminoQué significa
GalaxyEl sistema de Complementos + Plantillas dentro de /ui/ — miles de snippets copy-paste organizados por categoría. No confundir con el resto de /ui/ (Guía, KB), que no pasa por el pipeline de bundles.
BundleUn .json en galaxy/_bundles/ con todos los componentes de UNA categoría ya empaquetados — lo que el navegador realmente descarga, nunca los .html fuente.
Manifestgalaxy/_bundles/manifest.json — conteo de componentes por categoría, de ahí salen los números del sidebar.
scopedCss / gscopeLa versión del CSS de un componente con cada selector prefijado por [data-comp-scope="gscope-<id>"], para que solo aplique dentro de su propia caja de preview. Ver Editor de código en vivo.
Auto-escaladoLa lógica de scaleToFit()/measureNaturalExtent() que achica (nunca agranda) un componente para que entre en su caja de preview. Ver Galaxy: cómo funciona.
KBKnowledge Base — las 5 secciones de artículos largos (Minecraft, Hosting Web, Panel Pterodactyl, Email&SMTP, Desarrollo). Formato propio, no Markdown. Ver Cómo se arma un artículo de KB.
Cache-bustingCambiar el ?v=<hash> de un asset para forzar al navegador a descargar la versión nueva en vez de servir una copia vieja desde caché. Ver Cache-busting.
Dry-runModo de bump_cache_version.py que solo informa qué cambiaría, sin escribir nada — el modo por defecto, ya que este proyecto no tiene git para deshacer un error.
ui-sectionCada una de las áreas principales de /ui/ (Guía, Componentes, Plantillas, Fondos de Video, cada KB) — solo una tiene la clase .active (visible) a la vez, controlado por nav.js.
RendererEl script de js/ que arma el HTML de una sección a partir de sus datos (galaxy-renderer.js, kb-renderer.js, templates-renderer.js, video-bg-renderer.js). Cada sección tiene el suyo, ninguno depende de otro.

Preguntas frecuentes

¿Corriste node build-galaxy-bundles.js después de agregar el archivo? El browser no lee los .html fuente — solo los .json de _bundles/. También asegurate de que el nombre del archivo esté en el array "files" de _index.json de la categoría.
No en el código del sistema (/_astro/main.min.css, /ui/styles.css, los renderers). Sí podés incluirlos dentro del HTML de un componente Galaxy si ese componente específicamente lo necesita para su preview — pero ese CSS queda aislado dentro del .comp-preview y no afecta al sistema.
De galaxy/_bundles/manifest.json. Este archivo se genera automáticamente cada vez que corrés el build y contiene el conteo de componentes por categoría. El renderer lo lee al inicializar y actualiza los badges del sidebar.
No, por tres razones: (1) se sirven comprimidos con gzip/brotli — varios MB quedan en cientos de KB; (2) el browser solo pide el bundle de la categoría que abrís, nunca los 11 juntos; (3) el renderizado es lazy — 24 cards a la vez con IntersectionObserver, no todas de una vez en el DOM.
nav.js es el controlador central: escucha clics en el sidebar, activa la sección correcta, dispara la inicialización lazy de cada renderer, y expone window.UI_NAV con métodos como .go(), .galaxyTab() y .kbDoc(). Debe ir último porque necesita que todos los renderers (window.GALAXY_RENDERER, window.KB_RENDERER, etc.) ya estén definidos cuando se inicializa.
Usá la API pública de window.UI_NAV:
// Ir a una sección window.UI_NAV.go('kb-mc') // 'guide' | 'addons' | 'templates' | 'kb-mc' | 'kb-web' // Cambiar tab dentro de Galaxy window.UI_NAV.galaxyTab('cards') // Abrir un doc de KB window.UI_NAV.kbDoc('mc', 'mc-02') // Escuchar cambios de sección window.UI_NAV.on('change', (from, to) => console.log(to))
Cuatro pasos:
  1. Agregá el link en el sidebar: <a class="ui-nav-item" data-section="mi-seccion">
  2. Creá el elemento en main: <section id="section-mi-seccion" class="ui-section">
  3. Registrá el ID en el array SECTIONS de nav.js
  4. Creá el renderer en js/mi-renderer.js e incluidlo antes de nav.js
Casi siempre es caché del navegador. Corré python bump_cache_version.py --apply desde la raíz del proyecto — recalcula el hash de contenido de cada asset y actualiza el ?v= en todos los HTML que lo referencian, así el navegador lo trata como una URL nueva y lo vuelve a descargar. Ver Cache-busting.
Es el mecanismo que evita que el CSS de un componente "se escape" y afecte al resto de la página. Cada caja de preview tiene un data-comp-scope="gscope-<id>" único, y su CSS se reescribe para que cada selector empiece con [data-comp-scope="..."] — así .btn se vuelve [data-comp-scope="gscope-X"] .btn, que solo matchea dentro de esa caja. Lo genera el build para el CSS de cada componente, y el mismo mecanismo (scopeCSS()) se usa en vivo para el editor de código. Ver también Estructura del proyecto → fix_scoped_css.py.
Galaxy

Galaxy Componentes

+2800 snippets de HTML/CSS listos para copiar. Botones, cards, inputs, loaders y mucho mas.

2K+Componentes
11Categorias
100%Copy-paste
Galaxy

Galaxy Plantillas

Paginas web completas listas para deployar. Minecraft, Hosting, Portfolios, Dashboards.

12Plantillas
4Categorias
DeployReady
¿Buscás las plantillas para clientes?

Estas de acá son plantillas de página para desarrollo (Galaxy). Las 24 plantillas de negocio reales — con precios y editor con IA — viven en el catálogo público.

Ver catálogo de plantillas →
Cargando plantillas...
Recursos

Fondos de Video

Videos de fondo en loop, listos para usar como pantalla completa en cualquier sitio o plantilla — los mismos que usa el generador de sitios.

21Videos
MP4Formato
100%Copy-paste
Base de Conocimiento

Minecraft Técnico

Referencia completa: comandos, optimización, plugins, crashes. Válido para Vanilla, Spigot, Paper, Purpur.

12Guias
4Versiones
PaperCompatible
Base de Conocimiento

Hosting Web Avanzado

DNS, SSL, Nginx, Apache, VPS desde cero, panel de control completo y resolucion de problemas extremos.

16Guias
PanelIncluido
VPSReady
Base de Conocimiento

Panel Pterodactyl

Gestiona tu servidor Minecraft desde el panel de CostaCraft: consola, archivos, backups, schedules, SFTP y diagnóstico de errores.

2Guías
SFTPIncluido
2022Puerto SFTP
Base de Conocimiento

Email & SMTP

Configuración de correo, SPF/DKIM/DMARC, deliverability, WP Mail SMTP y diagnóstico de emails que van a spam.

SPFDKIM
DMARCIncluido
SMTPPanel
Base de Conocimiento

Desarrollo Avanzado

Git, CI/CD con GitHub Actions, Docker local, Node.js y PHP en hosting, APIs REST y webhooks.

4Guías
GitCI/CD
DockerLocal