Changes

This document highlights the most important fixes, improvements, and features, that were introduced in Webiny 5.5.0.

Webiny CLI

Brand New webiny watch Command (#1540 )

The brand new webiny watch command brings local development experience to a whole new level!

How We Currently Do It

• start a watch session on relevant packages using the webiny workspaces run command
• make your code changes
• deploy them using the yarn webiny deploy api --env {your-environment} command
• repeat

This is not ideal for a couple of reasons:

• you’re required to manually execute the webiny deploy command all the time
• the webiny deploy command always builds all of the project application’s packages, which can be really slow
• apart from running the webiny deploy, you also need to separately run the webiny workspaces run command we mentioned before, in order to establish watch session on packages you’re working on

The New Way

From now on, you’ll be able to just run the yarn webiny watch api --env {your-environment} command and start coding! The command will automatically start watching all of the relevant packages (no matter where they’re located in your Webiny project) and also re-deploy only relevant cloud infrastructure resources (e.g. a single Lambda function), as needed.

Webiny CLI - The New watch Command

(click to enlarge)

Logs

And there’s more! By simply appending the --logs argument to the webiny watch command, you also gain the ability to stream all logs from your application code (Lambda functions), directly to your terminal:

Webiny CLI - Streaming Logs To Your Terminal

(click to enlarge)

This basically means no more digging through Amazon CloudWatch logs while developing or debugging your backend application code.

Using Windows and Git Bash?

If on Windows and using Git Bash , please note that you’ll have to update it to at least to version 2.27.0, as this version introduces the support for pseudo consoles (you will be asked whether you want this enabled in the installation process). Otherwise, upon starting the webiny watch command, you might be receiving broken output in your terminal.

Introduced New webiny workspaces tree Command (#1540 )

The new webiny workspaces tree command gives you an overview of all packages that exist within your Webiny project and how they depend on each other.

Webiny CLI - The New webiny workspaces tree Command

(click to enlarge)

For additional information and usage examples, simply type the following command in your terminal of choice:

yarn webiny ws tree --help

Headless CMS

CMS Permissions (#1562 )

This release introduces an upgrade to CMS permissions. It includes changes in permission editor UI and permission data structure. The goal is to improve the process of defining fine-grained permissions and make them easier to grasp.

Now you have to define access to specific content model groups first, and based on that, the list of available content models gets updated. The navigation in the Admin Area is also improved by introducing this configuration flow.

Headless CMS - permission selector UI

(click to enlarge)

Headless CMS - permission selector UI

(click to enlarge)

Rich Text Content Renderer (#1566 )

Filtering by Reference Field Id (#1567 )

We added a filtering option, into our generated GraphQL Schema, to filter CMS entries by a reference field id.

For example, you can find all the articles that are connected to an author, or a list of authors:

{
  listArticles(
    where: {
      author: "author-id"
      # OR for multiple authors
      author_in: ["author-id", "another-author-id"]
    }
  ) {
    data {
      id
    }
  }
}

You can also filter out all the articles that contain an author, or a list of authors:

{
  listArticles(
    where: {
      author_not: "author-id"
      # OR for multiple authors
      author_not_in: ["author-id", "another-author-id"]
    }
  ) {
    data {
      id
    }
  }
}

Page Builder

New Pre-Rendering Related Fixes (#1569 )

Two pre-rendering related issues were fixed in this release:

1. previewing and pre-rendering pages on non-default locales and tenants now works as expected
2. rendering not-found page also now works as expected

Other

Project Organization Changes (#1540 )

This release introduces a couple of changes on a project level. Most of these are required by the newly introduced watch command.

1. .pulumi Folders Moved to Project Root

api/.pulumi
apps/admin/.pulumi
apps/website/.pulumi

Because these files change on every deploy, and that interferes with the new webiny watch command, we’ve been forced to move these folders outside of project application folders. So, all of your locally stored cloud infrastructure state files are now located in your project root, inside the new .pulumi folder:

.pulumi/api/.pulumi
.pulumi/apps/admin/.pulumi
.pulumi/apps/website/.pulumi

2. webiny.root.js Renamed to webiny.project.js

The webiny.root.js file, located in your project root, has been renamed to webiny.project.js.

3. webiny.application.js Files

Every project application now has its own webiny.application.js file. Think of it as a simple manifest file, which contains project application’s ID, name, and description. Optionally, it can also include additional arbitrary properties, if need be.

4. API Packages - Added watch Scripts and Commands

Every package located within the api project application folder received a watch script in its package.json file and a watch command in its webiny.config.ts file.

5. Admin Area / Website - Added watch Scripts

The Admin Area and Website React applications also received a watch script in their respective package.json files. It is a copy of the existing start script.

6. Custom Packages - New build and watch Scripts

Every custom package in your project now uses the new build and watch scripts, located in its package.json file.

The new scripts section should look like the following:

(...)
  "scripts": {
    "build": "yarn webiny run build",
    "watch": "yarn webiny run watch"
  }
(...)

In order for these to work, the @webiny/cli and @webiny/project-utils were added as development dependencies within the devDependencies property. Finally, the webiny.config.ts file was created, which defines the actual build and watch commands.