N8Flare ⚡

💡 Why N8Flare?

Standard n8n workflows process webhooks, state machines, and chatbots on your central server (Node.js single-thread). Under traffic spikes, bursty WhatsApp webhooks, or slow third-party APIs, your n8n instance can experience queued executions, memory spikes, and webhook timeouts.

N8Flare solves this by compiling your workflow logic into high-performance ES Modules that run on Cloudflare's global edge network across 330+ cities worldwide.

✨ Key Features

• ⚡ Full V8 Edge Transpilation: Converts n8n Code nodes, conditional routers, and webhooks into modern Cloudflare Worker ES Modules.
• 💬 WhatsApp & Evolution API Optimized: Built-in anti-loop protection, admin self-testing support, and typing delay simulation.
• 🔄 Direct Third-Party Fetch on Edge: Execute authenticated API calls (e.g. Stripe, CRMs, ERPs, Webhooks) directly from Cloudflare V8 without hitting your host.
• 💾 Native Storage Bindings:
  • Cloudflare KV (SESSIONS): Ultra-fast key-value storage with automatic expiration TTL (replaces DataTables).
  • Cloudflare D1 (DB): Serverless SQL database for edge relational queries.
  • Cloudflare R2 (BUCKET): S3-compatible zero-egress object storage.
• 🧠 Built-in Workers AI: Integrates Meta Llama 3.1 8B Instruct directly into your conversational flow for intelligent natural language fallback.
• 🌐 Automated Custom Domains & SSL: Bind workflow.yourdomain.com in 1-click with automatic Cloudflare Universal SSL.
• 🛡️ Pre-Flight Audit Checklist: Automatically detects unreachable Docker/localhost URLs and warns before deployment.
• 🔐 Zero-Friction Secret Sync: Seamlessly syncs API keys, tokens, and credentials directly to Cloudflare encrypted secrets.

🛠️ Supported Operations

📦 Installation

Option 1: Visual Installation via n8n (Recommended)

1. Open your n8n instance.
2. Navigate to Settings > Community Nodes.
3. Click Install.
4. In the npm package name field, type:

   n8n-nodes-n8flare
   

5. Check the agreement box and click Install.

Option 2: Self-Hosted / Docker Installation

If you run n8n in Docker, add the package to your volume or Dockerfile:

# Inside your n8n data directory:
cd ~/.n8n/nodes
npm install n8n-nodes-n8flare

Restart your n8n container to load the node.

🔑 Quick Start Guide

1. Configure Cloudflare Credentials

1. Go to your Cloudflare Dashboard.
2. Copy your Account ID (found on the right sidebar under Workers & Pages).
3. Go to My Profile > API Tokens > Create Token.
4. Use the Edit Cloudflare Workers template, or grant:
   • Account - Cloudflare Workers - Edit
   • Account - Workers KV Storage - Edit
   • Zone - Workers Routes - Edit (optional, for Custom Domains)
5. In n8n, create a new Cloudflare (N8Flare) API credential and paste your Account ID and API Token.

2. Add N8Flare to Your Workflow

1. Add the N8Flare node to any workflow containing Webhooks or Chatbots.
2. Select Operation: Audit & Pre-Flight Checklist to review node compatibility.
3. Switch to Operation: Deploy to Cloudflare Edge and click Execute Step.
4. Your workflow is now running globally on:

   https://<worker-name>.<your-subdomain>.workers.dev
   

3. Attach Your Custom Domain (Optional)

1. Select Operation: Attach Custom Domain.
2. Type your domain: workflow.yourdomain.com (leave Zone ID blank for auto-discovery).
3. Click Execute Step — Cloudflare provisions SSL and DNS automatically.

🧩 Architecture

               ┌───────────────────────────────┐
               │    End User / WhatsApp / CRM   │
               └───────────────┬───────────────┘
                               │ HTTP Request (Sub-20ms)
                               ▼
            ┌─────────────────────────────────────┐
            │   Cloudflare Edge (330+ Cities)     │
            │  ─────────────────────────────────  │
            │       N8Flare Worker Runtime        │
            └───────┬──────────────┬──────────────┘
                     │              │
        KV Session Cache      Direct API Fetch
       (Sub-5ms Read/Write)   (Stripe, CRMs, ERPs, etc.)
             │                      │
             ▼                      ▼
     ┌───────────────┐      ┌───────────────┐
     │ Cloudflare KV │      │  External API │
     └───────────────┘      └───────────────┘
             │
             │ (Async Heavy Tasks / Sync Only)
             ▼
  ┌─────────────────────────────────────┐
  │       Central n8n Instance          │
  │  (Protected from peaks and spikes)  │
  └─────────────────────────────────────┘

💻 Local Development

# 1. Clone the repository
git clone https://github.com/amaurygomes/n8n-nodes-n8flare.git
cd n8n-nodes-n8flare

# 2. Install dependencies
npm install

# 3. Build TypeScript and copy assets
npm run build

# 4. Lint and check standards
npm run lint

👤 Author

Amaury Gomes Ibanez

• Website: amaurygomes.com.br / agnez.com.br
• Email: amaury_mju@hotmail.com
• GitHub: @amaurygomes

📄 License

This project is open-source and licensed under the MIT License.