Skip to main content

Getting started

Hereby is a step by step guide on running your first project. The setup is independent of the OS you are running it on.

info

You can also refer to tutorial on Getting Started with Godspeed.

3.1.1 Glossary​

gs_service: The framework code version. During this setup, you will be asked to select the version of gs_service.
Remote containers/Dev containers: Refer VSCode Remote containers for more information.

3.1.2 Pre-requisites​

Please ensure you have the following in your machine

  • NVM, with Node LTS installed (Currently 16+)
  • Visual Studio Code LTS, with the following plugins installed:
    1. Remote Containers
    2. Run on Save Refer Run On Save
    3. Godspeed Extension Pack
  • Docker-desktop should be up and running.

    On Linux systems, please ensure that docker compose plugin is installed. You can verify it by executing docker compose version command. Refer Install Compose plugin for more information.

  • Git

Hardware recommendations
RAM: 8GB
Hard Disk: SSD

tip
  • Depending your setup, you may need to run the above command using administrator privileges
  • On Windows machines, sometimes Docker-desktop doesn't start. Make sure you have WSL installed with Ubuntu 18.04, for Docker to work fine.

3.1.3 Steps to get started​

Step1: Install the Godspeed CLI​

npm install -g @mindgrep/godspeed

Step 2: Setting up a project on your local machine​

note
  • If you are creating a new project then follow section 2.1
    OR
  • If you are setting up a project from any existing git repository then follow section 2.2
2.1 Create a new project​
godspeed create my_test_project

During the setup, you will be asked which datastores you need. Also whether you need Kafka. Say yes or no, depending on your requirements.

By default, latest version is selected for gs_service. You should select either latest or any highest semantic version available in the list.

2.2 Setting up a project from an existing GIT repository​

Clone the git repository on your local machine. 

cd <your git repo>
godspeed update

During the setup, you will be asked which datastores you need. Also whether you need Kafka. Say yes or no, depending on your requirements.

By default, latest version is selected for gs_service. You should select either latest or any highest semantic version available in the list.

Step3: cd to your project​

cd <your project directory>

Step4: Start Visual Studio from the project directory​

code .

Step 5: Open in Dev container​

  • Again click on the dev container tray icon. If this is your first time, click on Open folder in Dev Container . Else for every other time, click on Re-open in Dev Container

Step 6: Building the project​

  godspeed build

Step 7: Start the service for local development in watch mode​

  godspeed dev
tip

With the dev container running, we have auto watch and auto build enabled when you make changes to your project files. You don't need to run build manually everytime you make changes.

3.1.4 Time to start the development​

If you have successfully reached here, then it is time to start the development of your project!