Files
upstream-watermill/docs/content/learn/_index.md
2026-09-15 21:27:46 +05:00

11 KiB

title, description, date, lastmod, draft, layout, hideBanner, seo, learning_options, deeper_options
title description date lastmod draft layout hideBanner seo learning_options deeper_options
Learn Watermill Resources to help you learn and master Watermill for building event-driven applications in Go. 2024-09-15T10:00:00+00:00 2024-09-15T10:00:00+00:00 false learn true
title description canonical noindex
Learn Watermill - Go Event-Driven Applications Complete learning resources for Watermill - guides, examples, and community resources for building event-driven applications in Go. false
title subtitle description link new icon
Watermill Quickstart Code along Learn how to build an event-driven application in Go, coding in your own IDE. /learn/quickstart/ true <svg width="100" height="100" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1000 1000" xmlns="https://vecta.io/nano" fill="#4f46e5"><path d="M893.54 441.92c-9.43-29.13-36.33-48.69-66.92-48.69-7.4 0-14.73 1.16-21.8 3.47l-1.94.63c-17.7-27.35-40.36-51.5-66.65-70.87-26.94-19.83-57.49-34.48-89.68-43.12v-2.46c0-18.76-7.29-36.42-20.55-49.72l-.02-.03-.03-.03c-13.29-13.28-30.97-20.6-49.78-20.6-35.39 0-64.76 26.25-69.66 60.31-44.4-1.33-90.31 8.95-133.08 22.87l-10.67 3.58c-66.59 23.06-95.08 10.97-95.08 10.97 33.94 37.66 112.52 24.38 104.24 52.8-7.78 26.67-34.62 13.96-49.94 8.16-31.64-11.97-63.53-23.49-97.94-19.13-22.08 2.8-41.43 13.38-62.09 23.03-22.82 10.65-46.1 20.06-70.05 25.39-9.85 2.18-19.78 3.85-29.72 4.58-2.36.17-8.11 1.68-10.29.34 13.97 8.61 31.16 12.14 46.79 14.74 18.3 3.04 36.83 3.72 55.46 2.7 19.61-1.07 39.69-1.46 57.33 8.62 9.43 5.39 26.36 18.78 17.15 33.8l-5.17 1.45c-16.14 4.54-33.47 3.23-49.46 8.28-116.96 36.95-155.25 97.03-155.84 97.97.69-.4 32.72-18.83 95.33-14.59 50.6 3.42 98.2 26.99 142.35 53.27 61.34 36.51 61.27 60.33 96.42 105.61.83 1.06 3.71 4.1 7.59 8.02-4.56 9.45-6.92 19.78-6.92 30.44 0 22.48 10.86 43.78 29.05 56.98a69.93 69.93 0 0 0 41.32 13.42c22.46 0 43.76-10.85 56.97-29.02l.4-.55c30.54 11.66 63.27 17.73 96.15 17.73 21.99 0 43.87-2.66 65.02-7.91a266.69 266.69 0 0 0 30.72-9.64l.27.38c13.17 18.16 34.47 29.02 56.96 29.02 14.91 0 29.19-4.65 41.3-13.43 31.41-22.81 38.41-66.91 15.63-98.32l-.31-.43c15.41-19.08 28.08-40.13 37.82-62.85 14.36-33.52 21.64-69.13 21.64-105.87a270.59 270.59 0 0 0-.26-11.75l2.77-.9c29.1-9.5 48.63-36.38 48.63-66.92 0-7.33-1.16-14.65-3.46-21.73zm-56.3 54.41l-30.31 9.86a234.23 234.23 0 0 1 2.93 37.03c0 65.1-26.7 123.99-69.77 166.24l17.48 24.05c11.15 15.38 7.74 36.88-7.62 48.03a34.72 34.72 0 0 1-8.48 4.52c-.79.28-1.59.54-2.39.77s-1.62.43-2.43.59a30.94 30.94 0 0 1-1.63.29c-.43.07-.87.12-1.31.18-.87.1-1.75.17-2.62.2-.43.02-.87.03-1.31.03a33.72 33.72 0 0 1-5.94-.52 41.01 41.01 0 0 1-2.92-.64 32.36 32.36 0 0 1-2.85-.89 34.17 34.17 0 0 1-16.13-12.14l-17.45-23.99c-32.19 16.83-68.82 26.33-107.68 26.33a234.53 234.53 0 0 1-38.66-3.19c-24.67-4.12-48.03-12.12-69.44-23.35l-16.48 22.69-1.09 1.51c-6.74 9.27-17.22 14.18-27.85 14.18-.88 0-1.75-.03-2.63-.1-6.14-.47-12.22-2.59-17.56-6.47-9.27-6.72-14.18-17.21-14.18-27.83 0-1.02.05-2.04.14-3.06.53-6 2.64-11.92 6.43-17.14l17.7-24.35c-42.87-42.26-69.43-100.99-69.43-165.94 0-12.66 1.02-25.06 2.95-37.18l-28.68-9.33c-14.54-4.73-23.76-18.21-23.76-32.72 0-3.52.54-7.09 1.68-10.63 1.03-3.18 2.48-6.1 4.27-8.73.51-.75 1.05-1.48 1.61-2.17.85-1.06 1.75-2.06 2.71-2.99l.97-.92c.33-.3.67-.59 1.01-.88.68-.57 1.38-1.11 2.1-1.63 1.8-1.28 3.73-2.4 5.74-3.32a40.61 40.61 0 0 1 2.45-1.01c6.99-2.56 14.85-2.89 22.47-.4l28.29 9.19c33.04-67.19 97.5-116.14 174.22-127.7v-31.92a34.18 34.18 0 0 1 .56-6.19c2.91-16.04 16.96-28.19 33.82-28.19a34.26 34.26 0 0 1 24.32 10.06c6.22 6.24 10.06 14.82 10.06 24.32v31.74c8.32 1.2 16.51 2.85 24.52 4.91 66.44 17.07 121.41 62.73 151.05 123.1l29.85-9.7a33.08 33.08 0 0 1 2.66-.75 35.57 35.57 0 0 1 2-.42 34.47 34.47 0 0 1 2-.3c4.08-.48 8.13-.21 11.99.72.86.2 1.71.44 2.56.72h.01c1.68.54 3.32 1.22 4.89 2.02.4.19.79.4 1.19.62a41.1 41.1 0 0 1 1.43.84 31.49 31.49 0 0 1 2.73 1.88c.44.33.87.68 1.29 1.04h.01c.51.43 1.01.87 1.5 1.33a16.11 16.11 0 0 1 .72.71 28.67 28.67 0 0 1 2.04 2.23c.44.52.85 1.05 1.25 1.59.54.72 1.05 1.48 1.53 2.25 1.45 2.33 2.64 4.87 3.52 7.6 1.15 3.54 1.71 7.13 1.71 10.64 0 14.5-9.25 27.94-23.76 32.68zM448.12 659.39c-28.89-31.94-44.78-73.14-44.78-116.17 0-5.96.3-11.82.88-17.46l92.99 30.22a79.49 79.49 0 0 0 8.17 24.6l-57.26 78.81z"></path><path d="M405.09 527.1l91.23 29.65a80.59 80.59 0 0 0 7.88 23.75l-56.17 77.31c-28.2-31.62-43.7-72.22-43.7-114.58 0-5.49.25-10.9.75-16.12m-1.72-2.68c-.69 6.16-1.02 12.45-1.02 18.79 0 45.34 17.39 86.7 45.87 117.75l58.35-80.31c-4.18-7.79-7.08-16.37-8.45-25.44l-94.75-30.79h0zm173.45 192.26c-24.97 0-49.05-5.21-71.6-15.5l57.16-78.68a80.54 80.54 0 0 0 14.44 1.31c4.82 0 9.38-.41 13.92-1.21l57.26 78.78c-22.4 10.15-46.35 15.29-71.18 15.29z"></path><path d="M562.81 623.6c4.62.81 9.33 1.22 14 1.22s9.07-.37 13.48-1.11l56.17 77.28c-21.95 9.76-45.37 14.7-69.65 14.7s-47.98-5.01-70.07-14.9l56.07-77.18m-.88-2.2l-58.25 80.18c22.26 10.34 47.05 16.1 73.13 16.1s50.58-5.68 72.71-15.89l-58.35-80.28c-4.66.86-9.45 1.3-14.36 1.3s-10.06-.49-14.88-1.41h0zm86-39.97a80.2 80.2 0 0 0 8.14-24.96l92.79-30.98c.62 5.71.96 11.52 1.01 17.3.36 43.22-15.31 84.68-44.13 116.87l-57.81-78.23z"></path><path d="M748 526.84c.54 5.28.83 10.64.87 15.96.35 42.56-14.92 83.4-43.06 115.28l-6.35-8.59-50.36-68.15c3.88-7.6 6.52-15.7 7.86-24.11l71.68-23.93 19.35-6.46m1.73-2.68l-21.7 7.25-72.84 24.32a79.13 79.13 0 0 1-8.42 25.8l51.1 69.15 7.81 10.57c28.42-31.31 45.58-72.97 45.21-118.46-.05-6.29-.44-12.53-1.15-18.63h0zm-113.85-35.78c-6.98-7.51-15.16-13.53-24.32-17.89v-97.23c41.9 8.54 79.05 32.27 104.72 66.94 4.31 5.81 8.28 11.94 11.82 18.22l-5.72 1.86-86.49 28.1z"></path><path d="M612.55 374.49c41.17 8.69 77.64 32.17 102.91 66.3a175.13 175.13 0 0 1 11.15 17.05l-4.56 1.48-85.89 27.91c-6.83-7.23-14.76-13.07-23.62-17.38v-95.37m-1.99-2.44v99.08c9.53 4.45 18.01 10.75 25.02 18.41l87.1-28.3 6.88-2.24c-3.74-6.75-7.91-13.22-12.48-19.39-25.41-34.32-63.1-59.03-106.52-67.56h0zM425.61 458.3c24.57-43.64 66.44-74.46 115.18-84.8v97.61c-8.61 4.29-16.32 10.06-22.94 17.17l-92.24-29.99z"></path><path d="M539.79 374.74v95.75c-8.31 4.22-15.78 9.81-22.23 16.64l-90.47-29.41c11.81-20.61 28.1-38.94 47.22-53.12 19.7-14.61 41.72-24.65 65.49-29.86m1.99-2.47c-50.61 10.36-93.33 42.71-117.65 86.6l94.01 30.56c6.67-7.28 14.67-13.32 23.64-17.7v-99.46h0zm76.22 169.21c0 22.98-18.63 41.62-41.61 41.62s-41.62-18.64-41.62-41.62 18.64-41.61 41.62-41.61 41.61 18.63 41.61 41.61z"></path></svg>
title subtitle description link icon icon
Getting Started Guide Read Start with a guide that covers core concepts of Watermill in a few minutes. /learn/getting-started/ <svg width="48" height="48" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M2 3h6a4 4 0 0 1 4 4v14a3 3 0 0 0-3-3H2z" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/><path d="M22 3h-6a4 4 0 0 0-4 4v14a3 3 0 0 1 3-3h7z" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/></svg> <svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" fill="currentColor" class="bi bi-book" viewBox="0 0 16 16"><path d="M1 2.828c.885-.37 2.154-.769 3.388-.893 1.33-.134 2.458.063 3.112.752v9.746c-.935-.53-2.12-.603-3.213-.493-1.18.12-2.37.461-3.287.811zm7.5-.141c.654-.689 1.782-.886 3.112-.752 1.234.124 2.503.523 3.388.893v9.923c-.918-.35-2.107-.692-3.287-.81-1.094-.111-2.278-.039-3.213.492zM8 1.783C7.015.936 5.587.81 4.287.94c-1.514.153-3.042.672-3.994 1.105A.5.5 0 0 0 0 2.5v11a.5.5 0 0 0 .707.455c.882-.4 2.303-.881 3.68-1.02 1.409-.142 2.59.087 3.223.877a.5.5 0 0 0 .78 0c.633-.79 1.814-1.019 3.222-.877 1.378.139 2.8.62 3.681 1.02A.5.5 0 0 0 16 13.5v-11a.5.5 0 0 0-.293-.455c-.952-.433-2.48-.952-3.994-1.105C10.413.809 8.985.936 8 1.783"/></svg>
title subtitle description link icon
Examples Try out Real-world examples and patterns for CQRS, the outbox pattern, SSE, and other use cases. https://github.com/ThreeDotsLabs/watermill/tree/master/_examples <svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" fill="currentColor" class="bi bi-terminal" viewBox="0 0 16 16"><path d="M6 9a.5.5 0 0 1 .5-.5h3a.5.5 0 0 1 0 1h-3A.5.5 0 0 1 6 9M3.854 4.146a.5.5 0 1 0-.708.708L4.793 6.5 3.146 8.146a.5.5 0 1 0 .708.708l2-2a.5.5 0 0 0 0-.708z"/> <path d="M2 1a2 2 0 0 0-2 2v10a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V3a2 2 0 0 0-2-2zm12 1a1 1 0 0 1 1 1v10a1 1 0 0 1-1 1H2a1 1 0 0 1-1-1V3a1 1 0 0 1 1-1z"/></svg>
title description link icon
Go Event-Driven An in-depth online training on Event-Driven Architecture. https://threedots.tech/event-driven/?utm_source=watermill-learn <svg width="76" height="76" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1000 1000" xmlns="https://vecta.io/nano" fill="#4f46e5"><path d="M370.73 308.36l331.77.97c8.39 0 12.26 10.33 6.13 15.81l-156.2 138.78c-8.71 7.75-21.62 7.75-30.34 0L364.92 323.85c-6.45-5.16-2.58-15.49 5.81-15.49zM98.99 455.21c0-10.65 8.71-19.36 19.36-19.36h73.26c10.65 0 19.36 8.71 19.36 19.36h0c0 10.65-8.71 19.36-19.36 19.36h-73.26c-10.65 0-19.36-8.71-19.36-19.36h0zm-4.2 61.32h96.82c10.65 0 19.36 8.71 19.36 19.36s-8.71 19.36-19.36 19.36H94.79c-10.65 0-19.36-8.71-19.36-19.36s8.71-19.36 19.36-19.36zm96.83 119.41H75.11c-10.65 0-19.36-8.71-19.36-19.36h0c0-10.65 8.71-19.36 19.36-19.36h116.51c10.65 0 19.36 8.71 19.36 19.36h0c0 10.65-8.71 19.36-19.36 19.36zM860 617.22c0 50.67-40.99 91.66-91.66 91.66h-538c-10.65 0-19.36-8.71-19.36-19.36v-33.89c0-10.65 8.71-19.36 19.36-19.36h38.08c10.65 0 19.36-8.71 19.36-19.36h0c0-10.65-8.71-19.36-19.36-19.36h-38.08c-10.65 0-19.36-8.71-19.36-19.36v-3.23c0-10.65 8.71-19.36 19.36-19.36h38.08c10.65 0 19.36-8.71 19.36-19.36s-8.71-19.36-19.36-19.36h-38.08c-10.65 0-19.36-8.71-19.36-19.36v-3.23c0-10.65 8.71-19.36 19.36-19.36h38.08c10.65 0 19.36-8.71 19.36-19.36h0c0-10.65-8.71-19.36-19.36-19.36h-38.08c-10.65 0-19.36-8.71-19.36-19.36v-88.11c0-16.78 20.01-25.82 32.6-14.2l271.74 250.44c10.97 10 27.76 10 38.73 0l273.36-250.77c12.26-11.3 32.6-2.58 32.6 14.2v288.85z"></path></svg>
title description link external icon
Discord Community Join our Discord community to get help and discuss Watermill and related topics. https://discord.gg/QV6VFg4YQE true <svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" fill="currentColor" class="bi bi-chat-left-dots" viewBox="0 0 16 16"><path d="M14 1a1 1 0 0 1 1 1v8a1 1 0 0 1-1 1H4.414A2 2 0 0 0 3 11.586l-2 2V2a1 1 0 0 1 1-1zM2 0a2 2 0 0 0-2 2v12.793a.5.5 0 0 0 .854.353l2.853-2.853A1 1 0 0 1 4.414 12H14a2 2 0 0 0 2-2V2a2 2 0 0 0-2-2z"/><path d="M5 6a1 1 0 1 1-2 0 1 1 0 0 1 2 0m4 0a1 1 0 1 1-2 0 1 1 0 0 1 2 0m4 0a1 1 0 1 1-2 0 1 1 0 0 1 2 0"/></svg>
title description link external icon
GitHub Repository Read the source code, contribute, report issues, and stay up to date. https://github.com/ThreeDotsLabs/watermill true <svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" fill="currentColor" class="bi bi-github" viewBox="0 0 16 16"><path d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27s1.36.09 2 .27c1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.01 8.01 0 0 0 16 8c0-4.42-3.58-8-8-8"/></svg>