React SDK Introduction

Welcome to the docs page for Golem React SDK. Before you get started, make sure you have read the Introduction to the Task Model to get familiar with the Golem Network and the task model.

The Golem React SDK is for developers who want to build React applications that interact with the Golem Network directly, without having to write any backend code. It is a wrapper around the Golem JavaScript SDK that provides React hooks and components for common tasks such as connecting to Yagna, initializing executors, running tasks, etc. It's important to keep in mind that the React SDK is meant to be used with your user's local yagna installation. If you want to build a web app that interacts with the Golem Network without requiring your users to deal with yagna, you should use the Golem JavaScript SDK instead.

The Golem React SDK provides a set of React hooks and components that make it easy to perform common tasks such as:

• Connecting to Yagna - use the useYagna hook to connect display the connection status and reconnect to Yagna if the connection is lost.
• Running tasks on the network - use the useExecutor hook to initialize and terminate executors and the useTask hook to run tasks on the network.
• Listing and handling invoices - use the useInvoices hook to list invoices and the useHandleInvoice hook to handle invoices.

To help you get started we have created an example application that uses every hook and component provided by the SDK. You can find the source code for the example app on GitHub. Feel free to clone the repository and play around with the code. Follow the instructions in the README to run the app locally.

To see the example app in action, you can also visit the live demo.

The source code for the SDK along with an example app is available on GitHub and we welcome contributions.

If you encounter any issues with the SDK please report them on GitHub or Discord.