Figma Registry

Registro de Figma como SSOT visual del monorepo. Los archivos de módulo viven junto al código de cada app como figma.json; el schema está en schema/module.schema.json y los aliases compartidos en data/files.json.

Agregar una entrada

1. Leer el figma.json del módulo antes de modificar una vista o componente.
2. Copiar el link al frame o componente en Figma. El valor node-id=123-456 se guarda como 123:456.
3. Agregar la entrada en views, flows o components según corresponda.
4. Usar el alias de data/files.json; nunca repetir un fileKey directamente en los módulos.
5. Agregar paths relativos al root del repositorio. Usar TODO si falta una referencia y completarla luego.
6. Ejecutar pnpm figma:check.

La URL se puede generar con figmaUrl({ fileKey, name }, '123:456'); el helper convierte el node ID a 123-456 únicamente en la URL.

Validación

pnpm figma:check

El check falla por schema inválido, IDs duplicados, referencias inexistentes, paths ausentes o aliases de archivo desconocidos. Las entradas TODO se reportan como warnings.

El registro actual usa el archivo NIDUS con alias nidus y file key n0si7B3Rq3YsXUdLCeaaPQ.