# MonoPix
|
|
|
Funciona sobre [`fast-pixelizer`](https://github.com/handsupmin/fast-pixelizer).
**Nota sobre la calidad de entrada**
Las imágenes “estilo pixel art” generadas por ChatGPT suelen ser una mala entrada para Snap. Pueden verse pixeladas, pero la imagen original muchas veces ya trae celdas con anchos y altos desiguales, bordes suaves y ejes ligeramente desviados. Snap puede regularizar el resultado, pero no puede garantizar una recuperación perfecta si la cuadrícula original ya era inconsistente.
Si vas a generar imágenes nuevas específicamente para Snap, recomendamos Nano Banana o cualquier flujo que conserve desde el inicio una cuadrícula cuadrada de baja resolución de forma más estable.
---
## Funcionalidades
- **Snap** — Reconstruye pixel art "falso" generado por IA en pixel art real. Detección automática de cuadrícula, preserva transparencia
- **Recorte** — Editor de relación de aspecto 1:1 con arrastre y zoom
- **Limpio (Clean)** — Usa el color más frecuente en cada celda. Bordes nítidos y estilo gráfico. De 8×8 a 256×256
- **Detalle (Detail)** — Usa el color promedio de cada celda. Degradados más suaves y mayor textura
- **Comparar** — Vistas antes / después / comparación dividida
- **Descargar** — Exporta como PNG manteniendo el tamaño original o ajustando a la resolución seleccionada
- **Historial** — Los últimos 10 resultados guardados localmente en tu navegador
- **Multiidioma** — Inglés, coreano, japonés, chino simplificado, español
Todo el procesamiento ocurre en un Web Worker. Nada sale de tu dispositivo.
---
## Ejemplo
| Original | Limpio | Detalle |
| -------------------------------------------------------------------- | ----------------------------------------------------------------- | ------------------------------------------------------------------- |
|
|
|
|
**Limpio (Clean)** toma el color más frecuente en cada celda — bordes nítidos y estilo gráfico.
**Detalle (Detail)** promedia todos los colores en cada celda — degradados más suaves y más textura.
---
## Cómo empezar
**Requisitos:** Node.js 18 o superior
```bash
git clone https://github.com/handsupmin/mono-pix.git
cd mono-pix
npm install
npm run dev
```
Abre [http://localhost:5173](http://localhost:5173).
---
## Scripts
| Comando | Descripción |
| ------------------ | -------------------------------- |
| `npm run dev` | Iniciar servidor de desarrollo |
| `npm run build` | Build de producción |
| `npm run preview` | Vista previa del build |
| `npm run lint` | Ejecutar ESLint |
| `npm run lint:fix` | Corregir errores automáticamente |
| `npm run format` | Formatear con Prettier |
---
## Stack
[React 19](https://react.dev) · [TypeScript 5.9](https://www.typescriptlang.org) · [Vite](https://vite.dev) · [Tailwind CSS v4](https://tailwindcss.com) · [shadcn/ui](https://ui.shadcn.com) · [Zustand](https://zustand-demo.pmnd.rs) · [fast-pixelizer](https://github.com/handsupmin/fast-pixelizer) · [Dexie.js](https://dexie.org) · [react-easy-crop](https://github.com/ValentinH/react-easy-crop) · [react-i18next](https://react.i18next.com)
---
## Contribuir
¡Las contribuciones son bienvenidas! Haz fork del repositorio, crea una rama y abre un PR.
```bash
npm run lint:fix # corregir errores de lint
npm run format # formatear código
npm run build # verificar que el build pasa
```
---
## Apoyo
Si te gusta MonoPix, invítame un café!
[](https://ko-fi.com/handsupmin)
---
## Licencia
MIT