Skip to content
View juanisidoro's full-sized avatar

Block or report juanisidoro

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
juanisidoro/README.md

Juan Isidoro (Isi)

Full Stack Engineer specialized in:
→ Scalable event-driven architectures
→ Real-time e-commerce data synchronization
→ AI-powered application optimization

I build systems that simplify technical complexity and improve developer experience.


Currently Working On

🔐 Scaling SecureCode HQ — secrets management platform for AI agents
🏗️ Building MyEasyStack — developer PaaS on Hetzner with multi-tenant provisioning
🏗️ Building CTY — multi-tenant e-commerce platform with event-driven architecture
🔬 Evolving MAKO — open specification for LLM content optimization
🧠 Integrating AI into automation workflows and content generation


SecureCode HQ — Secrets Management for AI Agents

Status npm

Problem: AI coding agents like Claude Code need access to secrets and APIs, but exposing credentials directly creates critical security risks.

Solution: Secrets management platform with a native MCP server, allowing AI agents to access credentials securely without ever exposing them in plaintext.

Architecture: Envelope encryption with Google Cloud KMS

AI Agent (Claude Code)
   ↓ MCP Server
SecureCode HQ
   ↓ KEK/DEK Envelope Encryption
Google Cloud KMS
   ↓ Decrypted on demand
Your APIs & Services

Tech Stack:

  • Backend: Node.js, TypeScript, Firebase Functions
  • Security: Google Cloud KMS, TOTP/2FA, JWT, envelope encryption (KEK/DEK)
  • Distribution: npm SDK, Chrome Extension, MCP Server
  • Frontend: Next.js, TailwindCSS

Key Features:

  • Native MCP server for Claude Code integration
  • Envelope encryption: secrets never stored in plaintext
  • TOTP/2FA for agent approval flows
  • Tag-based secret organization with visual hierarchy
  • npm-published SDK for programmatic access

Traction: Organic post reached ~239K views on Reddit (r/ClaudeAI)

Publicly launched and actively maintained


Featured Projects

CTY (CommerToYou) — Multi-CMS E-commerce Platform

Status

Problem: Online store owners manually manage catalogs across multiple platforms (WooCommerce, PrestaShop) without technical expertise.

Solution: Centralized product management system with automatic bidirectional multi-CMS synchronization.

Architecture: Clean Architecture + DDD + CQRS + Event Sourcing

Product Catalog (Central Source)
   ↓ Domain Events
Event Bus (Firebase)
   ↓ Event Handlers
Sync Workers
   ↓ Bidirectional Webhooks
WooCommerce | PrestaShop | Shopify
   ↓ Real-time updates
Observability Layer (Grafana Cloud)

Tech Stack:

  • Frontend: Next.js, React, TypeScript, Tailwind CSS
  • Backend: Node.js, Firebase Functions, Firestore
  • Observability: Grafana Cloud, distributed tracing
  • Integrations: WooCommerce REST API, PrestaShop WebService, custom webhooks

Key Features:

  • Zero-friction interface for non-technical users
  • Bidirectional real-time synchronization
  • Event system with replay capability
  • Multi-tenant with per-tenant data isolation
  • Complete observability: traces, logs, metrics
  • Robust error handling and automatic retries

AI Integrations (in progress):

  • Automatic product description generation
  • AI-assisted SEO optimization
  • Intelligent catalog categorization

Actively in development - sync architecture operational


MAKO — Markdown Agent Knowledge Optimization

Spec npm

Problem: Traditional HTML is inefficient for LLMs — high token consumption, semantic noise, unoptimized structure.

Solution: Open specification based on HTTP content negotiation that delivers structured content for AI agents.

Result: ~93% fewer tokens compared to standard HTML.

Client (LLM Agent)
   ↓ Accept: text/mako+markdown
Server
   ↓ YAML frontmatter + Clean Markdown
Response
   → 93% token reduction
   → Structured metadata
   → Actionable navigation
Repository Description
mako-spec Complete specification
mako-js TypeScript SDK
mako-cli CLI tool
mako-site Analyzer, Score & Directory
mako-wp WordPress plugin

Impact: Reduces API costs in RAG applications and improves response accuracy by eliminating HTML noise.


FireSchema — Firebase Schema Viewer

Demo

Problem: Firestore lacks visual schema documentation, making team collaboration difficult.

Solution: Open-source visualizer that auto-discovers .schema.json files and renders interactive documentation.

Features:

  • Static SPA, zero-backend, deployable on any CDN
  • JSON Schema 2020-12 standard
  • Automatic mapping of folder structure to Firestore collections
  • Schema generation via LLM prompts

Philosophy

I build systems that:

  • Reduce entropy — Clear interfaces over unnecessary complexity
  • Scale cognitively — Architectures teams can understand
  • Prioritize experience — For both developers and end users

Tech Stack

Frontend
Next.js · React · TypeScript · Tailwind CSS

Backend & APIs
Node.js · Firebase (Auth, Firestore, Functions, Storage) · PostgreSQL

Architecture & Patterns
Clean Architecture · DDD · CQRS · Event Sourcing · Multi-tenant · Webhooks

Observability
Grafana Cloud · Distributed Tracing · Structured Logging

E-commerce Integrations
WooCommerce REST API · PrestaShop WebService · Custom Webhooks

AI & Optimization
LLM Content Optimization · RAG Pipelines · Prompt Engineering


Additional Background

Digital Marketing & Product
Experience in multi-channel campaigns and web analytics — I understand the business behind the code

Industrial Automation
STEP7 (Siemens) · SCADA · Process control — background in mission-critical systems

Hardware & IoT
Arduino · Circuit design · Hardware-software integration


Beyond Code

CrossFit · Continuous learning · Intentional building

I combine technical rigor with product vision. I care about both system architecture and real user impact.


Connect

LinkedIn Email GitHub


💡 Open to remote full-stack and backend roles — securecodehq.com · makospec.vercel.app

Pinned Loading

  1. Guía paso a paso para desplegar un p... Guía paso a paso para desplegar un proyecto backend con Node.js en un servidor VPS de Clouding.io, incluyendo instalación de dependencias, configuración de PM2, Nginx, dominio personalizado, HTTPS con Certbot y solución de errores comunes.
    1
    # 📦 Despliegue de Proyecto Node.js en Clouding.io (Resumen Completo)
    2
    
                  
    3
    Este documento resume todos los pasos, comandos y decisiones tomadas para desplegar exitosamente un backend Node.js en un servidor VPS de Clouding.io con HTTPS y dominio personalizado.
    4
    
                  
    5
    ---
  2. How to Use Custom SSL Certificates i... How to Use Custom SSL Certificates in Node.js with Bright Data (Guía en Español + English Guide)
    1
    # ✅ Cómo usar certificados SSL personalizados en Node.js para conexiones seguras con proxies (Bright Data)
    2
    
                  
    3
    ## 📝 Contexto
    4
    
                  
    5
    Al hacer peticiones HTTPS usando proxies como los de **Bright Data**, es necesario que Node.js confíe en los certificados SSL utilizados por esos proxies. En muchos casos, obtendrás errores como: