Localflare: Un panel local práctico para Cloudflare Workers

¿Estás cansado de depurar tus Cloudflare Workers sin una interfaz visual? Localflare resuelve ese problema al ofrecerte un panel en tiempo real y sin configuración para todo lo que se ejecuta dentro de tus Workers: de bases de datos D1 a espacios de nombres KV y cubos R2, todo sin modificar tu código.

¿Qué es Localflare?

Localflare es una herramienta CLI que lanza un worker local junto con un ligero worker API. La API sirve un panel React intuitivo alojado en studio.localflare.dev. Cuando tu worker se ejecuta en http://localhost:8787, el panel descubre automáticamente tu wrangler.toml, crea APIs en __localflare/*, y ofrece una interfaz de un solo toque para:

• Estudio de Base de Datos D1 – editor SQL completo, edición en línea, operaciones masivas, generación de datos ficticios.
• Navegador KV – ver, editar, borrar pares clave‑valor.
• Administrador de Archivos R2 – subir, descargar y gestionar objetos.
• Inspector de Colas – enviar mensajes de prueba y ver el estado de la cola.
• Objetos Durables – inspeccionar el estado de la instancia y enviar solicitudes.
• Enlaces de Servicio – proxy automático.

Sin SDK, sin modificaciones de código – simplemente ejecuta localflare en tu carpeta de proyecto.

Guía de Inicio Rápido

1. Navega a tu proyecto Workers:

cd /path/to/your-worker

1. Instala Localflare globalmente (también puedes usar npx):

npm i -g localflare
# o
pnpm add -g localflare

1. Ejecuta Localflare:

localflare

Localflare hará:

• Leer tu wrangler.toml
• Iniciar tu worker en http://localhost:8787
• Abrir el panel en https://studio.localflare.dev

Si prefieres usar solo la línea de comandos (sin abrir el navegador automáticamente), utiliza:

localflare --no-open

Personalización del Puerto

localflare --port 9000

El panel detectará automáticamente el nuevo puerto del worker.

Pasar Opciones de Wrangler Directamente

¿Quieres ejecutar un entorno específico o establecer variables de entorno? Usa -- para reenviar argumentos:

localflare -- --env staging
localflare -- --var API_KEY:secret

Combina varias opciones según necesites:

localflare --port 9000 -- --env production --remote

Modo de Adjunción – Ideal para Next.js, Remix u Otros Marcos

Cuando tu pila de desarrollo lanza un servidor separado (por ejemplo, pnpm dev), Localflare puede adjuntarse a ese proceso existente, manteniendo compartidos tus enlaces.

1. Terminal 1 – ejecuta tu servidor de desarrollo

pnpm dev   # o opennext dev, nuxt dev, etc.

1. Terminal 2 – lanza la API de Localflare

localflare attach

La API escuchará en http://localhost:8788. También puedes cambiar el puerto de la API:

localflare attach --port 9000

Solución de Problemas en Navegador

Los navegadores modernos a veces bloquean las conexiones de studio.localflare.dev a localhost:8787. Así es como desbloquearlas:

Chrome / Chromium – Activa Acceso a red local en el cuadro de diálogo de información del sitio y actualiza.

Safari / Brave – Instala mkcert, genera una CA local y reinicia tu navegador.

Alternativa Brave – Desactiva los Escudos para studio.localflare.dev.

Enlaces Soportados de un Vistazo

Todas las funciones listadas arriba están disponibles fuera de la caja con cero configuración.

¿Por qué Localflare?

• Sin configuración – lee automáticamente wrangler.toml.
• Enlaces reales – sin simulaciones; los datos provienen de tu entorno de desarrollo en vivo.
• Multiframework – funciona con Next.js, Remix, Nuxt, Astro, SvelteKit y Workers sin framework.
• Amigable para desarrolladores – edición en línea, generación de datos ficticios, editor SQL, arrastrar y soltar.
• Código abierto – bajo licencia MIT, impulsado por la comunidad. Considera patrocinar para mantener el proyecto vivo.

Obtener Ayuda y Contribuir

• Documentación: https://github.com/rohanprasadofficial/localflare
• Issues de GitHub: envía errores o solicitudes de funciones.
• Patrocinio: https://buy.stripe.com/9AQ8e7l6f2aG4g6gII (opcional pero apreciado)

Resumen

Localflare elimina un punto importante de fricción en el desarrollo de Workers: ahora puedes inspeccionar, editar y probar cada recurso enlazado mientras ejecutas tu código localmente. Es una configuración rápida, un conjunto robusto de funciones y una adaptación perfecta para cualquiera que esté construyando en Cloudflare Workers.

¿Listo para probarlo? Clona el repositorio, instala la CLI y observa cómo tu panel local cobra vida en segundos. ¡Diviértete programando!