waku-org · fryorcraken · Sep 29, 2025 · Sep 29, 2025 · Sep 29, 2025 · Sep 29, 2025
diff --git a/.cspell.json b/.cspell.json
@@ -83,7 +83,20 @@
     "IPFS",
     "cheatsheet",
     "hacken",
-    "statusteam"
+    "statusteam",
+    "pubkey",
+    "multiaddresses",
+    "peerstore",
+    "addrs",
+    "cred",
+    "Kadmelia",
+    "storev",
+    "unsubs",
+    "Linea",
+    "upnp",
+    "dnsaddr",
+    "multiaddress",
+    "Kademlia's"
   ],
   "flagWords": [],
   "ignorePaths": [

diff --git a/docs/guides/js-waku/configure-discovery.mdx → .../build/javascript/configure-discovery.mdx b/docs/guides/js-waku/configure-discovery.mdx → .../build/javascript/configure-discovery.mdx
@@ -81,7 +81,7 @@ await Promise.all(promises);
 ```
 
 :::tip
-For local development using a `nwaku` node, use a `ws` address instead of `wss`. Remember that this setup is functional only when your web server is running locally. You can check how to get multi address of your locally run node in [Find node address](/guides/nwaku/find-node-address).
+For local development using a `nwaku` node, use a `ws` address instead of `wss`. Remember that this setup is functional only when your web server is running locally. You can check how to get multi address of your locally run node in [Find node address](/run-node/find-node-address).
 :::
 
 ## Configure DNS discovery

diff --git a/docs/guides/js-waku/debug-waku-dapp.md → docs/build/javascript/debug-waku-dapp.md b/docs/guides/js-waku/debug-waku-dapp.md → docs/build/javascript/debug-waku-dapp.md
@@ -1,9 +1,10 @@
 ---
 title: Debug Your Waku DApp and WebSocket
 hide_table_of_contents: true
+displayed_sidebar: build
 ---
 
-This guide provides detailed steps to enable and use debug logs to troubleshoot your Waku DApp, whether in a NodeJS or browser environment and check your WebSocket connections in [nwaku](/guides/nwaku/run-node).
+This guide provides detailed steps to enable and use debug logs to troubleshoot your Waku DApp, whether in a NodeJS or browser environment and check your WebSocket connections in [nwaku](/run-node/).
 
 ## Enabling debug logs
 
@@ -45,7 +46,7 @@ To view debug logs in your browser's console, modify the local storage and add t
 
 ## Checking WebSocket setup
 
-[Nwaku](/guides/nwaku/run-node) provides native support for WebSocket (`ws`) and WebSocket Secure (`wss`) protocols. These are the only [transports](/learn/concepts/transports) supported for connecting to the Waku Network via browsers.
+[Nwaku](/run-node/) provides native support for WebSocket (`ws`) and WebSocket Secure (`wss`) protocols. These are the only [transports](/learn/concepts/transports) supported for connecting to the Waku Network via browsers.
 
 It's important to note that browsers impose certain limitations on WebSocket usage:
 

diff --git a/docs/build/javascript/faq.md b/docs/build/javascript/faq.md
@@ -0,0 +1,56 @@
+---
+title: JavaScript SDK FAQ
+hide_table_of_contents: true
+sidebar_label: Frequently Asked Questions
+displayed_sidebar: build
+---
+
+import { AccordionItem } from '@site/src/components/mdx'
+
+<AccordionItem title="How do I install the @waku/sdk package in my project?">
+	You can add the JavaScript SDK to your project using NPM, Yarn, or a CDN. Check out the <a href="/build/javascript/#installation">installation guide</a> to get started.
+</AccordionItem>
+
+<AccordionItem title="Why should I use Protocol Buffers for my application's message structure when using Waku?">
+	Protocol Buffers ensure consistent formatting, interoperability, and backward compatibility for your application's messages, with a smaller payload size than JSON. Check out the <a href="/build/javascript/#message-structure">installation guide</a> and <a href="https://protobuf.dev/overview/">Protobuf documentation</a> to learn more.
+</AccordionItem>
+
+<AccordionItem title="What are the steps to retrieve historical messages on Waku?">
+	Check out the <a href="/build/javascript/store-retrieve-messages">Retrieve Messages Using Store Protocol</a> guide to learn how to retrieve and filter historical messages using the <a href="/learn/concepts/protocols#store">Store protocol</a>.
+</AccordionItem>
+
+<AccordionItem title="How can I prevent Store peers from storing my messages?">
+	When <a href="/build/javascript/light-send-receive#choose-a-content-topic">creating your message encoder</a>, you can configure the <strong>ephemeral</strong> option to prevent Store peers from keeping your messages on the Waku Network.
+</AccordionItem>
+
+<AccordionItem title="How can I encrypt, decrypt, and sign messages in my Waku application?">
+	You can encrypt and decrypt your messages using symmetric, ECIES, and noise encryption methods. Check out the <a href="/build/javascript/message-encryption">Encrypt, Decrypt, and Sign Your Messages</a> guide to get started.
+</AccordionItem>
+
+<AccordionItem title="How do I integrate Waku into a React application?">
+	Waku has a specialized SDK designed for building React applications. Check out the <a href="/build/javascript/use-waku-react">Build React DApps Using @waku/react</a> guide for instructions on installation and usage.
+</AccordionItem>
+
+<AccordionItem title="How can I bootstrap and discover peers in the Waku Network for browser nodes?">
+	The JavaScript SDK has a <a href="/build/javascript/configure-discovery#default-bootstrap-method">default bootstrap method</a> that can be configured with <a href="/learn/concepts/static-peers">Static Peers</a> and <a href="/learn/concepts/dns-discovery">DNS Discovery</a>. Check out the <a href="/build/javascript/configure-discovery">Bootstrap Nodes and Discover Peers</a> guide for setting up peer discovery for your node.
+</AccordionItem>
+
+<AccordionItem title="How can I integrate Waku into a NodeJS application?">
+	Though the JavaScript SDK isn't directly usable in NodeJS due to <a href="/build/javascript/run-waku-nodejs">certain limitations</a>, we recommend running <a href="/run-node/run-docker-compose">nwaku in a Docker container</a> and consuming its <a href="https://waku-org.github.io/waku-rest-api/">REST API</a> in a NodeJS application.
+</AccordionItem>
+
+<AccordionItem title="How can I debug my Waku DApp and check WebSocket connections?">
+	Check out the <a href="/build/javascript/debug-waku-dapp">Debug Your Waku DApp and WebSocket</a> guide to discover how to use debug logs to troubleshoot your Waku DApp and resolve connection issues with nwaku WebSockets.
+</AccordionItem>
+
+<AccordionItem title="How can I manage unexpected disconnections of my Filter subscription from Waku?">
+	We recommend regularly pinging peers to check for an active connection and reinitiating the subscription when it disconnects. Check out the <a href="/build/javascript/manage-filter">Manage Your Filter Subscriptions</a> guide for a detailed explanation and step-by-step instructions.
+</AccordionItem>
+
+<AccordionItem title="How can I send images and videos on the Waku Network?">
+	While it's possible to transmit media such as images as bytes on Waku, we recommend uploading your media to a CDN or a file system like <a href="https://ipfs.tech/">IPFS</a> and then sharing the corresponding URL via Waku.
+</AccordionItem>
+
+<AccordionItem title="How can I connect to my own node?">
+	To manually set your own node as a starting point use <a href="/build/javascript/configure-discovery#configure-static-peers">Configure static peers</a>.
+</AccordionItem>
diff --git a/docs/guides/js-waku/index.md → docs/build/javascript/index.md b/docs/guides/js-waku/index.md → docs/build/javascript/index.md
@@ -1,6 +1,7 @@
 ---
 title: JavaScript Waku SDK
 hide_table_of_contents: true
+displayed_sidebar: build
 ---
 
 :::caution
@@ -9,6 +10,14 @@ Currently, the JavaScript Waku SDK (`@waku/sdk`) is **NOT compatible** with Reac
 
 The [JavaScript Waku SDK](https://github.com/waku-org/js-waku) (`@waku/sdk`) provides a TypeScript implementation of the [Waku protocol](/) designed for web browser environments. Developers can seamlessly integrate Waku functionalities into web applications, enabling efficient communication and collaboration among users using the `@waku/sdk` package.
 
+## Video Tutorials
+
+<div class="video-container">
+  <iframe class="yt-video two-items" src="https://www.youtube.com/embed/PYQaXCxUCwA" title="Waku Tutorial 001: Introduction to Waku" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
+
+<iframe class="yt-video two-items" src="https://www.youtube.com/embed/sfmMcrbiX0c" title="Build a game using Waku Protocol" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
+</div>
+
 ## Installation
 
 Install the `@waku/sdk` package using your preferred package manager:
@@ -85,21 +94,21 @@ import "https://cdn.jsdelivr.net/npm/protobufjs@latest/dist/protobuf.min.js";
 
 Have a look at the quick start guide and comprehensive tutorials to learn how to build applications using `@waku/sdk`:
 
-| Guide                                                                                       | Description                                                                                                                                                                 |
-|---------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| [Send and Receive Messages in a Reliable Channel](/guides/js-waku/reliable-channels)        | Learn how to send and receive messages with a convenient SDK that provide various reliable functionalities out-of-the-box.                                                  |
-| [Send and Receive Messages Using Light Push and Filter](/guides/js-waku/light-send-receive) | Learn how to send and receive messages on light nodes using the [Light Push](/learn/concepts/protocols#light-push) and [Filter](/learn/concepts/protocols#filter) protocols |
-| [Retrieve Messages Using Store Protocol](/guides/js-waku/store-retrieve-messages)           | Learn how to retrieve and filter historical messages on light nodes using the [Store protocol](/learn/concepts/protocols#store)                                             |
-| [Encrypt, Decrypt, and Sign Your Messages](/guides/js-waku/message-encryption)              | Learn how to use the [@waku/message-encryption](https://www.npmjs.com/package/@waku/message-encryption) package to encrypt, decrypt, and sign your messages                 |
-| [Build React DApps Using @waku/react](/guides/js-waku/use-waku-react)                       | Learn how to use the [@waku/react](https://www.npmjs.com/package/@waku/react) package seamlessly integrate `@waku/sdk` into a React application                             |
-| [Scaffold DApps Using @waku/create-app](/guides/js-waku/use-waku-create-app)                | Learn how to use the [@waku/create-app](https://www.npmjs.com/package/@waku/create-app) package to bootstrap your next `@waku/sdk` project from various example templates   |
-| [Bootstrap Nodes and Discover Peers](/guides/js-waku/configure-discovery)                   | Learn how to bootstrap your node using [Static Peers](/learn/concepts/static-peers) and discover peers using [DNS Discovery](/learn/concepts/dns-discovery)                 |
-| [Run @waku/sdk in a NodeJS Application](/guides/js-waku/run-waku-nodejs)                    | Learn our suggested approach for using the `@waku/sdk` package within a NodeJS application                                                                                  |
-| [Debug Your Waku DApp and WebSocket](/guides/js-waku/debug-waku-dapp)                       | Learn how to troubleshoot your Waku DApp using debug logs and check [WebSocket](/learn/concepts/transports) connections in [nwaku](/guides/nwaku/run-node)                  |
-| [Manage Your Filter Subscriptions](/guides/js-waku/manage-filter)                           | Learn how to manage [filter subscriptions](/learn/concepts/protocols#filter) and handle node disconnections in your application                                             |
+| Guide                                                                                         | Description                                                                                                                                                                 |
+|-----------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| [Send and Receive Messages in a Reliable Channel](/build/javascript/reliable-channels)        | Learn how to send and receive messages with a convenient SDK that provide various reliable functionalities out-of-the-box.                                                  |
+| [Send and Receive Messages Using Light Push and Filter](/build/javascript/light-send-receive) | Learn how to send and receive messages on light nodes using the [Light Push](/learn/concepts/protocols#light-push) and [Filter](/learn/concepts/protocols#filter) protocols |
+| [Retrieve Messages Using Store Protocol](/build/javascript/store-retrieve-messages)           | Learn how to retrieve and filter historical messages on light nodes using the [Store protocol](/learn/concepts/protocols#store)                                             |
+| [Encrypt, Decrypt, and Sign Your Messages](/build/javascript/message-encryption)              | Learn how to use the [@waku/message-encryption](https://www.npmjs.com/package/@waku/message-encryption) package to encrypt, decrypt, and sign your messages                 |
+| [Build React DApps Using @waku/react](/build/javascript/use-waku-react)                       | Learn how to use the [@waku/react](https://www.npmjs.com/package/@waku/react) package seamlessly integrate `@waku/sdk` into a React application                             |
+| [Scaffold DApps Using @waku/create-app](/build/javascript/use-waku-create-app)                | Learn how to use the [@waku/create-app](https://www.npmjs.com/package/@waku/create-app) package to bootstrap your next `@waku/sdk` project from various example templates   |
+| [Bootstrap Nodes and Discover Peers](/build/javascript/configure-discovery)                   | Learn how to bootstrap your node using [Static Peers](/learn/concepts/static-peers) and discover peers using [DNS Discovery](/learn/concepts/dns-discovery)                 |
+| [Run @waku/sdk in a NodeJS Application](/build/javascript/run-waku-nodejs)                    | Learn our suggested approach for using the `@waku/sdk` package within a NodeJS application                                                                                  |
+| [Debug Your Waku DApp and WebSocket](/build/javascript/debug-waku-dapp)                       | Learn how to troubleshoot your Waku DApp using debug logs and check [WebSocket](/learn/concepts/transports) connections in [nwaku](/run-node/)                              |
+| [Manage Your Filter Subscriptions](/build/javascript/manage-filter)                           | Learn how to manage [filter subscriptions](/learn/concepts/protocols#filter) and handle node disconnections in your application                                             |
 
 :::tip
-Until [node incentivisation](/learn/research#prevention-of-denial-of-service-dos-and-node-incentivisation) is in place, you should [operate extra nodes](/#run-a-waku-node) alongside the ones provided by the Waku Network. When running a node, we recommend using the [DNS Discovery and Static Peers](/guides/js-waku/configure-discovery#configure-dns-discovery-and-static-peers) configuration to connect to both the Waku Network and your node.
+Until [node incentivisation](/learn/research#prevention-of-denial-of-service-dos-and-node-incentivisation) is in place, you should [operate extra nodes](/#run-a-waku-node) alongside the ones provided by the Waku Network. When running a node, we recommend using the [DNS Discovery and Static Peers](/build/javascript/configure-discovery#configure-dns-discovery-and-static-peers) configuration to connect to both the Waku Network and your node.
 :::
 
 ## Get help and report issues

diff --git a/docs/guides/js-waku/light-send-receive.md → docs/build/javascript/light-send-receive.md b/docs/guides/js-waku/light-send-receive.md → docs/build/javascript/light-send-receive.md
@@ -1,9 +1,10 @@
 ---
 title: Send and Receive Messages Using Light Push and Filter
 hide_table_of_contents: true
+displayed_sidebar: build
 ---
 
-This guide provides detailed steps to start using the `@waku/sdk` package by setting up a [Light Node](/learn/glossary#light-node) to send messages using the [Light Push protocol](/learn/concepts/protocols#light-push), and receive messages using the [Filter protocol](/learn/concepts/protocols#filter). Have a look at the [installation guide](/guides/js-waku/#installation) for steps on adding `@waku/sdk` to your project.
+This guide provides detailed steps to start using the `@waku/sdk` package by setting up a [Light Node](/learn/glossary#light-node) to send messages using the [Light Push protocol](/learn/concepts/protocols#light-push), and receive messages using the [Filter protocol](/learn/concepts/protocols#filter). Have a look at the [installation guide](/build/javascript/#installation) for steps on adding `@waku/sdk` to your project.
 
 ## Create a light node
 
@@ -21,7 +22,7 @@ await node.start();
 ```
 
 :::info
-When the `defaultBootstrap` parameter is set to `true`, your node will be bootstrapped using the [default bootstrap method](/guides/js-waku/configure-discovery#default-bootstrap-method). Have a look at the [Bootstrap Nodes and Discover Peers](/guides/js-waku/configure-discovery) guide to learn more methods to bootstrap nodes.
+When the `defaultBootstrap` parameter is set to `true`, your node will be bootstrapped using the [default bootstrap method](/build/javascript/configure-discovery#default-bootstrap-method). Have a look at the [Bootstrap Nodes and Discover Peers](/build/javascript/configure-discovery) guide to learn more methods to bootstrap nodes.
 :::
 
 A node needs to know how to route messages. By default, it will use The Waku Network configuration (`{ clusterId: 1, shards: [0,1,2,3,4,5,6,7] }`). For most applications, it's recommended to use autosharding:
@@ -85,7 +86,7 @@ const encoder = createEncoder({ contentTopic });
 const decoder = createDecoder(contentTopic);
 ```
 
-The `ephemeral` parameter allows you to specify whether messages should **NOT** be stored by [Store peers](/guides/js-waku/store-retrieve-messages):
+The `ephemeral` parameter allows you to specify whether messages should **NOT** be stored by [Store peers](/build/javascript/store-retrieve-messages):
 
 ```js
 const encoder = createEncoder({
@@ -127,7 +128,7 @@ const DataPacket = new protobuf.Type("DataPacket")
 ```
 
 :::info
-Have a look at the [Protobuf installation](/guides/js-waku/#message-structure) guide for adding the `protobufjs` package to your project.
+Have a look at the [Protobuf installation](/build/javascript/#message-structure) guide for adding the `protobufjs` package to your project.
 :::
 
 ## Send messages using light push

diff --git a/docs/guides/js-waku/manage-filter.md → docs/build/javascript/manage-filter.md b/docs/guides/js-waku/manage-filter.md → docs/build/javascript/manage-filter.md
@@ -1,9 +1,10 @@
 ---
 title: Manage Your Filter Subscriptions
 hide_table_of_contents: true
+displayed_sidebar: build
 ---
 
-This guide provides detailed steps to manage [Filter](/learn/concepts/protocols#filter) subscriptions and handle node disconnections in your application. Have a look at the [Send and Receive Messages Using Light Push and Filter](/guides/js-waku/light-send-receive) guide for using the `Light Push` and `Filter` protocols.
+This guide provides detailed steps to manage [Filter](/learn/concepts/protocols#filter) subscriptions and handle node disconnections in your application. Have a look at the [Send and Receive Messages Using Light Push and Filter](/build/javascript/light-send-receive) guide for using the `Light Push` and `Filter` protocols.
 
 ## Overview
 

diff --git a/docs/guides/js-waku/message-encryption.mdx → docs/build/javascript/message-encryption.mdx b/docs/guides/js-waku/message-encryption.mdx → docs/build/javascript/message-encryption.mdx
-Original file line number
+Diff line change
@@ Expand Up / @@ -81,7 +81,7 @@ await Promise.all(promises); @@
     ```
     :::tip
-    For local development using a `nwaku` node, use a `ws` address instead of `wss`. Remember that this setup is functional only when your web server is running locally. You can check how to get multi address of your locally run node in [Find node address](/guides/nwaku/find-node-address).
+    For local development using a `nwaku` node, use a `ws` address instead of `wss`. Remember that this setup is functional only when your web server is running locally. You can check how to get multi address of your locally run node in [Find node address](/run-node/find-node-address).
     :::
     ## Configure DNS discovery
@@ Expand Down @@