magic-dev-documentation

# Magic Dev 5.0 – Official Documentation Welcome to the official documentation of Magic Dev 5.0! 📖 Magic Dev 5.0 - Complete Presentation with Introduction There are moments in life when everything shifts in a split second. For me, it was a March 2025 morning on a public works construction site. An accident. The kind that pins you to bed and forces you to rethink your entire existence. My name is Charles, I'm 34 years old, and until that fateful March day, I was a mason's assistant. My hands knew concrete, my muscles the fatigue of labor, and my daily routine followed the unchanging rhythm of construction sites. Then life offered me a forced break. Six months off work, six months pacing around my apartment in Les Salles-sur-Verdon. It's funny how boredom can sometimes be the best teacher. One evening, while wandering the internet, I stumbled upon something strange: n8n. Little boxes connected to each other, data dancing from one service to another, pure automation. I had the same revelation as a kid discovering LEGO for the first time. The nights began to fly by. 12 hours, 14 hours in front of the screen, as if I was playing the most addictive video game in the world. My fingers learned a new language, my neurons reconnected at breakneck speed. System architecture, biomimetics, automation... Everything mixed in my head into a creative symphony I had never felt on a construction site. And then Magic Dev was born. Not from a marketing plan, not from a commercial strategy. Just from the pure desire of a guy who had just discovered his true passion and wanted to share it with the whole world. A node that wouldn't just be a tool, but a playground, a meeting place, a collective adventure. 1300 downloads in 4 days. Apparently, I wasn't the only one dreaming of a more alive, more human, more... magical n8n ecosystem. This documentation isn't a cold technical manual. It's the story of a renaissance, of a growing community, and of a node that carries within it six months of sleepless nights and consuming passion. Welcome to the Magic Dev universe. 📚 Table of Contents Presentation and Prerequisites - Quick Without Blabla Technical Presentation Mode 🤖 AI Magic Generator Technical Presentation Mode 🎁 Creator Magic Hub Technical Presentation Mode 🔑 Quest Magic Unlock Market 📋 1. Presentation and Prerequisites - Quick Without Blabla Essential: manual trigger + n8n-nodes-magic-dev Presentation Mode 🗃️ Magic Market 🤖 Magic Mapping → A prompt, instance URL, N8N API key, OpenRouter API to teleport your workflow to your instance. 🎁 Creator Mapping → Instance URL, N8N API key and a random creator workflow teleports to your instance. 🔑 Quest Mapping → Instance URL, N8N API key, secret code found in Creator Mapping to win a premium workflow. 🗃️ Magic Market → PUBLISH: Share your workflows with description and public Google Sheets URL | SEARCH: Find workflows by keywords in our community-driven public link database. Help us build one of the largest open source workflow databases in the world! ⭐ FEEDBACK: Optional rating system (1-20 stars) + comments available in all modes 🤝 Creators: Want to collaborate? Contact me via Telegram @magicdev_bot! 💝 Donation: 0xfb1f5190Dd2498Cd25Db95d6b23C7145bc14E667 (multichain)`, 🤖 2. Technical Presentation Mode AI Magic Generator (Beta) The first blade of my digital Swiss knife. The one that made me understand that the boundary between dream and reality was thinner than I thought. What does it actually do? This mode helps builders who use AI to create their JSON code live easier lives. It transforms raw prompts into functional n8n workflows through intelligent automation. The concrete mechanism: Insert your instance URL, your n8n API key in create mode, your OpenRouter API key, execute the workflow, and behind the scenes a workflow acting as a backend receives a whole bunch of exploitable fields. 🗂️ Complete Field List (AI Magic Generator) Below is every field currently used by the AI Magic Generator mode, followed by a short description of its purpose. mode Defines the active node mode. For this feature the value is always "ai_generation". timestamp ISO-8601 date-time added when the request is built. Lets the backend sort and track requests chronologically. version Magic Dev package version that generated the request. Guarantees backward compatibility when the schema evolves. type Specifies what is being generated. In the example it is "ai_workflow". fieldSet Name of the logical field group being sent. For AI generation this is simply "ai". aiInstanceUrl Public URL of the n8n instance that will host / receive the finished workflow. aiApiKey Personal n8n API key (created in Owner → API). Authorises workflow creation inside your instance. aiOpenrouterKey Your OpenRouter key that unlocks access to GPT-4, Claude, Gemini, etc. The key is forwarded unchanged to OpenRouter. aiPrompt Natural-language instruction given to the AI (e.g. “LangChain agent with Google tools”). It is the heart of the request. aiComplexity Desired sophistication level. Accepts "basic", "intermediate" or "advanced" and steers the size / depth of the workflow returned. feedback.rating Integer between 0-20 allowing the user to grade the result quality. feedback.comments Free-text field for any comment you want to send back to improve the generator. feedback.mode Echoes the mode the user was in when leaving feedback (e.g. "ai_generation"). Useful when the same backend serves many modes. feedback.timestamp Date-time attached to the feedback object so ratings can be analysed over time. webhookUrl Public callback URL where asynchronous status updates will be pushed (long AI jobs, laarge file uploads, etc.). executionMode Tells the backend how to execute the workflow: "production", "test" or "dev". Enables throttling or sandboxing when needed. 🧠 AI Magic Generator Mode Goal: Transform a natural-language prompt into a fully functional n8n workflow using OpenRouter + intelligent formatting. 🔹 Step-by-Step Webhook Input Receives: aiPrompt, aiInstanceUrl, aiApiKey, aiOpenrouterKey, aiComplexity Timestamp Injection A DateTime node adds timestamp in Europe/Paris timezone. Golden Router Switch node checks mode === "ai_generation" Field Processor (processor_ai_generation) Cleans and structures fields into processedFields AI Agent (Golden_Dev) Uses LangChain/LLM with prompt constraints to return valid n8n workflow JSON Output Parser (parse_ai_generation) Cleans output and isolates the workflow_data object Workflow Teleportation (mapping_ai_generation) Sends workflow to user’s n8n instance using aiInstanceUrl + aiApiKey Google Sheets Logging (optional) Archives prompt, output, timestamps, feedback, and result data 🔐 Notes ExecutionMode, feedback.rating, webhookUrl, and complexity level can also be passed optionally Ideal for pro builders and automation architects 🎁 Creator Mode Goal: Instantly deliver pre-made workflows from the Magic Vault into any user’s n8n instance. 🔹 Step-by-Step Webhook Input Receives: creatorInstanceUrl, creatorApiKey Golden Router Checks mode === "creator_mapping" to activate this mode Vault Picker Selects a random or curated workflow from the Magic Vault (local, Google Sheet, or hosted list) Workflow Fetcher Downloads and validates the JSON Teleportation (creator_mapping) Sends the workflow to the user's n8n instance via API POST Feedback (optional) User can rate (0-20), comment, or interact with Creator Notes Logging Tracks deployed workflow, timestamp, user ID (anon or hash), feedback 🕵️ Hidden Clues for Quest Mode Some Creator Notes contain hidden clues – encrypted messages, keywords, or ciphers. If you find them and piece them together, you can unlock Quest Mode, where premium workflows are stored. 🔑 Quest Mode (Teaser) A secret mode, only unlocked with the correct password or sequence of clues hidden in the Creator Mode workflows. When unlocked, it grants access to: Exclusive workflows Special automations Rare utilities created by top community builders To unlock it, collect fragments from Creator workflows, observe the notes, and decode the logic behind them. Once you find the correct code — you’ll know. 🗃️ Magic Market Mode (Community Database) Goal: Create a community-driven open database of workflows, fully searchable and shareable. Features: Publish: Share your own workflows with title, description, and a public Google Sheets URL Search: Find workflows by keyword, category, creator, or theme Rate: Provide 1–20 star ratings and community comments This mode is designed to: Grow the world’s largest free n8n workflow database Encourage collaboration and discovery Archive and curate thousands of community solutions This mode is ideal for: Power users who want to contribute Beginners looking for examples Hackathons, open data competitions, and public service innovation Use the mode: "magic_market" to route into this logic. Submissions and searches both go through the same node family. 🤝 Community Share your own workflows via Magic Market Rate and comment on workflows Collaborate via @magicdev_bot on Telegram 💝 Donations Wallet (multi-chain): 0xfb1f5190Dd2498Cd25Db95d6b23C7145bc14E667 Magic Dev is more than a node. It’s a playground, a discovery engine, and a tribute to creative resilience. Let the magic begin.