flagraft
Servicio auto-alojado de feature flags para Node.js/TypeScript con base de datos PostgreSQL. Alternativa open source a LaunchDarkly/Unleash con SDK tipado, sin vendor lock-in y compatible con entornos air-gapped.
Ficha actualizada 24 sept 2026, 18:40 · upstream 24 sept 2026, 18:35 · release sin release detectada
Qué es flagraft
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Flagraft es una plataforma de gestión de feature flags auto-alojada diseñada para equipos de ingeniería que desarrollan en Node.js o TypeScript. Permite desplegar flags, interruptores de función, kill switches, pruebas A/B y lanzamientos canarios directamente sobre su propia infraestructura PostgreSQL, eliminando la dependencia de proveedores externos.
El sistema soporta estrategias de targeting contextual (por usuario, tenant, región) para habilitar características a subconjuntos específicos de llamadas. Incluye autenticación en tres niveles (root admin, project admin y client keys), caché en memoria con invalidación automática y limitación de tasa configurable. La interfaz administrativa está integrada y expone documentación OpenAPI/Swagger.
La arquitectura se basa en Fastify, Drizzle ORM, Zod y BentoCache, con soporte para migraciones automáticas al inicio. Se puede ejecutar como contenedor único o mediante Docker Compose, integrándose fácilmente en stacks existentes de Node/PostgreSQL sin necesidad de servicios externos.
- Kill switches y circuit breakers para deshabilitar características problemáticas en producción sin redeploy.
- Rollouts graduales y lanzamientos canarios habilitando features para subconjuntos de usuarios por userId, cohort o región.
- Infraestructura para pruebas A/B usando estrategias de targeting para dirigir cohorts a diferentes variantes.
- Rollouts por tenant en aplicaciones multi-tenant SaaS para gating por tier de pago o previews a clientes confiables.
- Desarrollo basado en trunk: fusionar características incompletas detrás de un flag y enviarlas dark hasta estar listas.
- Promoción de entornos: mantener estado de flags separado para development, staging y production sin duplicar configuración.
- Sin vendor lock-in: los datos y la base de datos son propios, con control total del uptime.
- Compatible con entornos air-gapped o regulados al ejecutarse en una sola instancia PostgreSQL y un proceso Node sin dependencias externas.
- SDK TypeScript oficial (@flagraft/sdk) con tipado completo para integraciones seguras.
- Modelo de precios nulo: open source bajo licencia MIT, sin coste por asiento ni por flag.
- Targeting contextual nativo: evaluación de flags basada en contexto (user ID, tenant, plan, región, cohort).
- Importación desde Unleash: lector unidireccional para migrar configuraciones existentes sin reingresar manualmente cada flag.
- Dependencia exclusiva de PostgreSQL como base de datos; no soporta otros sistemas de almacenamiento.
- Migraciones forward-only sin down path; requiere backup antes de actualizar el esquema.
- Requiere configuración manual de variables de entorno seguras (JWT_SECRET, contraseñas) en despliegues iniciales.
- El SDK JS está marcado como alpha en los badges del repositorio; verificar estabilidad antes de producción crítica.
- No incluye analíticas externas ni estrategias de rollout por porcentaje predefinidas fuera del roadmap.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Usar Docker Compose para despliegue simplificado con PostgreSQL. Configurar DATABASE_URL, JWT_SECRET y DEFAULT_ADMIN_PASSWORD en variables de entorno antes del primer inicio. Detrás de reverse proxy (nginx), establecer TRUST_PROXY=1 para contar IPs reales en rate limiting. Terminar TLS en el proxy inverso y no separar UI/API en hostnames distintos para evitar problemas con cookies SameSite=Strict.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.