Encore clientgen: Internal compiler error [E0001] nil pointer dereference on api definition

TL;DR

Its fixed in encore v1.53.7, so run encore version update and regenerate. A minimal repro showed it only happens when you use an inline type in an api definition, that inline type references a named type, AND the service folder name doesnt match the service name.

Steps

1. Generating a TypeScript client for my Encore API crashed the compiler with Internal compiler error [E0001]: An unhandled panic occurred in the Encore compiler: runtime error: invalid memory address or nil pointer dereference. A minimal repro showed it only happens when you use an inline type in an api definition, that inline type references a named type, AND the service folder name doesnt match the service name. The maintainer confirmed the fix version in January 2026.
2. What actually fixes it (verified in the thread):
3. This was a compiler bug in Encore's client generation, triggered by that specific combination of an inline type referencing a named type with a mismatched service/folder name. Its fixed in encore v1.53.7, so run encore version update and regenerate. The workaround if youre stuck on an older version is to not use the inline type: define the full request type as a named type before the api definition, which one reporter confirmed avoids the panic.

Expected: The maintainer confirmed the fix version in January 2026.

When to use

You are seeing this: The situation: Generating a TypeScript client for my Encore API crashed the compiler with Internal compiler error [E0001]: An unhandled panic occurred in the Encore compiler: runtime error: invalid memory address or nil pointer dereference. Use this skill when you run into "Encore clientgen: Internal compiler error [E0001] nil pointer dereference on api definition".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

Versions mentioned in the source: encore v1.53.7. If you are on something much newer or older, the details may have shifted.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

Someone asked: Generating a TypeScript client for my Encore API crashed the compiler with Internal compiler error [E0001]: An unhandled panic occurred in the Encore compiler: runtime error: invalid memory address or nil pointer dereference. A minimal repro showed it only happens when you use an inline type in an api definition, that inline type references a named type, AND the service folder name doesnt match the service name. The maintainer confirmed the fix version in January 2026. The verified answer: This was a compiler bug in Encore's client generation, triggered by that specific combination of an inline type referencing a named type with a mismatched service/folder name. Its fixed in encore v1.53.7, so run encore version update and regenerate. The workaround if youre stuck on an older version is to not use the inline type: define the full request type as a named type before the api definition, which one reporter confirmed avoids the panic. Full thread: https://vectle.com/threads/thr_wb9hCXzYQEmd1NTmNQes8g