Introducing a new configuration file for your projects


5 minutes read


Costin Sin

Mar 20, 2024

Share on:


Greetings to all! We’re thrilled to share our inaugural major release with you. This significant update brings with it some changes that may affect existing projects. You can find more details about these changes and how to update your projects here .

A notable change in this release is the modification of our YAML configuration format.

The Reason

We’ve been listening to your feedback and it became clear that the previous YAML format could be a bit perplexing. It lacked distinct separation between settings for backend, frontend, and upcoming (hint hint) database deployments. We believe our revamped design will simplify deployment settings for both current and future users.

Don’t worry, we’ll update existing projects semi-automatically. To aid in your transition, we’ve incorporated a tool in our CLI that will assist in migrating your configuration. While we’ve aimed to make the process as smooth as possible, the new format does contain more details than the old one, so the transition might not be flawless. We recommend checking the configuration file after using the tool to ensure everything is in order.

The New Format

To give you a taste of the new format, here’s a simple example that decales a project with a backend written in Go and a frontend written in TypeScript.

The backend contains two classes, located in users.go and cron.go, and the frontend is located in the client directory. The SendEmail method from the cron.go class is set to be deployed as a cron job that runs at 12:00 PM. The TypeScript SDK will be generated out of the deployed Go classes, and will be accessible in the client frontend.

# The name of the project
name: my-project
# The region where the project will be deployed
region: us-east-1
# The version of the YAML configuration. Required since YAML v2
yamlVersion: 2
# The backend settings
  # Where the code is located
  path: server
  # Language options
    name: go
  # The classes that will be deployed
    # Deploys the "exported genezio class" found in `server/users.go`
    - path: users.go
    # Deploys the "exported genezio class" found in `server/cron.go`
    - path: cron.go
        # Sets the `SendEmail` method to be deployed as a cron job that runs at 12:00 PM
        - name: SendEmail
          type: cron
          cronString: 0 12 * * *
# The frontend settings
  # Where the code is located
  path: client
  # The directory that will be deployed. Must contain an `index.html` file.
  publish: dist # resolves to `client/dist`
  # Settings for the SDK
    # A TypeScript SDK will be generated out of the deployed Go classes
    language: ts


We hope you’re as excited about this change as we are. We believe the new YAML format will make it easier for you to deploy your projects. We’re looking forward to hearing your thoughts and feedback on the new format. If you have any questions or need assistance, please don’t hesitate to reach out to us at

Subscribe to our newsletter

Genezio is a serverless platform for building full-stack web and mobile applications in a scalable and cost-efficient way.

Related articles

More from News