Upgrade issues from v6 to v7

[thetutlage]

If you're upgrading from v6 to v7 and run into something unexpected, this is the place to ask.

Before posting, check the upgrade guide: https://docs.adonisjs.com/v6-to-v7

It covers all breaking changes and step-by-step instructions. Most apps should upgrade in under an hour.

When sharing an issue, it helps to include:

• What you were doing (which step in the upgrade)
• The error message or unexpected behavior
• Your Node.js version
• Which packages you've updated so far

I'll be monitoring this thread and updating the upgrade guide if anything comes up that isn't covered.

[hsb-tonmoy]

Bug: @adonisjs/inertia@4.0.0 crashes in dev mode if a previous build left a Vite manifest on disk

What I was doing: Upgraded from v6 to v7 following the upgrade guide. After running node ace build to verify the build works, I ran node ace serve --hmr to start the dev server.

The error:

Error: Cannot read the manifest file when running in dev mode
    at Vite.manifest (…/@adonisjs/vite/build/chunk-ZCIGOANY.js:332:13)
    at Inertia.getVersion (…/@adonisjs/inertia/build/inertia_manager-Ra2dhBKa.js:322:109)

Every Inertia page request returns 500.
Root cause: In @adonisjs/inertia@4.0.0, Inertia.getVersion() does:

getVersion() {
  if (this.#cachedVersion) return this.#cachedVersion;
  if (this.#vite?.hasManifestFile)
    this.#cachedVersion = createHash("md5")
      .update(JSON.stringify(this.#vite.manifest()))
      .digest("hex");
  else this.#cachedVersion = "1";
  return this.#cachedVersion;
}

It checks hasManifestFile (which is set via existsSync() at construction time) but does not check useDevServer before calling this.#vite.manifest(). Meanwhile, @adonisjs/vite@5.1.0's manifest() explicitly throws when the dev server is active:

manifest() {
  if (this.useDevServer) {
    throw new Error("Cannot read the manifest file when running in dev mode");
  }
  // …
}

So if a previous node ace build left the manifest file on disk (e.g. public/assets/.vite/manifest.json), both conditions are true: hasManifestFile === true AND useDevServer === true, causing the crash.

Suggested fix in @adonisjs/inertia: The condition should also check useDevServer:

if (this.#vite?.hasManifestFile && !this.#vite.useDevServer)

Workaround: Delete the Vite manifest before starting dev mode. I added this to my dev script:

"dev": "rm -rf node_modules/.vite* public/assets/.vite && node ace serve --hmr"

Environment:

• Node.js v24.4.1
• @adonisjs/core@7.0.0
• @adonisjs/inertia@4.0.0
• @adonisjs/vite@5.1.0

This is a reproducible bug in @adonisjs/inertia@4.0.0 — it affects any project using Inertia + Vite where the dev server is started after a production build has been run (or any prior build that leaves the manifest on disk). The fix is a one-line guard in getVersion().

[vimalgorasiya]

While exploring the AdonisJS v7 documentation, I found several broken links, incorrect redirects, and 404 pages. Below is a grouped list of affected documentation pages and the expected correct destinations.

---

Doc Link

https://docs.adonisjs.com/guides/database/lucid

The following links are broken or redirect incorrectly:

• Lucid hooks documentation (non-existent page)
  Should redirect to:
  https://lucid.adonisjs.com/docs/model-hooks

• Lucid serialization documentation (non-existent page)
  Should redirect to:
  https://lucid.adonisjs.com/docs/serializing-models

• AdonisJS transformers documentation (redirects to docs home page)
  Should redirect to:
  https://docs.adonisjs.com/guides/frontend/transformers

• Lucid factories documentation (non-existent page)
  Should redirect to:
  https://lucid.adonisjs.com/docs/model-factories

• Database validation rules (non-existent page)
  Should redirect to:
  https://lucid.adonisjs.com/docs/validation

• Query scopes (non-existent page)
  Should redirect to:
  https://lucid.adonisjs.com/docs/model-query-scopes

• Custom column types (incorrect section displayed)
  Should redirect to:
  https://lucid.adonisjs.com/docs/schema-classes#customizing-types-with-schema-rules

• Redis integration (redirects to docs home page)
  Should redirect to:
  https://docs.adonisjs.com/guides/database/redis

---

Doc Link

https://docs.adonisjs.com/guides/frontend/api-client

• Inertia documentation (redirects to docs home page)
  Should redirect to:
  https://docs.adonisjs.com/guides/frontend/inertia

---

Doc Link

https://docs.adonisjs.com/guides/database/redis

• Config file stub (incorrect page)
  Should redirect to:
  https://github.com/adonisjs/redis/blob/10.x/stubs/config/redis.stub

---

Doc Link

https://docs.adonisjs.com/guides/auth/introduction

• AdonisJS Kit (404 page)
  Should redirect to:
  https://plus.adonisjs.com/kit

• Authenticator (404 page)
  Should redirect to:
  https://github.com/adonisjs/auth/blob/10.x/src/authenticator.ts

---

Doc Link

https://docs.adonisjs.com/guides/auth/verifying-user-credentials

• beforeSave hook (404 page)
  Should redirect to:
  https://github.com/adonisjs/auth/blob/10.x/src/mixins/lucid.ts#L88-L95

---

Doc Link

https://docs.adonisjs.com/guides/auth/session-guard

• SessionGuard (404 page)
  Should redirect to:
  https://github.com/adonisjs/auth/blob/10.x/modules/session_guard/guard.ts

• SessionLucidUserProvider (404 page)
  Should redirect to:
  https://github.com/adonisjs/auth/blob/10.x/modules/session_guard/user_providers/lucid.ts

• E_UNAUTHORIZED_ACCESS (404 page)
  Should redirect to:
  https://github.com/adonisjs/auth/blob/10.x/src/errors.ts#L21

---

Doc Link

https://docs.adonisjs.com/guides/auth/access-tokens-guard

• AccessToken (404 page)
  Should redirect to:
  https://github.com/adonisjs/auth/blob/10.x/modules/access_tokens_guard/access_token.ts

• AccessTokensGuard (404 page)
  Should redirect to:
  https://github.com/adonisjs/auth/blob/10.x/modules/access_tokens_guard/guard.ts

---

Note:
For GitHub links, the main branch does not appear to be available. Therefore, 10.x branch links are provided above. Ideally, documentation should reference the main branch if that is the intended default branch.

[Xstoudi]

Not sure if relevant, but:

What you were doing (which step in the upgrade)

Upgrading some packages.

The error message or unexpected behavior

ℹ SyntaxError: The requested module '@poppinss/utils' does not provide an export named 'createError'
ℹ SyntaxError: The requested module '@poppinss/utils' does not provide an export named 'RuntimeException'

Solution is to replace @poppinss/utils imports with @poppinss/utils/exception.

Your Node.js version

v24.14.0

Which packages you've updated so far

Currently updating mine, which depends on some adonis-ish ecosystem.

[AdrianAndersen]

Hello,

I have just completed the migration guide to v7, but I am encountering a strange error when I try to build or dev the application. Has anyone seen something like this before, or know a possible solution?

node ace serve --hmr

thread '<unnamed>' panicked at /Users/runner/work/swc/swc/crates/swc_ecma_transforms_module/src/path.rs:123:13:
base_dir(`..`) must be absolute. Please ensure that `jsc.baseUrl` is specified correctly. This cannot be deduced by SWC itself because SWC is a transpiler and it does not try to resolve project details. In other words, SWC does not know which directory should be used as a base directory. It can be deduced if `.swcrc` is used, but if not, there are many candidates. e.g. the directory containing `package.json`, or the current working directory. Because of that, the caller (typically the developer of the JavaScript package) should specify it. If you see this error, please report an issue to the package author.
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace

Node version: 24.12.0

Package versions:

{
  "dependencies": {
    "@adonisjs/ally": "^6.0.0",
    "@adonisjs/auth": "^10.0.0",
    "@adonisjs/core": "^7.0.1",
    "@adonisjs/cors": "^3.0.0",
    "@adonisjs/session": "^8.0.0",
    "@adonisjs/static": "^2.0.0",
    "@tuyau/core": "^1.1.0",
    "@tuyau/superjson": "^1.0.0",
    "@vinejs/vine": "^4.3.0",
    "argon2": "^0.44.0",
    "reflect-metadata": "^0.2.2",
  },
  "devDependencies": {
    "@adonisjs/assembler": "^8.0.0",
    "@adonisjs/tsconfig": "^2.0.0",
    "@japa/api-client": "^3.2.1",
    "@japa/assert": "^4.2.0",
    "@japa/plugin-adonisjs": "^5.1.0",
    "@japa/runner": "^5.3.0",
    "@poppinss/ts-exec": "^1.4.4",
    "@tuyau/utils": "^0.0.9",
    "hot-hook": "^1.0.0",
    "pino-pretty": "^13.1.3",
    "youch": "^4.1.0"
  }
}

I am running a monorepo setup with NextJS as the frontend and using Tuyau. I have compared my code to what the create-adonisjs cli does, and I cannot seem to find what could be the problem.

Any help would be greatly appreciated!

[tgriesser]

Congrats on v7 release!

One issue I hit was missing adding the #providers/api_provider in order to get the serialize on HttpContext to utilize the new Transformers feature with APIs. I didn't see it mentioned anywhere in https://docs.adonisjs.com/v6-to-v7. It is added by default when scaffolding a new v7 project, but the blog post https://adonisjs.com/blog/v7 says:

The serialize helper (available on HttpContext) wraps the result and returns a proper HTTP response.

Which makes it sound like it's available out of the box. Related issue I saw here: #5060

Figured it out pretty quickly but seemed like maybe it was overlooked in the upgrade guide.

Related to that, it seems that if you're using the default implementation of serialize, the response will be wrapped with data unless you're using serialize.withoutWrapping. Some of the examples on https://docs.adonisjs.com/guides/frontend/api-client make it sound like the resource should be returned directly:

export default class PostsController {
  async show({ params, serialize }: HttpContext) {
    const post = await Post.find(params.id)
    return serialize(PostTransformer.transform(post))
  }
}

const post = await client.api.posts.show({ params: { id: '1' } })
// post.title is string
// post.author.name is string
// Full autocomplete and type safety

vs.

const { data: post } = await client.api.posts.show({ params: { id: '1' } })
// post.title is string
// post.author.name is string
// Full autocomplete and type safety