Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
82 changes: 82 additions & 0 deletions docs/release-notes/6.3.0/changelog.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,82 @@
---
id: x0qe720i
title: Webiny 6.3.0 Changelog
description: See what's new in Webiny version 6.3.0
---

import { GithubRelease } from "@/components/GithubRelease";
import { Alert } from "@/components/Alert";

<GithubRelease version={"6.3.0"} />

## Development

### TypeScript 6.0.2 with Bundler Module Resolution ([#5043](https://github.com/webiny/webiny-js/pull/5043))

Webiny now uses TypeScript 6.0.2 with module resolution set to `bundler`. This aligns with modern tooling expectations and improves compatibility with bundlers like esbuild and Vite.

### Install Version Flag for Upgrade Command ([#5115](https://github.com/webiny/webiny-js/pull/5115))

You can now specify a custom package version when running the upgrade command:

```typescript
// Example CLI usage
webiny upgrade --install-version=6.3.0-unstable.abc
```

This is primarily useful for testing unstable releases. If you're on version `6.2.0` and want to test `6.3.0-unstable.abc` before the stable release, you can run the upgrade process with this flag to install the unstable version while still executing the `6.3.0` upgrade steps.

### Made Encryption Passphrase Optional ([#5112](https://github.com/webiny/webiny-js/pull/5112))

The encryption service now works without a passphrase configured — `encrypt` and `decrypt` simply pass values through unchanged. Previously, omitting the `<Infra.Encryption passphrase="..." />` configuration would throw an error at runtime.

This allows teams to adopt encryption gradually without requiring every environment to have a passphrase configured upfront.

## Webiny SDK

### Introducing the `Ai` Service ([#5096](https://github.com/webiny/webiny-js/pull/5096))

A first-class `Ai` service is now available in the Webiny API framework, providing a single abstraction for working with language models across multiple providers. The service wraps the [Vercel AI SDK](https://sdk.vercel.ai/) and supports both Anthropic and OpenAI out of the box.

```typescript
import { Ai, Logger, Route } from "webiny/api";

class MyApiRouteImpl implements Route.Interface {
constructor(
private logger: Logger.Interface,
private aiService: Ai.Interface
) {}

async execute(request: Route.Request, reply: Route.Reply) {
const { text } = await this.aiService.generateText({
model: "anthropic/claude-sonnet-4-5",
prompt: "Is this working?!"
});

return reply.send({ message: text });
}
}

export default Route.createImplementation({
implementation: MyApiRouteImpl,
dependencies: [Logger, Ai]
});
```

Configure providers via environment variables:
- `WEBINY_API_ANTHROPIC_API_KEY` for Anthropic models
- `WEBINY_API_OPENAI_API_KEY` for OpenAI models

Switching providers is a one-line change to the model string — no other code changes needed.

## Admin

### Renamed "API Playground" to "GraphQL Playground" ([#5103](https://github.com/webiny/webiny-js/pull/5103))

The navigation label for the API playground has been renamed from "API Playground" to "GraphQL Playground" for clarity.

## Infrastructure

### Automatic Cleanup of Old Pulumi Plugin Versions ([#5101](https://github.com/webiny/webiny-js/pull/5101))

Previously, when new Pulumi plugin versions were downloaded, old versions were left in place. Over time, this could result in several gigabytes of unused files in the `.webiny/pulumi-cli` folder. Old plugin versions are now automatically cleaned up when new ones are installed.
43 changes: 43 additions & 0 deletions docs/release-notes/6.3.0/upgrade-guide.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
---
id: zq6tf829
title: Upgrade from 6.2.x to 6.3.0
description: Learn how to upgrade Webiny from 6.2.x to 6.3.0.
---

import { Alert } from "@/components/Alert";
import { AdditionalNotes } from "@/components/upgrade/AdditionalNotes";

<Alert type="success" title="What you'll learn">

- how to upgrade Webiny from 6.2.x to 6.3.0

</Alert>

<Alert type="info">

Make sure to check out the [6.3.0 changelog](./changelog) to get familiar with the changes introduced in this release.

</Alert>

## Step-by-Step Guide

### 1. Upgrade Webiny Packages

Upgrade all Webiny NPM packages by running the following command:

```bash
yarn up "@webiny/*@6.3.0"
```

Once the upgrade has finished, running the `yarn webiny --version` command in your terminal should return **6.3.0**.

### 2. Deploy Your Project

Proceed by redeploying your Webiny project:

```bash
# Execute in your project root.
yarn webiny deploy --env {environment}
```

<AdditionalNotes />