This repository contains a few different example modules for FTL. The top-level go and kotlin directories contain language-specific examples, while the online-boutique directory contains a full micro-services demo based on GCP's demo of the same name.

In order to have all the tools you need to build and run the examples, follow one of these steps:

• Install Hermit and related shell_hooks.
• (or) Install and activate the Hermit environment manually: . ./bin/activate-hermit
• (or) Manually install Just, FTL, Flutter, Go, Goreman, Watchexec, etc. (not recommended)

The online-boutique directory is designed to show how to use FTL to build an online boutique backend with a mobile (Flutter) app and React frontend.

To see a list of commands that can be run, run just --list in the root of the project.

just dev

just web

Flutter is better run via an IDE like VSCode or Android Studio.

Add a new item to your cart using the command-line:

curl -i --json '{"userId": "Larry", "item": {"productId": "OLJCESPC7Z", "quantity": 1}}' localhost:8891/cart/add

Response

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Vary: Origin
Date: Wed, 14 Feb 2024 03:00:03 GMT
Content-Length: 2

{}

Checkout the cart:

curl --json '{
  "userCurrency": "AUD",
  "address": {
    "streetAddress": "1600 Amphitheatre Parkway",
    "city": "Mountain View",
    "state": "CA",
    "country": "USA",
    "zipCode": 94043
  },
  "email": "[email protected]",
  "creditCard": {
    "number": "423412341234",
    "cvv": 123,
    "expirationYear": 2029,
    "expirationMonth": 6
  }
}
' localhost:8891/checkout/Larry | jq .

Response

{
  "id": "19031e2c-a4b3-49fe-bbb8-464bc8707559",
  "shippingAddress": {
    "city": "Mountain View",
    "country": "USA",
    "state": "CA",
    "streetAddress": "1600 Amphitheatre Parkway",
    "zipCode": 94043
  },
  "shippingCost": {
    "currencyCode": "AUD",
    "nanos": 387449163,
    "units": 11
  },
  "shippingTrackingId": "LS-44971-224078566"
}

Open up the FTL console. This will let you navigate the logs, traces and structure of the FTL modules running locally. In the timeline, if you click on one of the calls that we just issued you should see a call trace.

Open up your editor, alter the data structures, alter the logic, and see how it is all reflected in FTL automatically.