Getting Started

Soda is available as a web application, a desktop app and CLI.

Use Soda's Web:

Making it even more accessible for developers. No installations or setups required; all you need is a modern web browser.

  1. Visit Soda's official web app.
  2. Navigate through the user-friendly interface to either generate client source code from an existing IDL or create a new IDL.
  3. Choose the desired template, whether it's React Native, Flutter, NextJS, Anchor, or Seahorse, and let Soda work its magic.

Use Soda's CLI

You can install the CLI using either Cargo or NPM.

cargo install soda-cli

CLI usage

Create a new project from an IDL file.

soda-cli create-project <idl_path> <template_path>

If no template path is provided, the project will attempt to use a template.soda file in the current directory. If no IDL path is provided, the CLI will try to open an idl.json file in the current directory.

Create a template file from a template folder.

soda-cli pack-template <template_path> <output_path>

If no output path is provided, the template will be created in the current directory with the name template.soda. If no template path is provided, the CLI will attempt to read from a template folder in the current directory.

Creates a template folder from a template file.

soda-cli unpack-template <template_path> <output_path>

If no output path is provided, the template folder will be created in the current directory with the name template. If no template path is provided, the CLI will try to read from a template.soda file in the current directory.

Use Soda's Desktop

To use the Desktop App, download the latest release from the Soda GitHub Releases page.

(Optional: You can also download the templates.zip file if you want to use templates other than the default, or clone this repository and use templates from the templates folder.)

Provisional Steps: We are still working on adding code signing to our app, so you may encounter a security warning. Until we finish the code signing process, you might need to check how to open the app on your OS.

Note: Soda is actively under development, and everything is subject to change. This code is unaudited; use it at your own risk.

Was this page helpful?