Version and Reproduction Link

Oct 13, 2025 by wbrum.org 53 views

Introduction

When working with Nuxt and Supabase, developers often encounter issues with type declarations in server API routes. In this article, we will explore a common problem where type declarations cannot be found in server/api routes, and provide a simple fix to resolve the issue.

Version and Reproduction Link

The issue was encountered using the following versions:

@nuxtjs/supabase: v1.5.0
nuxt: v3.16.0

The reproduction link for this issue is available on GitHub: https://github.com/eth-gre/nuxtjs-supabase-type-declaration-issue

Steps to Reproduce

To reproduce the issue, follow these steps:

Create a new Nuxt project using npm create nuxt reproduction
Install @nuxtjs/supabase using npx nuxi@latest module add supabase
The issue should be present in the project

Expected Behavior

In a typical Nuxt project, type declarations should work properly in server/api routes without any manual configuration adjustments.

Actual Behavior

However, when using import { serverSupabaseClient } from '#supabase/server' in a server/api route, the type declaration is not found. This is in contrast to using the same import statement in a client-side file, such as app.vue, where it works as intended.

Root Cause

The root cause of this issue is that the Supabase paths are not being generated at all in .nuxt/tsconfig.server.ts. This is a critical file that defines the TypeScript configuration for the server-side code.

Incorrect Path in tsconfig.server.ts

Furthermore, the include path in .nuxt/tsconfig.server.ts appears to be incorrect. It should be "../node_modules/@nuxtjs/supabase/dist/runtime/server" instead of the probably incorrect "../node_modules/@nuxtjs/supabase/runtime/server".

Fixing the Issue

Fortunately, the issue can be fixed by copying the paths into the tsconfig.server.ts file. This should resolve the problem and allow type declarations to work properly in server/api routes.

Here is the corrected code:

"paths": {
	"#supabase/server": ["../node_modules/@nuxtjs/supabase/dist/runtime/server/services"],
	"#supabase/server/*": ["../node_modules/@nuxtjs/supabase/dist/runtime/server/services/*"],
	"#supabase": ["../node_modules/@nuxtjs/supabase/dist/runtime"],
	"#supabase/*": ["../node_modules/@nuxtjs/supabase/dist/runtime/*"],
       // Add more paths as needed
}

Conclusion

In conclusion, the issue of type declarations not being found in server/api routes in Nuxt Supabase projects is a common problem that can be resolved by copying the paths into the tsconfig.server.ts file. By following the steps outlined in this article, developers can fix this issue and ensure that type declarations work properly in their server API routes.

Additional Tips

Make sure to update the tsconfig.server.ts file with the correct paths to resolve the issue.
If you are using a version control system, commit the changes to the tsconfig.server.ts file to track the fix.
Consider opening an issue on the Nuxt or Supabase GitHub repositories to report the problem and contribute to the improvement of these popular frameworks.
Q&A: Fixing Type Declarations in Nuxt Supabase Server API Routes ====================================================================

Frequently Asked Questions

In this article, we will address some of the most common questions related to fixing type declarations in Nuxt Supabase server API routes.

Q: What is the root cause of the issue?

A: The root cause of the issue is that the Supabase paths are not being generated at all in .nuxt/tsconfig.server.ts. This is a critical file that defines the TypeScript configuration for the server-side code.

Q: Why is the `include` path in `tsconfig.server.ts` incorrect?

A: The include path in tsconfig.server.ts appears to be incorrect because it should be "../node_modules/@nuxtjs/supabase/dist/runtime/server" instead of the probably incorrect "../node_modules/@nuxtjs/supabase/runtime/server".

Q: How do I fix the issue?

A: To fix the issue, you need to copy the paths into the tsconfig.server.ts file. This should resolve the problem and allow type declarations to work properly in server/api routes.

Q: What are the correct paths to add to `tsconfig.server.ts`?

A: Here are the correct paths to add to tsconfig.server.ts:

"paths": {
	"#supabase/server": ["../node_modules/@nuxtjs/supabase/dist/runtime/server/services"],
	"#supabase/server/*": ["../node_modules/@nuxtjs/supabase/dist/runtime/server/services/*"],
	"#supabase": ["../node_modules/@nuxtjs/supabase/dist/runtime"],
	"#supabase/*": ["../node_modules/@nuxtjs/supabase/dist/runtime/*"],
       // Add more paths as needed
}

Q: Do I need to update the `tsconfig.server.ts` file manually?

A: Yes, you need to update the tsconfig.server.ts file manually by adding the correct paths. However, you can also use a script or a tool to automate this process.

Q: Can I use a version control system to track the fix?

A: Yes, you can use a version control system to track the fix by committing the changes to the tsconfig.server.ts file.

Q: Should I report the issue to the Nuxt or Supabase GitHub repositories?

A: Yes, you should report the issue to the Nuxt or Supabase GitHub repositories to contribute to the improvement of these popular frameworks.

Q: Are there any additional tips to resolve the issue?

A: Yes, here are some additional tips to resolve the issue:

Make sure to update the tsconfig.server.ts file with the correct paths to resolve the issue.
If you are using a version control system, commit the changes to the tsconfig.server.ts file to track the fix.
Consider opening an issue on the Nuxt or Supabase GitHub repositories to report the problem and contribute to the improvement of these popular frameworks.

Conclusion

In conclusion, fixing type declarations in Nuxt Supabase server API routes is a common problem that can be resolved by copying the paths into the tsconfig.server.ts file. By following the steps outlined in this article and the Q&A section, developers can fix this issue and ensure that type declarations work properly in their server API routes.