Get started with Turbine

Turbine is a data application framework for building server-side applications that are event-driven, respond to data in real-time, and scale using cloud-native best practices.

This guide will bring you through the steps to initialize, develop, deploy, and release using our application framework within a fraction of the time similar projects typically take.

note

The Meroxa Platform and Turbine Application Framework are currently in beta. For an overview of the beta, check out the beta overview.

Setup

1. Sign up for a Meroxa account here.

2. Install the latest Meroxa Command Line Interface (CLI). Refer to our installation guide for all available install and update methods.

3. Authenticate and log in to your Meroxa account.

   $ meroxa login
   
   You will now be taken to your browser for authentication or open the URL below in a browser.
   https://auth.meroxa.io/authorize(redacted)

4. Ensure Git is installed and set up locally on your machine. You can check by running git --version. If not installed, refer to the following installation and set up guides:

   • Installing Git
   • First-Time Git Setup

Initialize your data application

Once you have completed the setup steps, you are ready to initialize your data application.

Upon initialization, Turbine automatically scaffolds a codebase in an empty Git repository. Because the application framework uses Git to manage deployments and releases, you must track your codebase and commit before deploying.

JavaScript

• Use the meroxa app init command and provide a name, language, and local path for your data application.

  # You can use the alias `go` in place of `golang`.
  $ meroxa app init liveapp --lang golang --path /apps
  Initializing application "liveapp" in "/path/to/apps"...
  Initializing the application's go module...
  Downloading dependencies...
  Application successfully initialized!
  You can start interacting with Meroxa in your app located at "/path/to/apps/liveapp"

• Note: To default the local path to your current directory, omit the --path argument.

Go

• Use the meroxa app init command and provide a name, language, and local path for your data application.

  # You can use the alias `py` in place of `python`.
  $ meroxa app init liveapp --lang python --path ~/apps
  Initializing application "liveapp" in "/path/to/apps"...
  
  Application successfully initialized!
  You can start interacting with Meroxa in your app located at "/path/to/apps/liveapp"

• Note: To default the local path to your current directory, omit the --path argument.

Python

• Use the meroxa app init command and provide a name, language, and local path for your data application.

  # You can use the alias `js` in place of `javascript`.
  $ meroxa app init liveapp --lang javascript --path ~/apps
  Initializing application "liveapp" in "/path/to/apps"...
  
  Application successfully initialized!
  You can start interacting with Meroxa in your app located at "/path/to/apps/liveapp"

• Note: To default the local path to your current directory, omit the --path argument.

What's Next?

Once you have initialized your data application, you're ready to start developing!

Next up: Developing your data application