🐛 [Bug]: CLI cannot find module imported in storyblok.config.ts

[suateneskoc]

Package

storyblok (CLI)

Bug Description

Below error is faced when running storyblok components pull command after initial setup of Storyblok configuration file.

Error log

node:internal/modules/cjs/loader:1365
  const err = new Error(message);
              ^

Error: Cannot find module '@/services/storyblok/storyblok.env'
Require stack:
- /.../storyblok.config.ts
    at Function._resolveFilename (node:internal/modules/cjs/loader:1365:15)
    at Function.resolve (node:internal/modules/helpers:145:19)
    at jitiResolve (/.../node_modules/jiti/dist/jiti.cjs:1:148703)
    at jitiRequire (/.../node_modules/jiti/dist/jiti.cjs:1:150290)
    at import (/.../node_modules/jiti/dist/jiti.cjs:1:158307)
    at /.../storyblok.config.ts:5:24
    at async Function.import (/.../node_modules/jiti/dist/jiti.cjs:1:158301)
    at async resolveConfig (file:///.../node_modules/c12/dist/index.mjs:320:20)
    at async loadConfig (file:///.../node_modules/c12/dist/index.mjs:149:22)
    at async loadConfigLayer (file:///.../node_modules/storyblok/dist/index.mjs:313:22) {
  code: 'MODULE_NOT_FOUND',
  requireStack: [
    '/.../storyblok.config.ts'
  ]
}

Configuration

Simple storyblok.config.ts located at root of repository:

import { defineConfig } from 'storyblok/config';

import {
  STORYBLOK_REGION,
  STORYBLOK_SPACE_ID,
} from '@/services/storyblok/storyblok.env';

export default defineConfig({
  region: STORYBLOK_REGION,
  space: STORYBLOK_SPACE_ID,
});

Details

• Storyblok CLI version: 4.16.2 (latest)
• Alias path configuration: "@/*": ["./src/*"]

Do we have to use explicit values in Storyblok configuration file? I would expect Storyblok CLI to be able to resolve imports.

Steps to Reproduce

Add storyblok.config.ts file with import statements to the root of a repository. Run storyblok components pull. If storyblok CLI is installed a devDependency, run npx storyblok comonents pull instead.

Expected Behavior

Storyblok CLI to be able to resolve imports.

Actual Behavior

CLI throws error.

Code Sample

import { defineConfig } from 'storyblok/config';

import {
  STORYBLOK_REGION,
  STORYBLOK_SPACE_ID,
} from '@/services/storyblok/storyblok.env';

export default defineConfig({
  region: STORYBLOK_REGION,
  space: STORYBLOK_SPACE_ID,
});

Environment

System:
    OS: macOS 26.3
    CPU: (10) arm64 Apple M4
    Memory: 68.52 MB / 24.00 GB
    Shell: 5.9 - /bin/zsh
  Binaries:
    Node: 22.18.0 - /Users/enes.koc/.nvm/versions/node/v22.18.0/bin/node
    npm: 10.9.3 - /Users/enes.koc/.nvm/versions/node/v22.18.0/bin/npm
    bun: 1.3.4 - /Users/enes.koc/.bun/bin/bun
  Browsers:
    Chrome: 146.0.7680.80
    Safari: 26.3
  npmPackages:
    @storyblok/js: ^4.4.3 => 4.4.5 
    @storyblok/react: ^5.4.21 => 5.4.22 
    @storyblok/richtext: ^3.8.2 => 3.8.2 
    next: 16.1.6 => 16.1.6 
    react: 19.2.3 => 19.2.3 
    storyblok: ^4.16.2 => 4.16.2

Error Logs

node:internal/modules/cjs/loader:1365
  const err = new Error(message);
              ^

Error: Cannot find module '@/services/storyblok/storyblok.env'
Require stack:
- /.../storyblok.config.ts
    at Function._resolveFilename (node:internal/modules/cjs/loader:1365:15)
    at Function.resolve (node:internal/modules/helpers:145:19)
    at jitiResolve (/.../node_modules/jiti/dist/jiti.cjs:1:148703)
    at jitiRequire (/.../node_modules/jiti/dist/jiti.cjs:1:150290)
    at import (/.../node_modules/jiti/dist/jiti.cjs:1:158307)
    at /.../storyblok.config.ts:5:24
    at async Function.import (/.../node_modules/jiti/dist/jiti.cjs:1:158301)
    at async resolveConfig (file:///.../node_modules/c12/dist/index.mjs:320:20)
    at async loadConfig (file:///.../node_modules/c12/dist/index.mjs:149:22)
    at async loadConfigLayer (file:///.../node_modules/storyblok/dist/index.mjs:313:22) {
  code: 'MODULE_NOT_FOUND',
  requireStack: [
    '/.../storyblok.config.ts'
  ]
}

Additional Context

No response

[peperoli]

This is what I use: Move the environment variables to a .env file and access them in the config like this:

export default defineConfig({
  region: process.env.STORYBLOK_REGION,
  space: process.env.STORYBLOK_SPACE_ID,
});

Note: It only seems to works if the file is called .env. .env.local, .env.development etc. doesn't work.