Playground

The Beam Playground is a web application to run Beam code snippets in a modern browser. This directory holds code to build, test, and deploy the frontend and backend services.

Development Requirements

The following requirements are needed for development, testing, and deploying.

• go 1.18+
• flutter
• Go protobuf dependencies (See Go gRPC Quickstart)
• Dart protobuf dependencies (See Dart gRPC Quickstart)
• buf
• Docker
• Docker Compose
• gcloud CLI
• gcloud Beta Commands
• Cloud Datastore Emulator

Available Gradle Tasks

Perform overall pre-commit checks

cd beam
./gradlew playgroundPrecommit

To see available gradle tasks for playground:

cd beam
./gradlew playground:tasks

Re-generate protobuf

cd beam
./gradlew playground:generateProto

Run local environment using docker compose

cd beam
./gradlew playground:backend:containers:router:dockerComposeLocalUp

Stop containers and removes containers created by dockerComposeLocalUp

cd beam
./gradlew playground:backend:containers:router:dockerComposeLocalDown

Deployment

See terraform for details on how to build and deploy the application and its dependent infrastructure.