Before you upgrade0

These notes list no steps.

Upgrading

  • Run nextly migrate right after upgrading (the scaffolded build script already runs nextly migrate && next build).
  • Field groups made with an earlier release: their next save in the Schema Builder, or the next nextly migrate:create, writes a migration that adds the new nullable columns for the data fields they now store. No existing column changes. Until that migration is applied, the field group reads and writes as before.
  • Apps on Vercel with PostgreSQL or MySQL: the adapters now default to a small pool (at most 3 connections, none kept open, idle ones closed after 5 seconds). Install @vercel/functions so the adapters can also hand the pool to attachDatabasePool; without it they log one warning. To keep the old pool, set DB_POOL_MAX=10 and DB_POOL_IDLE_TIMEOUT=30000 (each DB_POOL_* variable, or the adapter's pool option, replaces only its own default). Nothing changes off Vercel.
  • SEO plugin, in production: when Nextly is unavailable (it could not start, or the database is busy, unreachable or timed out), a page's SEO head now fails the render instead of serving the route's own metadata. A revalidation keeps serving the last good render, but a first request with nothing cached answers with an error, and next build fails instead of shipping pages without their SEO head. Make sure the database is reachable from the build. next dev is unchanged.
  • The Single API now refuses a top-level field without a name, with the collection API's existing REQUIRED validation error. Before, such a request crashed.

What's changed20

Released 21 packages at 0.0.2-alpha.78 in lockstep. Every package below ships at this version.

Patch Changes

  • A collection or Single whose definition file holds a group with no name at the top level no longer stops Schema Builder saves.
    More

    Such a group only lays out the fields inside it, and those fields are stored as columns of the entry's own row, which is where entries already read and write them.

    Before, every builder of a table's columns tried to read the group's missing name and crashed with Cannot read properties of undefined (reading 'replace'): the table create, the table change, the runtime table, and the desired schema a migration is diffed from. Once such a collection or Single was in the definition file, every later Builder save failed.

    All of these builders now read the group's fields as columns of the row. A later save's migration adds or changes only what changed. The rest of the save and of the entry reads and writes take those fields the same way:

    • rename detection and the checks run before a save;
    • relationship keys and field-group row moves;
    • defaults, select reads, versions, field-group values, JSON values, dates and relationship values.

    Compatibility: the Single API now refuses a top-level field without a name, with the same answer the collection API already gives: a validation error, code REQUIRED, "Each field requires a name.". This covers creating a Single, saving its schema and applying it from the schema dialog. Before, such a request crashed. A group with no name inside a named group or a repeater stays allowed.

  • The SEO plugin's structured data no longer leaves out dateModified when the field a content type maps for it, such as a correction date, is empty: it then uses the date the page's content last changed, the same date as its sitemap <lastmod>.
    More

    A date in that field still comes first.

    A save that changes only a page's SEO no longer moves its <lastmod> and dateModified when it sends the page's field groups back unchanged: the ids and dates of the rows a field group is kept in, which such a save rewrites, are no longer read as content. Dates kept by an earlier release stay as they are.

  • An entry list no longer moves its cells when a plugin's column arrives after the rows.
    More

    A column provider whose columns rest on a read of its own can now say so with ctx.deciding(until) (experimental), and the entry list keeps its outline a moment longer (250 ms at most, timed from the rows' arrival) while one is still deciding, then draws the rows with the column. The Page Builder's Design column says so while it reads whether the collection has a template, and its cells draw from that answer until their own read lands, so the column no longer changes width either.

  • Field groups now store the data fields placed inside a group with no name.
    More

    A group with no name only lays fields out, and everywhere else its fields are stored where the group sits; in a field group that is the instance's own row. Before, the field group's table had no column for such a field, its value was dropped on write, and a read never returned it. Now the creator, the desired table a save or nextly migrate:create diffs from, the instance write and read (a relationship's expansion at depth included), and reconcile all read the same walk, so each such field is a column of comp_<slug> and its value is stored and read back. A field group placed inside such a group keeps its instances in its own table, as before.

    Compatibility: field groups made with an earlier release have no column for these fields. Their next save in the Schema Builder, or the next nextly migrate:create, writes a migration that adds each missing column, nullable, and changes no existing column. Where the table was made before Builder saves wrote migrations, the save's review now names each column it adds, for you to confirm. Until that migration is applied, such a field group is read and written as before, without those fields. Reconcile keeps the fields and lists each column still to come (awaitingColumns) instead of removing them, and a reconcile of a field group holding a group with no name no longer fails.

  • An app that has not installed @nextlyhq/admin no longer fails its type check on the generated plugin-admin-imports.generated.ts: nextly generate:types leaves the admin import and its registration out of the map there, and writes them back once the admin is installed and the command is run again.
  • The dashboard's Needs your attention card holds the line that names the stopped or overdue releases under a row while that read is on its way, so the rows below no longer move down when the names arrive.
  • On a phone, each card in an entry list is headed by the entry's title again, not by the Page Builder's Design column, and on a wide screen the Design column sits after Title rather than before it, on a collection with a template.
  • The Releases page no longer moves while it loads when releases exist.
    More

    The tabs and the list wait, as one outline, for the read that says whether the needs-attention strip is drawn, so a strip no longer lands above them and pushes them down; the list's search and filter are drawn with the table rather than above its outline; each tab's count keeps room for two digits, so a count past nine no longer widens its tab once it arrives; and a row's readiness line keeps its height while the checks are on their way.

  • The SEO plugin's Search Console report on SEO > Settings > Connections now loads in seconds rather than a minute or more.
    More

    It asks Google for its counts and inspects the most visited pages all at once, where before it made about fourteen requests one after another, and it keeps the report for six hours, reading Google again only after that, so opening the tab again shows it straight away. The tab says when the report was read. Connecting again or disconnecting forgets the kept report. One click now reads "1 click", not "1 clicks".

  • SEO: a page with no stored words of its own, a page built in the site's code or a Page Builder layout, now has a plain-text copy made from the page as it renders: its main content as Markdown, asked for as the public asks for it at its listed address, only where the site names its own address (a production address or baseUrl), and kept for five minutes. llms.txt and the page's head link these copies too.
  • SEO: every brand fact the plugin's options can give (description, email, telephone, contact points, founding date and the parent organization) can now be saved on Settings › Organization, and each saved fact wins over the options' same fact one at a time, so moving a fact from the code to the admin changes nothing else.
    More

    The brand is named by its own name before the site's. The Organization tab shows each value the site's code gives, marked as set in the code. Run nextly migrate for the settings' new field.

  • A page of any type can now carry an FAQ section in its structured data.
    More

    Declare it for one page with faqSection: true in a route's structuredDataHints, or for a whole content type with the new "Questions on its pages are an FAQ section" switch in SEO › Settings › Content types (or structuredData.types.<type>.faqSection in code). The page keeps its own type, and its questions (from the route, or its FAQ field) are described as an FAQPage that is part of the page. Pages that declare nothing are unchanged.

All 20 changes
  • In production, a page's SEO head now fails the render when Nextly is unavailable (it could not be started, the database is busy, unreachable or timed out), instead of serving the route's own metadata.
    More

    A revalidation keeps serving the page's last good render, a first request with nothing cached answers with an error, and next build fails rather than shipping pages without their SEO head. next dev still serves the route's own metadata, and any other failure (a bad answer, a plugin bug) still falls back everywhere. This covers the route helpers and the SEO plugin's seoMetadata and seoStructuredData. Plugins can apply the same rule with failRenderWhenUnavailable and isNextlyUnavailable from @nextlyhq/plugin-sdk (experimental).

  • The SEO plugin's install and uninstall no longer print "The SEO address record could not be brought up to date" while nextly plugins install runs: the hooks wait for the address record catch-up the command's start began, so it no longer runs on after the command has stopped, and the first server start after an install still brings the record up to date.
  • The SEO Pages list shows how many other pages link to each page and how many it links to, and the problem list names a listed page no other page links to ("Page no other page links to"), both worked out from the links each page's check already reads, so the site is not read twice.
    More

    The page links are a new field of the plugin's own list of checks: a site that applies its schema with migrations runs nextly migrate:create and then nextly migrate after upgrading.

  • SEO: llms.txt can carry the site's own words for AI tools under its summary (Settings › Search engines and AI › What AI tools should know).
    More

    /llms-full.txt, its own switch and off by default, serves every page llms.txt lists with the words of its plain-text copy, in one file capped at 5 MB, and llms.txt links it. Core: withNextly rewrites /llms-full.txt to the plugins' root routes, as it does /llms.txt.

  • SEO › Pages now says when the server cannot read the build's prerender manifest, instead of silently listing only the routes with no variable part.
    More

    A banner names the file, the server logs one warning, and the pages the build recorded for routes with a variable part are listed as Unconfirmed. The sitemap, llms.txt and plain-text copies still list confirmed pages only.

  • The SEO plugin judges a title or description by how wide it draws on Google, not by its number of characters: Google shows about 600 px of a title and 920 px of a description, so a title of narrow letters past 60 characters now fits and one of wide capitals short of 60 is named as cut.
    More

    The SEO tab shows a bar under the title and description with the width and the characters, and the search preview, Edit mode, Settings and the problem list measure the same way. hardLengthLimits: true now refuses a save wider than Google shows rather than one past 60 or 160 characters; a site that had it on runs nextly migrate:create and nextly migrate once, since the two fields lose their character cap.

  • The SEO plugin states the site's X account, and gives site code its content dates. socialCard.xAccount (experimental) names the site's X (Twitter) account, as a handle with or without the @ or a profile address such as https://x.com/example, and every page's head then carries <meta name="twitter:site" content="@example">; anything else stops the plugin at start with an error that says so.
    More

    The page-metadata answer gains social.xAccount for it. seoLastChanged (experimental, from @nextlyhq/plugin-seo) gives a site's own sitemap or og:article:modified_time the date the plugin's sitemap uses, when the page's content last changed, instead of updatedAt, which every save moves, an SEO-only one included: seoLastChanged({ collection: "posts", entries: posts }) dates a whole list in one query per hundred entries, and an entry with no date kept falls back to its own updatedAt.

  • On Vercel (where VERCEL is set), the PostgreSQL and MySQL adapters now default to a small database pool: at most 3 connections, none kept open, and idle connections closed after 5 seconds, instead of up to 10 kept for 30 seconds.
    More

    Suspended Vercel function instances keep their open connections, which could exhaust small Postgres plans. Install @vercel/functions in the app and the adapters also hand their pool to its attachDatabasePool; without it they log one warning. To opt out, set DB_POOL_MAX, DB_POOL_MIN or DB_POOL_IDLE_TIMEOUT (or pass pool to the adapter): each replaces only its own default, so DB_POOL_MAX=10 and DB_POOL_IDLE_TIMEOUT=30000 give back a long-running server's pool. Off Vercel the pool is unchanged. Errors for a database out of connections (PostgreSQL 53300, MySQL 1040) or a session closed for idling (PostgreSQL 57P05) are now reported as connection errors.

Packages

  • @nextlyhq/adapter-drizzle
  • @nextlyhq/adapter-mysql
  • @nextlyhq/adapter-postgres
  • @nextlyhq/adapter-sqlite
  • @nextlyhq/admin
  • @nextlyhq/admin-css
  • @nextlyhq/blocks-engine
  • @nextlyhq/blocks-react
  • @nextlyhq/builder
  • @nextlyhq/eslint-plugin
  • @nextlyhq/plugin-form-builder
  • @nextlyhq/plugin-mcp
  • @nextlyhq/plugin-page-builder
  • @nextlyhq/plugin-sdk
  • @nextlyhq/plugin-seo
  • @nextlyhq/storage-s3
  • @nextlyhq/storage-uploadthing
  • @nextlyhq/storage-vercel-blob
  • @nextlyhq/ui
  • create-nextly-app
  • nextly

Earlier releases

Releases before 0.0.2-alpha.66 are listed in Nextly's changelog on GitHub.