Getting started

Instala Ally en cualquier sitio web

Carga el CSS y JavaScript publicados en Cloudflare Pages. Usa este origen HTTPS y los hashes SRI que aparecen en el bloque generado.

Distribución pública de Ally

Para el despliegue actual, carga los archivos estáticos de dist/ desde el sitio Ally. El bloque agrega Subresource Integrity (SRI) y CORS para detectar cualquier archivo que no coincida con este release.

Base pública activa: https://ally.accessibility.cl/dist

HTML · Cloudflare Pages + SRI
<link rel="stylesheet" href="https://ally.accessibility.cl/dist/ally.min.css">
<script defer src="https://ally.accessibility.cl/dist/ally.min.js" crossorigin="anonymous"></script>
Importante: no uses cdn.accessibility.cl/ally/1.3.0; actualmente esa ruta no publica los archivos de Ally. La ruta activa es https://ally.accessibility.cl/dist/. Si el navegador aún muestra el snippet antiguo, hay que volver a publicar el paquete actualizado.

Publicación desde GitHub

Como alternativa, si el repositorio público y el tag están configurados, los archivos pueden servirse desde GitHub Pages o jsDelivr.

Repositorio detectado/configurado: Configura OWNER/REPO antes del release.

HTML · URL del despliegue
<link rel="stylesheet" href="https://OWNER.github.io/REPO/dist/ally.min.css">
<script defer src="https://OWNER.github.io/REPO/dist/ally.min.js"></script>

Antes de crear el tag de release, configura el repositorio una sola vez:

npm run release:configure -- --github OWNER/REPO
npm run build
npm run release:check

Ally Debug por URL pública

Carga el auditor únicamente en desarrollo o QA. No hace falta para el funcionamiento de los componentes.

HTML
<script defer src="https://ally.accessibility.cl/dist/ally.debug.min.js"></script>

Instalación con npm

Cuando ally-accessibility esté publicado en npm, los equipos con bundler pueden consumir los exports públicos.

Terminal + JavaScript
npm install ally-accessibility

import 'ally-accessibility/css';
import Ally from 'ally-accessibility';

Ally.init();

También hay hojas CSS separadas para reducir la carga en proyectos que seleccionan manualmente el CSS:

import 'ally-accessibility/grid';
import 'ally-accessibility/utilities';
import 'ally-accessibility/components-css';

Personalizar colores y descargar ZIP

No edites componentes uno por uno. Elige un solo color Primary: Ally genera automáticamente complementario, Success, Info, Warning y Danger, crea escalas 50–950, ajusta tokens funcionales para contraste AA/AAA y empaqueta un build personalizado.

Abrir Ally Customizer

Archivos locales descargados

Solo si copiaste dist/ físicamente dentro de tu sitio corresponde usar rutas relativas:

HTML · local
<link rel="stylesheet" href="./dist/ally.min.css">
<script defer src="./dist/ally.min.js"></script>
Importante: este bloque local no sirve para cargar Ally desde otro dominio. Para eso usa el bloque CDN público de arriba.

Compatibilidad de navegador

Ally apunta a las dos versiones mayores más recientes de Chrome, Edge, Firefox, Safari y iOS Safari. Internet Explorer no forma parte del soporte. El bundle CDN es IIFE clásico; el módulo ESM queda separado para bundlers.

El CSS utiliza mejoras progresivas: container queries están protegidas con @supports; backdrop-filter no es necesario para operar; y los estilos críticos incluyen fallback antes de color-mix().

Ver matriz y política cross-browser

Archivos públicos de distribución

RutaUso
dist/ally.min.cssFramework CSS completo para producción.
dist/ally.min.jsBundle IIFE clásico para <script defer>.
dist/ally.esm.jsMódulo ES para bundlers.
dist/ally.debug.min.jsAuditor y overlay para desarrollo/QA.
dist/ally-grid.cssTokens, reset y grilla responsive con columnas.
dist/ally-layout.cssTokens, reset y layout sin utilidades ni componentes.
dist/ally-utilities.cssTokens, reset, layout y utilidades comunes.
dist/ally-components.cssTokens, estilos de componentes, formularios y utilidades.
dist/ally-debug.cssTokens y estilos del panel Ally Debug.
dist/ally-tokens.cssReferencia de tokens públicos.
dist/ally-theme.cssPlantilla de override de tema.
dist/ally.color.jsMotor ESM para generación programática de paletas accesibles.
dist/integrity.jsonHashes SRI SHA-384 del release.
dist/distribution.jsonURLs y metadata pública del release.