Overview

Forst can call functions from existing TypeScript and JavaScript modules while your app runs. We call this bridge internally. The Go program starts a JavaScript bridge process and talks to it over a local socket. The bridge process runs @forst/runtime to load your modules and run function calls. Use the js import suffix, enable bridge in ftconfig.json, and install @forst/runtime in your project.

import "./legacy/payment" js

func main() {
  result := payment.create(100.0, "USD")
  ensure result is Ok()
  println(result.id)
}

Start here

Goal	Guide
Import modules and call functions	Import and call JavaScript
Build binaries and configure runtime hosts	Build, deploy, and runtime modes
Security model and threat analysis	Bridge security
Call Forst over HTTP (opposite direction)	Call Forst over HTTP
Share types only	Generate client types

Configuration summary

Enable the bridge in ftconfig.json.

{
  "bridge": {
    "enabled": true,
    "importPolicy": "explicit",
    "runtimeEnabled": true,
    "host": "node",
    "legacyModules": {
      "format": "compiled",
      "precompile": { "outDir": ".forst/js" }
    }
  }
}

Set bridge.host to node, bun, or deno. Use environment variables to override host settings at deploy time.

JavaScript interop hub

Typed client generation and calling Forst from Node.

Bridge interop examples

Runnable code examples for sync, async, generators, and host mode.

Getting started

Data validation

Behavior

Interoperability

Workflow

Overview

Start here

Configuration summary

JavaScript interop hub

Bridge interop examples

​Start here

​Configuration summary

​Related

JavaScript interop hub

Bridge interop examples

Start here

Configuration summary

Related