Paquete npm Open source
@tryonit/core — Núcleo sin dependencias del SDK TryOnIt
El núcleo TypeScript multiplataforma de mi SDK de prueba virtual: validación de manifiestos, máquina de estados, cálculos de seguimiento y filtros de suavizado.
Resumen
@tryonit/core es la base de TryOnIt, el SDK open source que creé para que los compradores vean maquillaje, gafas, joyas, relojes, color de pelo y ropa sobre sí mismos a través de la cámara. El núcleo reúne todo lo que no depende de un navegador, de modo que los paquetes web, React y React Native comparten una única implementación de las reglas en lugar de tres.
Está escrito en TypeScript puro, sin dependencias en tiempo de ejecución y sin DOM. Compila sin los tipos del DOM, acepta un fetch inyectable, nunca toca window, document ni navigator, y un test importa toda la API pública en un entorno Node sin globales del DOM. Esa disciplina es lo que permitió al paquete de React Native reutilizarlo sin cambios.
Incluye un pequeño constructor de esquemas que valida los manifiestos de producto para 15 tipos de assets con errores legibles indicados por ruta, junto con un JSON Schema que un test unitario mantiene sincronizado; un store inmutable con una máquina de estados finitos para la sesión de cámara; los cálculos de anclaje que convierten los puntos de MediaPipe en poses para el puente de la nariz, los lóbulos de las orejas, la muñeca y los dedos, con escala métrica basada en el iris; filtros de suavizado One Euro; y una deformación por homografía para la ropa. También incluye tryonit-validate, una CLI que comprueba los manifiestos y sus archivos GLB y PNG en CI. Una importación típica ocupa unos 5,9 KB min+gzip.
Funciones clave
- Validación en tiempo de ejecución de 15 tipos de producto con errores indicados por ruta
- JSON Schema para autocompletado, sincronizado con el validador mediante un test
- Store de sesión y máquina de estados compatibles con useSyncExternalStore
- Cálculos de anclaje de cara, manos y cuerpo con escala métrica basada en el iris
- Filtros de suavizado One Euro y deformación por homografía
- CLI tryonit-validate para comprobar catálogos de productos en CI
Artículos sobre este proyecto
-
7 min de lectura
How to Create Virtual Try-On Products with JSON Manifests
A practical guide to TryOnIt asset manifests: lipstick shades, makeup looks, face stickers, variants, CORS hosting, CMS or Shopify loading and CI validation.
-
8 min de lectura
Inside TryOnIt: The Architecture of a Client-Side Virtual Try-On SDK
How I structured an open-source virtual try-on SDK as layered TypeScript packages: a DOM-free core, a per-frame fast path, a state machine and renderers.
-
7 min de lectura
Preparing 3D Models for AR Try-On: Millimetres, Origins and glTF Export
How to model, orient and compress glasses, hats, earrings, watches and rings for web AR try-on: real-world units, anchor origins, Blender export, compression.
-
5 min de lectura
Shipping AR Try-On to React Native and Expo Go with a WebView Engine
Why @tryonit/react-native runs the web engine in react-native-webview, how the bridge works, and the native VisionCamera, Skia and Filament engine planned next.