Releases: withastro/adapters
@astrojs/netlify@4.0.1
@astrojs/netlify@4.0.0
Major Changes
-
#84
ca64544
Thanks @Skn0tt! - # Netlify Adapter v4 simplifies static + SSR deploymentsThis update is a complete overhaul of the Netlify adapter.
It simplifies the user-facing config, and resolves a number of bugs along the way.Here's what changes:
Netlify Context is automatically available via Locals
In v3, you could use
netlify-edge-middleware.ts
to inject data from the Netlify context into your Astro locals.
In v4, this file is no longer needed because the Netlify context is automatically made available viaAstro.locals.netlify.context
.
You can use this context to access information about the user (like geolocation or IP address), your Netlify site (like deploy ID) or the request (like its request ID or the CDN region it's served from).Action Required:
Remove thenetlify-edge-middleware.ts
ornetlify-edge-middleware.js
file.
In your codebase, change all usage of locals injected through that file to useAstro.locals.netlify.context
instead.Image CDN
v4 of this adapter integrates your Astro site with Netlify Image CDN.
This allows transforming images on-the-fly without impacting build times.
It's implemented using an Astro Image Service, and enabled by default.Replacement for On-Demand Builders
On-Demand Builders (ODB) allows SSR-Rendered pages to be cached using a Time to Live (TTL) strategy.
While the Netlify platform continues to support existing pages with ODBs, we now recommend using the much more powerful
Fine-Grained Cache Control going forward.In v3, you could deploy your SSR-Rendered Astro pages to ODBs by enabling the
builders
config option,
and then specifying the TTL on a per-page basis.
In v4, a newcacheOnDemandPages
option replaces this config option. Take a look at the README to learn more about this.Action Required:
Replace thebuilders
config option withcacheOnDemandPages
.// astro.config.mjs export default defineConfig({ // ... adapter: netlify({ - builders: true + cacheOnDemandPages: true }), });
functionPerRoute
was removedIn v3, the
functionPerRoute
option allowed the SSR routes to be split up into multiple Netlify Functions.
This reduced the bundle sizes of each individual function, with the intention of speeding up code parsing, and therefore the time of cold starts.
In practice, this benefit is often nullified by the increase in number of cold starts - more handlers means fewer requests per handler, means more cold starts.In v4, support for this deployment mode was removed.
Action Required:
Remove thefunctionPerRoute
field from your config.binaryMediaTypes
was removedbinaryMediaTypes
was a workaround required for some Astro endpoints, because v3 deployed those as "old" Netlify Functions (now referred to as "Lambda Compatibility Mode").
v4 uses the new Netlify Functions 2.0, which simply doesn't need this workaround anymore - so we're removing it 🎉Action Required:
Remove thebinaryMediaTypes
field from your config.
@astrojs/netlify@3.1.1
@astrojs/netlify@3.1.0
Minor Changes
- #96
f1df277
Thanks @alexanderniebuhr! - Fixes an issue where this package could not be installed alongside Astro 4.0.
@astrojs/cloudflare@8.0.0
Major Changes
-
#94
13ddae8
Thanks @alexanderniebuhr! - Removes deprecated optionbuild.split
. UsefunctionPerRoute
instead. -
#94
13ddae8
Thanks @alexanderniebuhr! - Changes the way that bindings are configured for the local runtime usingastro dev
. This change is developed in cooperation with Cloudflare and aligns Astro more closely to the behavior of Wrangler.⚠️ This is a breaking change for anyone deploying to Cloudflare Pages. You need to update your astro config file to set new the bindings. Follow the updated docs for configuring@astrojs/cloudflare
Patch Changes
-
#94
13ddae8
Thanks @alexanderniebuhr! - Improves compatibility with Astro 4.0. using WASM modules -
#94
13ddae8
Thanks @alexanderniebuhr! - UpdatespeerDependency
ofastro
to be less strict
@astrojs/cloudflare@7.7.1
Patch Changes
-
#69
473e9fa
Thanks @alexanderniebuhr! - Fixes a regression which caused the adapter to falsely generate_routes.json
for on-demand rendered 404 pages, which causes unexpected behavior in Cloudflare's SPA routing. -
#66
5b62509
Thanks @ToxiWoxi! - Fixes a regression which caused the adapter to falsely return an empty 404 response, caused by an upstream change withastro/astro#7754.
@astrojs/cloudflare@7.7.0
Minor Changes
-
#34
4e1060b
Thanks @alexanderniebuhr! - Adds animageService
adapter option to configure which image service is used. Read more in the Cloudflare adapter docs. -
#34
4e1060b
Thanks @alexanderniebuhr! - Adds support for using Cloudflare's Image Resizing service as an external image service in Astro. See Cloudflare's image docs for more information about pricing and features.
@astrojs/netlify@3.0.4
Patch Changes
- #51
acf4c82
Thanks @alexanderniebuhr! - Updates dependencies
@astrojs/cloudflare@7.6.4
Patch Changes
- #51
acf4c82
Thanks @alexanderniebuhr! - Updates dependencies
@astrojs/cloudflare@7.6.3
Patch Changes
- #46
1611ff7
Thanks @alexanderniebuhr! - Fixes a regression introduced in 7.6.2, which breaks building