Skip to main content

Custom plugin templates

When your users interact with SE2, you want them to have an experience that is tailored to your product. To ensure they get the most out of SE2, you can create custom plugin templates to control what your users see when they create a new plugin. You can also create custom libraries with utilities specific to your application for users to import from, which we'll explore in the next section.

We want to help! Creating custom templates and libraries are an important aspect of SE2, so send us an email and we'll help you make the most out of these abilities.

Setup

To create a custom plugin template, create a fork of the templates git repository.

Once the repo has been forked into your company or personal account, you can begin editing the templates directory to fit your needs.

For now, you are limited to one template per language, but in the future you'll be able to create a set of templates for your users to choose from.

AssemblyScript

Edit templates/assemblyscript/src/lib.ts to change what your users will see when they create a new AssemblyScript plugin. If you'd like to transform the data that the user's run plugin will receive before it is called, edit both templates/assemblyscript/src/custom.ts and templates/assemblyscript/src/lib.ts and ensure that the type signatures match.

Rust

Edit templates/rust/src/lib.rs.tmpl to change what your users will see when they create a new Rust plugin. In the future, you'll be able to transform the data passed to the user's run plugin.

Configuring SE2

To use the custom templates in your SE2 installation, the SE2_TEMPLATES_REPO environment variable must be set on the builder service.

  • For a local deployment, edit docker-compose.yml to add SE2_TEMPLATES_REPO: to the builder with the value set to your fork (e.g. example-co/plugin-templates)
  • For a cloud deployment, edit suborbital/se2-controlplane.yaml, and add the following to the builder container's environment:
- name: SE2_TEMPLATES_REPO
value: "{your fork}"

Then run kubectl apply -f .suborbital/ to apply the change.