Sizely

Sizely es un CLI que analiza métricas físicas reales del proyecto:

• Tamaño de archivos
• Cantidad de líneas
• Distribución por carpetas
• Reglas por tipo de archivo

Sizely no analiza frameworks.
No analiza patrones.
No necesita plugins.

Sizely mide hechos objetivos que impactan directamente la mantenibilidad del código.

¿Por qué existe Sizely?

En todos los proyectos pasa esto:

• Archivos que crecen sin control
• files con cientos de líneas
• JSON enormes en el frontend
• El repo “se siente pesado”, pero nadie sabe por qué

Sizely responde exactamente eso.

Instalación y uso

No necesitas instalar nada global.

npx fsizely

O si prefieres instalarlo en tu proyecto:

npm install fsizely --save-dev
npx fsizely

¿Qué obtienes al ejecutarlo?

Sizely te dice en segundos:

• Cuál es el archivo más pesado del proyecto
• Qué carpeta representa el mayor porcentaje del repo
• Qué archivos superan el límite recomendado de líneas
• Qué extensión domina tu proyecto

Configuración opcional — .sizelyrc.json

Si quieres personalizar reglas, crea este archivo en la raíz del proyecto:

{
  "useDefaultIgnoredDirs": true,

  "ignoreDirs": ["tmp"],
  "ignoreExtensions": [".png"],

  "displayFullPath": true,
  "topFiles": 10,

  "sizeRulesByExtension": {
    "ts": {
      "sizeMin": 1, // MB
      "sizeMid": 2, // MB
      "sizeMax": 3, // MB
      "messages": {
        "sizeMin": "Archivo pequeño",
        "sizeMide": "Archivo mediano",
        "sizeMax": "Archivo Grande"
      }
    }
  },

  "lineCountExtensions": [".ts"]
}

Descripción de propiedades

| Propiedad | Descripción | | ----------------------- | -------------------------------------------------------------------- | | useDefaultIgnoredDirs | Aplica carpetas ignoradas por defecto (node_modules, dist, etc.) | | ignoreDirs | Carpetas adicionales a ignorar | | ignoreExtensions | Extensiones que no se analizan | | displayFullPath | Muestra la ruta completa del archivo | | topFiles | Cantidad de archivos más pesados a mostrar | | sizeRulesByExtension | Límite de tamaño (MB) por tipo de archivo | | lineCountExtensions | Cantidad de líneas por tipo de archivo |

Ejemplos de salida

Archivo pesado detectado → user.service.ts (1.2 MB)
Este archivo representa el 12% del tamaño total analizado.

Líneas por encima del límite configurado → 322
Considera dividir el archivo para mejorar su mantenibilidad.

Carpeta dominante → src/app/user (38% del proyecto)

Filosofía

Sizely no juzga tu código. Mide su realidad física.