TS2307: Cannot find module 'x' or its corresponding type declarations.

TypeScript can’t resolve the import — the package isn’t installed, the path alias isn’t configured, or there are no types.

Exact message you may see or its corresponding type declarations
Seen on: Node.js

Meaning

TS resolves modules using tsconfig (moduleResolution, baseUrl, paths). Path aliases (@/components) need both tsconfig paths and bundler config. Non-code imports (.css, .svg) need declarations.

Common causes

  • Package not installed
  • Path alias missing in tsconfig
  • Importing .css/.svg without a declaration
  • moduleResolution mismatch (node16/bundler)

⚡ Quick fix

  1. npm install the package (and @types/x if needed)
  2. Configure "paths" in tsconfig and the bundler
  3. Add declare module '*.svg' in a .d.ts

Detailed fix by platform

Node.js

  1. javascript
    // global.d.ts
    declare module '*.svg' { const src: string; export default src; }

How to diagnose

  1. Import — Package, alias or asset?
  2. Config — tsconfig paths/moduleResolution

🔧 Still not fixed?

Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:

Where this error sits

Origin: Application & API. Errors that are often confused with or caused by this one (click to open):

Cannot find module './App.vue' or its corresponding type declarations — TypeScript: error TS2307: Cannot find module './App.vue' or its corresponding type declarations. (Vue)Cannot find module '.…ERR_UNKNOWN_FILE_EXTENSION — TypeError [ERR_UNKNOWN_FILE_EXTENSION]: Unknown file extension ".ts" (Node.js)ERR_UNKNOWN_FILE_EXTE…MODULE_NOT_FOUND — Error: Cannot find module 'x' (MODULE_NOT_FOUND) (Node.js)MODULE_NOT_FOUNDTS1005: ';' expected / ',' expected (syntax error) — TypeScript: error TS1005: ';' expected. (TypeScript)TS1005: ';' expected …TS1128: Declaration or statement expected — TypeScript: error TS1128: Declaration or statement expected. (TypeScript)TS1128: Declaration o…TS1192: Module has no default export — TypeScript: error TS1192: Module '"./utils"' has no default export. (TypeScript)TS1192: Module has no…TS2304 — TS2304: Cannot find name 'x'. (Node.js)TS2304TS2305: Module has no exported member — TypeScript: error TS2305: Module '"./utils"' has no exported member 'helper'. (TypeScript)TS2305: Module has no…TS2307

Explore the map of this error Full error map →

🧠 Still stuck? Analyze your error

Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.

💬 What worked for others

No tips yet — did something else fix this for you?

Share what worked for you

Tips are checked by an editor before they appear. Links are removed.