Anatomy of a Totem Project

Config File

From a end-users perspective, the primary way you configure Totem is via it’s configuration file.

This configuration file’s purpose is to define services that are built for each configured branch of a repository, then deployed to the defined target.

For more about the config file, go here.

GitHub Actions

Totem apps, by default, are automatically configured to build and deploy when pushed to GitHub, utilizing GitHub Actions. Configuration for GitHub Actions is stored in the .github directory.

For more about the generated GitHub Actions, go here.

CDK

Because Totem is a CDK app, you will configure a cdk.json file, and inherit CDK related files (.cdk.out, cdk.context.json, etc)

File Structure

• Directory.github/ auto-generated

  • …
• Directory.cdk.out/ auto-generated

  • …
• Directorydist/ example artifact directory

  • …
• .totemrc.yaml
• cdk.json
• cdk.context.json auto-generated
• … other project files